Autenticação
O uso programático da CNPJAPI é autenticado por uma API key enviada no cabeçalho Authorization, no formato Bearer:
Authorization: Bearer cnpj_sua_chave
A chave identifica a sua conta, aplica os limites do seu plano e permite o faturamento por uso.
Como gerar a sua API key
- Crie sua conta em https://app.cnpjapi.com.br (há um plano gratuito para começar).
- No portal, gere a sua API key.
- Envie-a no cabeçalho
Authorizationde cada requisição (veja Consultar um CNPJ).
Trate a API key como um segredo: mantenha-a no servidor (variáveis de ambiente ou cofre de segredos), nunca em código público, repositórios ou aplicativos de front-end.
Consulta web aberta vs. uso programático
A consulta pontual pela web (a busca em https://cnpjapi.com.br) é aberta e sem cadastro - serve para verificar um CNPJ na hora, pelo navegador.
A API key é para o uso programático: é ela que identifica a sua conta, aplica os limites do plano e habilita a integração em sistemas, ERPs, CRMs e fluxos de cadastro.
Erros de autenticação
| Status | Significado |
|---|---|
401 |
API key ausente ou inválida |
403 |
Sem permissão para o recurso no seu plano |
Veja todos os códigos em Erros.