Reemitir token do cliente
POST/v1/access-requests/{cnpj}/reissue
Gera um company_token novo para um cliente que já aprovou o acesso, quando a sua software house perdeu o token anterior ou suspeita que ele vazou. O cliente não precisa aprovar de novo.
Autenticação: Authorization: Bearer <access_token>.
Como funciona
- Você chama esta rota.
- O
company_tokenatual para de valer na hora. - A próxima consulta a
GET /v1/access-requests/{cnpj}devolveAPPROVEDcom ocompany_tokennovo, uma única vez.
Requisição
| Parâmetro de caminho | Descrição |
|---|---|
cnpj | CNPJ do cliente (numérico ou alfanumérico), de preferência sem máscara. |
Sem corpo.
curl -X POST "$BASE_URL/v1/access-requests/12345678000195/reissue" \
-H "Authorization: Bearer $ACCESS_TOKEN"
curl "$BASE_URL/v1/access-requests/12345678000195" \
-H "Authorization: Bearer $ACCESS_TOKEN"
Resposta 202
{
"message": "Pedido recebido",
"result": true,
"data": { "status": "RECEIVED" },
"error": null
}
A resposta é sempre a mesma. Se o acesso não está APPROVED (pendente, recusado, revogado, inexistente ou CNPJ inválido), nada acontece.
aviso
Depois de reemitir, todas as partes do seu sistema que usavam o token antigo passam a receber 401. Atualize o token guardado assim que receber o novo.
Erros
| Código | Quando |
|---|---|
401 | Token de acesso ausente, vencido ou inválido. |
429 | Limite por minuto excedido. |