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

  1. Crie sua conta em https://app.cnpjapi.com.br (há um plano gratuito para começar).
  2. No portal, gere a sua API key.
  3. Envie-a no cabeçalho Authorization de 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.