Greške
Greške dijele jednu omotnicu (pogledajte pregled). Grananje logike temeljite na code, zapisujte meta.request_id, a message smatrajte tekstom na engleskom namijenjenim ljudima.
Greške klijenta
Odjeljak „Greške klijenta”| Kod | Status | Značenje i što učiniti |
|---|---|---|
validation_failed |
400 | Polje nije prošlo provjeru valjanosti. field ga navodi, details objašnjava. Ispravite polje. |
bad_request |
400 | Zahtjev se uopće nije mogao pročitati: neispravan JSON, oštećen Content-Encoding tok, prekinuto tijelo. Nema polja za ispravak; provjerite prijenos. |
validation_error |
400 | X-Account-Id poslan je krajnjoj točki koja ga zabranjuje (/auth/login, /auth/refresh, /auth/swap-company, /auth/logout). |
cursor_expired |
400 | Kursor straničenja stariji je od 24 sata. Pokrenite popis ispočetka. |
unauthenticated |
401 | Token nedostaje ili nije valjan. Osvježite sesiju ili provjerite ključ. |
invalid_signature |
401 | Potpis webhooka nije prošao provjeru. Pogledajte Webhookovi. |
forbidden |
403 | Token je valjan, ali nema potrebnu ovlast. |
account_context_mismatch |
403 | X-Account-Id ne odgovara računu tokena. Klijentova predodžba o trenutačnoj tvrtki je zastarjela; ponovno je pročitajte iz sesije. |
not_found |
404 | Resurs ne postoji ili pripada drugom računu ili stranici. API nikada ne razlikuje ta dva slučaja. |
conflict |
409 | Sukob stanja: optimističko zaključavanje, ograničenje jedinstvenosti ili radnja koja nije dopuštena u trenutačnom stanju (na primjer upis u spojeni razgovor). |
idempotency_key_conflict |
409 | Idempotency-Key ponovno je upotrijebljen s drugačijim tijelom. |
payload_too_large |
413 | Tijelo premašuje ograničenje za ovu obitelj krajnjih točaka. |
unsupported_media_type |
415 | Pogrešan Content-Type. |
unprocessable |
422 | Valjan JSON, ali ga je odbilo poslovno pravilo (na primjer termin rezervacije izvan radnog vremena). |
storage_quota_exceeded |
422 | Račun je dosegnuo ograničenje pohrane svojeg paketa. details sadrži used_bytes, quota_bytes i requested_bytes; oslobodite prostor ili prijeđite na viši paket. |
rate_limited |
429 | Usporite. Poštujte Retry-After i details.retry_after_seconds. |
Greške poslužitelja
Odjeljak „Greške poslužitelja”| Kod | Status | Značenje i što učiniti |
|---|---|---|
internal_error |
500 | Neočekivan kvar. Pokušajte još jednom, a zatim se obratite podršci s request_id. |
upstream_unavailable |
502 | Pristupnik uopće nije mogao doći do usluge. Kratko ponavljanje obično uspije. |
service_unavailable |
503 | Planirano održavanje ili otvoreni prekidač strujnog kruga (circuit breaker). Ponovite nakon vremena iz zaglavlja Retry-After. |
ai_vendor_out_of_funds |
503 | Vaš AI pružatelj odbio je poziv zbog naplate (402 ili 429 zbog kvote kod pružatelja). Nadoplatite račun kod pružatelja; ponavljanje neće pomoći. |
upstream_timeout |
504 | Usluga nije odgovorila na vrijeme. Ponovite ako je prisutan retry_after. |
Ponavljanje
Odjeljak „Ponavljanje”Ponavljajte 429, 502, 503, 504 i mrežne kvarove s eksponencijalnim odmakom i pri ponavljanju šaljite isti Idempotency-Key kako se upis nikada ne bi primijenio dvaput. Ne ponavljajte 4xx osim 429.