Guia

Erros, limites e recuperação

Todo erro traz code, message, field, retryable e request_id. O request_id é o dado certo para o suporte.

1. 1retryable false: corrija a requisição antes de repetir.
2. 2retryable true ou 429: respeite Retry-After.
3. 3409 idempotency_conflict: use nova reference para uma nova cobrança.
4. 4Nunca envie API key ao suporte; envie request_id.

{\n  "error": { "code": "invalid_request", "message": "service_id é obrigatório.", "field": "service_id", "retryable": false, "request_id": "req_..." }\n}