Errori
Codici di stato, codici di errore e cosa fare in ciascun caso.
Tutti gli errori hanno la stessa struttura:
{
"error": {
"type": "invalid_request_error",
"code": "validation_error",
"message": "`kg` is invalid: Too small: expected number to be >=1.",
"param": "kg"
}
}param indica il campo della richiesta che causa l’errore, se presente. Ogni risposta include un’intestazione Request-Id: la indichi quando contatta l’assistenza.
| Stato | Codice | Riprovare? | Cosa fare |
|---|---|---|---|
| 400 | invalid_json |
No | Invii un oggetto JSON di massimo 10 KB. |
| 400 | idempotency_key_missing / idempotency_key_invalid |
No | Invii una Idempotency-Key valida. |
| 401 | invalid_api_key |
No | Verifichi la chiave: potrebbe essere stata revocata. |
| 402 | insufficient_balance |
Dopo una ricarica | L’errore include balance_cents e required_cents. |
| 403 | api_access_inactive |
No | L’account non è approvato oppure è sospeso. Contatti l’assistenza. |
| 403 | insufficient_permissions |
No | Usi una chiave con accesso agli acquisti. |
| 404 | resource_missing / not_found |
No | Verifichi l’ID della compensazione o il percorso. |
| 409 | idempotency_key_reused |
No | Usi una nuova chiave di idempotenza per ogni nuovo acquisto. |
| 422 | validation_error |
No | Corregga il campo indicato in param. |
| 422 | amount_too_small |
No | Alla sua tariffa, l’importo acquista meno di 1 kg. |
| 429 | rate_limited |
Sì | Attenda il numero di secondi indicato in Retry-After. |
| 500 | api_error |
Sì | Riprovi con la stessa Idempotency-Key. |