Klaidos formatas
{
"error": {
"code": "API_KEY_INVALID",
"message": "API key is invalid.",
"requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
}
Kiekviena gateway klaida grąžina X-Arbebus-Request-Id antraštę ir tą patį requestId kūne.
Stabilūs kodai
| Kodas | Reikšmė |
|---|---|
INVALID_REQUEST | Neteisinga užklausa |
METHOD_NOT_ALLOWED | Nepalaikomas metodas |
ROUTE_NOT_FOUND | Nežinomas maršrutas |
UNSUPPORTED_MEDIA_TYPE | Netinkamas Content-Type |
PAYLOAD_TOO_LARGE | Per didelis body |
AUTHORIZATION_REQUIRED | Trūksta Authorization |
AUTHORIZATION_MALFORMED | Neteisingas Authorization |
API_KEY_INVALID | Raktas neteisingas |
API_KEY_REVOKED | Raktas atšauktas |
API_KEY_EXPIRED | Raktas pasibaigęs |
API_KEY_ENVIRONMENT_MISMATCH | Aplinkos nesutapimas |
API_KEY_SCOPE_DENIED | Trūksta scope |
PROJECT_UNAVAILABLE | Projektas neprieinamas |
ORGANIZATION_UNAVAILABLE | Organizacija neprieinama |
RATE_LIMIT_EXCEEDED | Per-minute abuse RPM exceeded |
QUOTA_EXCEEDED | Cumulative technical sandbox quota exceeded |
IDEMPOTENCY_KEY_INVALID | Idempotency-Key empty, oversized, or contains control characters |
IDEMPOTENCY_CONFLICT | Same Idempotency-Key with a different request fingerprint |
IDEMPOTENCY_IN_PROGRESS | Concurrent duplicate still processing |
ORIGIN_NOT_ALLOWED | Origin not allowed |
INTERNAL_ERROR | Internal error |
HTTP codes
| Code | Meaning | Action |
|---|---|---|
| 400 | Invalid request | Fix parameters |
| 401 | Authentication error | Check key |
| 403 | Authorization error | Check scope / status |
| 404 | Route not found | Check URL |
| 405 | Method not allowed | Use Allow |
| 409 | Idempotency conflict / in progress | Do not change body for same key; wait or use a new key |
| 413 | Payload too large | Reduce body |
| 415 | Media type | Use application/json |
| 429 | Rate limit or technical quota | Inspect error.code: RATE_LIMIT_EXCEEDED vs QUOTA_EXCEEDED |
| 500/503 | Server error | Retry with backoff |
Retry strategija
Naudokite eksponentinį laukimą su atsitiktine paklaida. Nekartokite 400, 401, 403 ir 404 užklausų automatiškai.
Pagalba
Kreipdamiesi į palaikymą pridėkite requestId, laiką, endpoint’ą ir projekto identifikatorių. Nesiųskite pilno slapto API rakto.