Autenticação
Como a chave vai na chamada, onde guardar e o que cada chave libera.
Toda chamada leva a chave no cabeçalho Authorization, no esquema Bearer:
Authorization: Bearer <sua chave>| Regra | Detalhe |
|---|---|
| Onde guardar | Só no seu servidor. Nunca em app, navegador, repositório ou log. Quem tem a chave consulta e gera cobrança em seu nome. |
| Chave vazada | Revogue no portal (Chaves de API → Revogar). A chave para de responder na hora. |
| Produtos por chave | Cada chave libera só os produtos marcados nela. Produto fora da chave responde 403. |
| Limite de gasto | Cada chave pode ter um teto de gasto por dia. Ao atingir, responde 429 até a meia-noite (horário de Brasília). |
| IPs permitidos | Se a sua conta tiver lista de IPs, chamada de fora dela responde 403. |
| Chave inválida | Ausente, errada ou revogada: 401, com o cabeçalho WWW-Authenticate. |
Há uma chave por cliente seu? Dê a cada uma o nome e o documento do cliente no portal: o consumo e a fatura saem separados por chave.