Erros comuns

• 401: autenticacao ausente/invalida.
• 403: acesso proibido ou chave revogada.
• 403 (whitelist): IP nao liberado para a API key.
• 404: recurso nao encontrado.
• 422: payload invalido.
• 429: limite de taxa excedido.
• 500: erro interno.

Padrão de resposta de erro

{
  "detail": "mensagem de erro"
}

Erro de IP nao liberado

Quando a API key tem whitelist configurada e a requisicao vem de outro IP/CIDR, a API retorna:

• HTTP 403
• detail: IP não permitido para esta API key