Autenticação e cota

Toda rota de dados exige o header X-Api-Key. A chave é gratuita e tem 1.000 chamadas por dia.

curl https://api.fonteza.com.br/v1/empresas/12345678000190 \
  -H "X-Api-Key: $FONTEZA_KEY"

Sem chave, ou com chave inválida ou revogada: 401 {"detail": "API key inválida"}. Públicas, sem chave e sem cota: /v1/meta e /healthz.

Chaves

• Crie no painel, em Chaves de API. O valor começa com fk_ e aparece uma única vez.
• Para testar sem chave, use o Console da API do painel: ele executa buscas com a chave do painel, que tem cota diária própria. Veja Montar uma busca.
• Uma chave por integração ou ambiente: você revoga uma sem derrubar as outras e vê o uso de cada uma.
• A revogação vale na requisição seguinte.
• A mesma chave autentica o MCP, enviada como Authorization: Bearer.

O que conta na cota

Cota esgotada: 429 {"detail": "cota diária excedida"}, sem Retry-After. A contagem recomeça na virada do dia do servidor. Não repita em laço: cada tentativa recusada também conta. O painel mostra o uso de hoje e dos últimos 14 dias por chave.

Para gastar menos: valide parâmetros antes de chamar, consulte /v1/meta (gratuito) antes de buscar em um conjunto indisponível e refine filtros em vez de paginar fundo.

Segurança

• Guarde a chave em variável de ambiente ou gerenciador de segredos; nunca em código versionado, front-end, prompts ou logs.
• Se vazar, revogue no painel e crie outra.