Fehler
Statuscodes, Fehlercodes und was Sie jeweils tun können.
Alle Fehler haben dieselbe Form:
{
"error": {
"type": "invalid_request_error",
"code": "validation_error",
"message": "`kg` is invalid: Too small: expected number to be >=1.",
"param": "kg"
}
}
param nennt das fehlerhafte Feld der Anfrage, sofern es eines gibt. Jede Antwort enthält einen Request-Id-Header: Geben Sie ihn an, wenn Sie den Support kontaktieren.
| Status | Code | Erneut versuchen? | Was Sie tun können |
|---|---|---|---|
| 400 | invalid_json |
Nein | Senden Sie ein JSON-Objekt mit höchstens 10 KB. |
| 400 | idempotency_key_missing / idempotency_key_invalid |
Nein | Senden Sie einen gültigen Idempotency-Key. |
| 401 | invalid_api_key |
Nein | Prüfen Sie den Schlüssel; er wurde möglicherweise widerrufen. |
| 402 | insufficient_balance |
Nach einer Aufladung | Der Fehler enthält balance_cents und required_cents. |
| 403 | api_access_inactive |
Nein | Das Konto ist nicht freigegeben oder es ist gesperrt. Wenden Sie sich an den Support. |
| 403 | insufficient_permissions |
Nein | Verwenden Sie einen Schlüssel mit Kaufberechtigung. |
| 404 | resource_missing / not_found |
Nein | Prüfen Sie die ID der Kompensation oder den Pfad. |
| 409 | idempotency_key_reused |
Nein | Verwenden Sie für einen neuen Kauf einen neuen Idempotency-Key. |
| 422 | validation_error |
Nein | Korrigieren Sie das Feld in param. |
| 422 | amount_too_small |
Nein | Mit dem Betrag erhalten Sie zu Ihrem Tarif weniger als 1 kg. |
| 429 | rate_limited |
Ja | Warten Sie die in Retry-After angegebenen Sekunden ab. |
| 500 | api_error |
Ja | Wiederholen Sie die Anfrage mit demselben Idempotency-Key. |