Programadores · API
Erros da API e limites de pedidos
Todas as rotas da API devolvem os erros num envelope único. Use o code para decidir; o message é só para pessoas e pode mudar.
O envelope
{"error": {"code": "validation_error", "message": "request body is invalid", "field": "body"}}field aparece quando o erro diz respeito a um campo concreto.
Códigos mais comuns
| HTTP | code | O que fazer |
|---|---|---|
| 400 | invalid_request, invalid_idempotency_key | Corrija o pedido |
| 401 | unauthorized | Peça um token novo |
| 403 | forbidden, insufficient_scope | Falta permissão ou âmbito |
| 404 | not_found | O recurso não existe ou é de outro cliente |
| 409 | conflict | Idempotência ou estado; leia o estado atual |
| 422 | validation_error, invalid_cursor | Corrija o campo; recomece a lista |
| 429 | rate_limited | Espere Retry-After |
| 503 | service_unavailable, service_busy | Espere Retry-After e repita |
| 500 | internal_error | Repita mais tarde; se persistir, contacte o suporte com a hora |
A lista completa, com causas e soluções, está no índice de códigos de erro.
Limites (pedidos de aprovação)
Por 60 segundos, por cliente e rede de origem: 30 pedidos de token, 120 criações, 600 leituras e 1200 chamadas no total. No máximo 20 pedidos pendentes por pessoa e 1000 por cliente.
Como repito em segurança
- Repita só chamadas idempotentes ou com
Idempotency-Key. - Use espera exponencial com variação aleatória e respeite
Retry-After. - Nunca gere uma chave de idempotência nova para a mesma operação.
- Não repita um
4xxdiferente de 429 sem mudar o pedido.
Códigos de erro deste artigo
Esta página ajudou?
Obrigado. A resposta fica guardada apenas neste browser; não enviamos nada.
Lamentamos. Experimente:
- pesquisar com o texto exato da mensagem ou o código de erro
- consultar o índice de códigos de erro
- falar com o administrador da sua organização