Autenticação e chaves

Uma chave, uma empresa, um ambiente

Envie Authorization: Bearer AQUI_VAI_A_CHAVE em cada requisição sobre HTTPS. Não há uma etapa de login da integração. A sessão do painel serve para mostrar o contexto nesta documentação; a API usa sua credencial técnica.

Permissões explícitas

Escolha somente os escopos usados pela integração. Exemplos: identity:read, customers:read, products:read, services:read, nfe:read e nfse:read. Criar rascunhos, transmitir ou cancelar exige os escopos específicos apresentados em cada endpoint.

Validade e rotação

As chaves têm validade de 1 a 90 dias. A rotação entrega um segredo novo e revoga imediatamente o anterior; não amplia permissões nem troca o ambiente. Revogação também é imediata.

Onde guardar o segredo

Mantenha a chave no backend da sua integração. Não a coloque no JavaScript público, aplicativo móvel, URL ou repositório. O NF3 armazena somente seu hash; uma chave já entregue não pode ser recuperada.