# Autenticação

> Chaves 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`:

```http
Authorization: Bearer sk_cnpj_XXXXXXXXXXXX_YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY
```

## Tipos 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](https://apizen.com.br/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`:

```json
{"error": "send your key: Authorization: Bearer <key>"}
```

ou `{"error": "invalid or revoked key"}` para uma chave revogada, desligada ou pausada.
