Erros
Formato único de erro e o que cada código significa.
Todo erro tem o mesmo formato:
{"error": {"code": "...", "message": "..."}}Programe contra o code; o message é texto para gente e pode mudar.
| HTTP | code | Causa comum |
|---|---|---|
| 400 | bad_request | parâmetro inválido (limit, cursor, filtro); o message diz qual |
| 401 | unauthorized | token vencido (renove), credencial revogada ou secret errado |
| 403 | forbidden | o papel da credencial não cobre a chamada, conta somente leitura, workspace fora do acesso antecipado ou desativado |
| 404 | not_found | recurso inexistente ou oculto para a credencial |
| 405 | method_not_allowed | método HTTP que a rota não aceita |
| 422 | unprocessable | dado válido no formato, mas recusado pela regra |
| 429 | rate_limited | mais de 120 chamadas no minuto; espere o Retry-After |
| 500 | internal_error | falha do nosso lado |