Area de desenvolvimento
Documentacao tecnica da BaseCNPJ voltada a desenvolvedores que desejam integrar buscas de empresas, consultas por CNPJ e autocomplete em sistemas proprios.
Documentacao da API
A API exposta segue o padrao JSON sobre HTTPS, com rotas versionadas sob /api/v1/
e autenticacao por token nas operacoes sensiveis.
A referencia completa descreve parametros de busca, paginacao, exemplos em curl
e os codigos de erro mais comuns quando o token esta ausente, invalido ou quando nao ha resultados.
Ambiente e caminhos
Os arquivos desta area ficam em /public_html/dev/ no servidor. Em producao, o dominio canonico e
basecnpj.app; evite duplicar integracoes entre variacoes com e sem www sem redirecionamento,
para nao dividir sinais de SEO nem estatisticas.
Boa pratica para integradores
- Armazene o token apenas no servidor; nunca exponha em front-end publico ou repositorios.
- Use paginacao nas buscas amplas para reduzir carga e tempo de resposta.
- Trate respostas
401,403e503com mensagens claras para o usuario final.