Pular para o conteúdo principal

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​

  1. Você chama esta rota.
  2. O company_token atual para de valer na hora.
  3. A próxima consulta a GET /v1/access-requests/{cnpj} devolve APPROVED com o company_token novo, uma única vez.

Requisição​

Parâmetro de caminhoDescrição
cnpjCNPJ 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ódigoQuando
401Token de acesso ausente, vencido ou inválido.
429Limite por minuto excedido.