Ugrás a tartalomhoz

Fejlett

Hibakezelés

HTTP státuszkódok, hiba payload formátum, és ajánlott recovery stratégiák.

A QUiCK API kiszámítható HTTP státuszkódokat és strukturált hiba payload-ot ad vissza.

Státuszkódok

KódJelentés
400Rossz kérés — validációs hiba
401Hiányzó vagy érvénytelen API kulcs
403Nincs jogosultság az erőforráshoz
404Az erőforrás nem található
409Konfliktus — pl. idempotency ütközés
429Rate limit túllépve
5xxSzerveroldali hiba

Hiba payload

json
{
  "error": {
    "code": "validation_error",
    "message": "Field 'name' is required.",
    "field": "name",
    "request_id": "req_01HZ..."
  }
}

Ajánlott stratégia

  1. 4xx hibáknál javítsd a kérést — ne próbáld újra változatlanul.
  2. 429-nél tartsd tiszteletben a Retry-After headert.
  3. 5xx-nél exponenciális backoff-fal próbálkozz, max 5-ször.
  4. A request_id-t mindig logold — support kérésnél elengedhetetlen.