- Começando
- Autenticação
Começando
Autenticação
Como gerar e usar a API Key do emissor.
Todas as rotas usam a API Key da sua empresa, no header x-api-key:
curl -X POST https://api.treeunfe.com.br/api/v1/nfe \
-H "x-api-key: SUA_API_KEY" ...
Como gerar a API Key
No emissor da Treeunfe, abra Integrações na barra lateral, clique em Nova e escolha Api-Key.
Ao gerar a chave, você define:
| Opção | O que define |
|---|---|
| Ambiente | HOMOLOGACAO ou PRODUCAO. A chave só emite no ambiente escolhido. |
| Escopos | nfe:emit (emitir e registrar eventos) e nfe:read (consultar). |
| Validade | Por quanto tempo a chave vale, por exemplo 3 meses. |
A chave só acessa os dados da sua empresa.
Integre e teste com uma chave de homologação. Gere a de produção só quando for para o ar.
Guarde a chave no seu backend. Não a coloque em apps, no navegador ou em repositórios de código.
Se a empresa estiver inativa, as requisições recebem 403 Organization is inactive.