Napake

Napake si delijo eno ovojnico (glejte pregled). Logiko razvejajte glede na code, beležite meta.request_id, message pa obravnavajte kot angleško besedilo za ljudi.

Napake odjemalca

Koda	Stanje	Pomen in kaj storiti
validation_failed	400	Polje ni prestalo preverjanja veljavnosti. field ga navede, details pojasni. Popravite polje.
bad_request	400	Zahteve sploh ni bilo mogoče prebrati: napačno oblikovan JSON, pokvarjen tok Content-Encoding, prekinjeno telo. Polja za popravek ni; preverite prenos.
validation_error	400	X-Account-Id je bil poslan končni točki, ki ga prepoveduje (/auth/login, /auth/refresh, /auth/swap-company, /auth/logout).
cursor_expired	400	Kazalec ostranjevanja je starejši od 24 ur. Začnite izpis znova.
unauthenticated	401	Žeton manjka ali ni veljaven. Osvežite sejo ali preverite ključ.
invalid_signature	401	Podpis webhooka ni prestal preverjanja. Glejte Webhooki.
forbidden	403	Žeton je veljaven, vendar nima zahtevanega dovoljenja.
account_context_mismatch	403	X-Account-Id se ne ujema z računom žetona. Odjemalec ima zastarel podatek o trenutnem podjetju; znova ga preberite iz seje.
not_found	404	Vir ne obstaja ali pripada drugemu računu ali spletnemu mestu. API teh dveh primerov nikoli ne razlikuje.
conflict	409	Spor stanja: optimistično zaklepanje, omejitev edinstvenosti ali dejanje, ki v trenutnem stanju ni dovoljeno (na primer pisanje v združen pogovor).
idempotency_key_conflict	409	Idempotency-Key je bil znova uporabljen z drugačnim telesom.
payload_too_large	413	Telo presega omejitev za to družino končnih točk.
unsupported_media_type	415	Napačen Content-Type.
unprocessable	422	Veljaven JSON, ki pa ga je zavrnilo poslovno pravilo (na primer termin rezervacije zunaj delovnega časa).
storage_quota_exceeded	422	Račun je dosegel omejitev prostora za shranjevanje svojega paketa. details vsebuje used_bytes, quota_bytes in requested_bytes; sprostite prostor ali preidite na višji paket.
rate_limited	429	Upočasnite. Upoštevajte Retry-After in details.retry_after_seconds.

Napake strežnika

Koda	Stanje	Pomen in kaj storiti
internal_error	500	Nepričakovana napaka. Poskusite še enkrat, nato se obrnite na podporo z request_id.
upstream_unavailable	502	Prehod sploh ni mogel doseči storitve. Kratek ponovni poskus običajno uspe.
service_unavailable	503	Načrtovano vzdrževanje ali odprt odklopnik (circuit breaker). Poskusite znova po času iz glave Retry-After.
ai_vendor_out_of_funds	503	Vaš ponudnik AI je klic zavrnil zaradi obračuna (402 ali 429 zaradi kvote pri ponudniku). Napolnite račun pri ponudniku; ponovni poskus ne bo pomagal.
upstream_timeout	504	Storitev ni odgovorila pravočasno. Poskusite znova, če je prisoten retry_after.

Ponovni poskusi

Znova poskusite pri 429, 502, 503, 504 in omrežnih napakah z eksponentnim podaljševanjem premora in pri ponovnem poskusu pošljite isti Idempotency-Key, da se zapis nikoli ne izvede dvakrat. Pri 4xx razen 429 ne poskušajte znova.