Vead

Vead jagavad üht ümbrist (vaata ülevaadet). Hargne väärtuse code järgi, logi meta.request_id ja käsitle message väärtust inimestele mõeldud ingliskeelse tekstina.

Kliendi vead

Kood	Olek	Tähendus ja mida teha
validation_failed	400	Väli ei läbinud valideerimist. field nimetab selle; details selgitab. Paranda väli.
bad_request	400	Päringut ei õnnestunud üldse lugeda: vigane JSON, katkine Content-Encoding voog, katkestatud sisu. Parandatavat välja pole; kontrolli transporti.
validation_error	400	X-Account-Id saadeti lõpp-punktile, mis seda keelab (/auth/login, /auth/refresh, /auth/swap-company, /auth/logout).
cursor_expired	400	Lehekülgedeks jaotamise kursor on vanem kui 24 tundi. Alusta loendamist uuesti.
unauthenticated	401	Puuduv või kehtetu token. Värskenda seanssi või kontrolli võtit.
invalid_signature	401	Veebihaagi allkiri ei läbinud kontrolli. Vaata Veebihaagid.
forbidden	403	Token on kehtiv, kuid tal puudub õigus.
account_context_mismatch	403	X-Account-Id ei vasta tokeni kontole. Kliendi arusaam praegusest ettevõttest on nihkunud; loe see uuesti seansist.
not_found	404	Ressurssi pole olemas või see kuulub teisele kontole või saidile. API ei tee neil kunagi vahet.
conflict	409	Olekukonflikt: optimistlik lukk, unikaalsuspiirang või toiming, mis pole praeguses olekus lubatud (näiteks ühendatud vestlusesse kirjutamine).
idempotency_key_conflict	409	Idempotency-Key võtit kasutati uuesti erineva sisuga.
payload_too_large	413	Sisu ületab selle lõpp-punktide perekonna piirangu.
unsupported_media_type	415	Vale Content-Type.
unprocessable	422	Kehtiv JSON, kuid ärireegel lükkas selle tagasi (näiteks broneerimisaeg väljaspool tööaega).
storage_quota_exceeded	422	Konto jõudis oma paketi salvestusruumi piirini. details sisaldab välju used_bytes, quota_bytes ja requested_bytes; vabasta ruumi või vali kõrgem pakett.
rate_limited	429	Aeglusta. Järgi päist Retry-After ja välja details.retry_after_seconds.

Serveri vead

Kood	Olek	Tähendus ja mida teha
internal_error	500	Ootamatu tõrge. Proovi üks kord uuesti, seejärel võta ühendust toega ja lisa request_id.
upstream_unavailable	502	Lüüs ei saanud teenusega üldse ühendust. Lühike korduskatse õnnestub tavaliselt.
service_unavailable	503	Plaaniline hooldus või avatud kaitselüliti. Proovi uuesti pärast päises Retry-After antud aega.
ai_vendor_out_of_funds	503	Sinu AI-pakkuja keeldus väljakutsest arveldusega seotud põhjustel (teenusepakkuja 402 või kvoodi 429). Täienda teenusepakkuja kontot; korduskatse ei aita.
upstream_timeout	504	Teenus ei vastanud õigel ajal. Proovi uuesti, kui retry_after on olemas.

Korduskatsed

Proovi uuesti vastuste 429, 502, 503, 504 ja võrgutõrgete korral eksponentsiaalse ooteajaga ning saada korduskatsega sama Idempotency-Key, et kirjutamist ei rakendataks kunagi kaks korda. Ära korda muid 4xx vastuseid peale 429.