Autenticação simples para integrar com segurança.

Bearer token

Todas as rotas protegidas exigem token de API. Envie o token no header Authorization: Bearer SEU_TOKEN.

curl --request GET \
  --url https://fiscal.contora.com.br/api/v1/me \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer SEU_TOKEN'

Primeira verificação

Depois de obter o token, use a rota /me para validar se a autenticação está funcionando antes de criar empresas, certificados ou documentos.

{
  "ok": true,
  "token": {
    "id": "9fe88db2-2b15-4616-9804-28c3fcb4f1df",
    "name": "ERP Produção",
    "abilities": ["*"],
    "last_used_at": "2026-07-01T17:28:00-03:00"
  }
}

Obter tokens no console

Para quem esta comecando agora, o fluxo mais simples e criar uma conta administrativa em cadastro, entrar no login e gerar tokens por ambiente no console da plataforma. O ambiente é uma restrição efetiva: uma chave de homologação não acessa empresas ou documentos de produção, e vice-versa. Exceção: uma empresa de produção pode liberar espelhos de homologação com a mesma chave habilitando allows_homologation — veja Empresas.

1. Criar a conta e validar o e-mail.
2. Acessar o painel em /console.
3. Gerar uma chave em Chaves de API, começando por homologação.
4. Cadastrar a empresa emissora no mesmo ambiente da chave.
5. Subir o certificado A1 da empresa.
6. Testar o token em /me antes da primeira emissão.