Autenticação e primeira chamada

Antes de chamar a API Reinf, crie a Chave de API no portal, troque essa chave por um access token e use o bearer token no playground ou no seu cliente HTTP.

1. Crie a Chave de API no portal

Acesse Administração > Controle de Acesso > Integrações API (tela "Chaves de API"), crie a chave e copie o valor exibido. A Chave de API é mostrada uma única vez, na criação; guarde-a com segurança. Cada chave tem um prefixo visível na listagem, usado só para identificação.

Para substituir uma chave, revogue a atual e crie outra. Ao revogar, novos acessos são bloqueados, mas os tokens já emitidos continuam válidos até expirar.

Chave de API: SUA_CHAVE_DE_API

2. Obtenha o access token

Envie a Chave de API no header Authorization: Bearer para POST /api/integracao/token. A requisição não tem corpo nem parâmetros de formulário: a única credencial é a Chave de API no header.

POST /api/integracao/token
Authorization: Bearer SUA_CHAVE_DE_API

Resposta esperada (payload mínimo do token):

{
  "access_token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 900
}

O access_token expira normalmente em cerca de 15 minutos (expires_in em segundos). Faça uma nova troca ao expirar.

3. Use o token e valide o contexto

Depois de obter o token, envie Authorization: Bearer e comece por GET /v1/integracao/contexto.

Authorization: Bearer <access_token>

GET /v1/integracao/contexto

Ambientes

Os fluxos fiscais mantêm o ambiente explícito para cadastros, transmissão, webhooks e relatórios. Separe Produção e Produção restrita.

TipoAmbienteCodigo: 1 ou 2

Continue em Cobertura da API Reinf ou volte para a visão geral.