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ód | Jelentés |
|---|---|
400 | Rossz kérés — validációs hiba |
401 | Hiányzó vagy érvénytelen API kulcs |
403 | Nincs jogosultság az erőforráshoz |
404 | Az erőforrás nem található |
409 | Konfliktus — pl. idempotency ütközés |
429 | Rate limit túllépve |
5xx | Szerveroldali hiba |
Hiba payload
json
{
"error": {
"code": "validation_error",
"message": "Field 'name' is required.",
"field": "name",
"request_id": "req_01HZ..."
}
}Ajánlott stratégia
- 4xx hibáknál javítsd a kérést — ne próbáld újra változatlanul.
- 429-nél tartsd tiszteletben a
Retry-Afterheadert. - 5xx-nél exponenciális backoff-fal próbálkozz, max 5-ször.
- A
request_id-t mindig logold — support kérésnél elengedhetetlen.