Autenticação
Ver em .mdChaves secretas para CNPJ e CEP, chave pública para o Maps.
Toda chamada às APIs de CNPJ e CEP leva a chave no cabeçalho Authorization:
Authorization: Bearer sk_cnpj_XXXXXXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYTipos de chave
| Chave | Formato | Onde usar |
|---|---|---|
| Secreta (CNPJ, CEP) | sk_cnpj_…, sk_ceps_… |
só no servidor: variável de ambiente, cofre de segredos. Nunca no navegador, num app ou num repositório. |
| Pública (Maps) | pk_maps_… |
no HTML do seu site. Só funciona nos domínios cadastrados nela. |
- Cada API tem as suas chaves: uma chave de CNPJ não vale na API de CEP, e vice-versa.
- A chave secreta inteira aparece uma vez só, quando é criada no painel; guardamos só o hash. Perdeu, revogue e crie outra.
- Chaves antigas começam com
kn_e continuam valendo. - Uma chave nova começa a valer em até um minuto.
- Mande a chave sempre no cabeçalho, nunca na URL: URLs ficam em logs.
Domínios da chave do Maps
Ao criar uma chave do Maps, informe os domínios do site, separados por vírgula: exemplo.com.br, *.exemplo.com.br (todos os subdomínios) e localhost para testar.
Sem chave ou com chave inválida
A resposta é 401:
{"error": "send your key: Authorization: Bearer <key>"}ou {"error": "invalid or revoked key"} para uma chave revogada, desligada ou pausada.