Kļūdas

Kļūdām ir viena kopīga aploksne (skatiet pārskatu). Veidojiet zarošanos pēc code, reģistrējiet meta.request_id un uztveriet message kā angļu tekstu cilvēkiem.

Klienta kļūdas

Kods	Statuss	Nozīme un ko darīt
validation_failed	400	Lauks neizturēja validāciju. field to nosauc; details paskaidro. Izlabojiet lauku.
bad_request	400	Pieprasījumu nevarēja nolasīt vispār: bojāts JSON, bojāta Content-Encoding plūsma, pārtraukts saturs. Nav lauka, ko labot; pārbaudiet transportu.
validation_error	400	X-Account-Id tika nosūtīta galapunktam, kas to aizliedz (/auth/login, /auth/refresh, /auth/swap-company, /auth/logout).
cursor_expired	400	Lapošanas kursors ir vecāks par 24 stundām. Sāciet sarakstu no jauna.
unauthenticated	401	Trūkst marķiera, vai tas ir nederīgs. Atsvaidziniet sesiju vai pārbaudiet atslēgu.
invalid_signature	401	Webhook paraksts neizturēja pārbaudi. Skatiet Webhooks.
forbidden	403	Marķieris ir derīgs, bet tam trūkst atļaujas.
account_context_mismatch	403	X-Account-Id nesakrīt ar marķiera kontu. Klienta priekšstats par pašreizējo uzņēmumu ir novirzījies; nolasiet to no sesijas atkārtoti.
not_found	404	Resurss neeksistē vai pieder citam kontam vai vietnei. API nekad neatšķir šos gadījumus.
conflict	409	Stāvokļa konflikts: optimistiskā bloķēšana, unikalitātes ierobežojums vai darbība, kas pašreizējā stāvoklī nav atļauta (piemēram, rakstīšana apvienotā sarunā).
idempotency_key_conflict	409	Idempotency-Key atkārtoti izmantota ar citu saturu.
payload_too_large	413	Saturs pārsniedz šīs galapunktu saimes ierobežojumu.
unsupported_media_type	415	Nepareizs Content-Type.
unprocessable	422	Derīgs JSON, bet biznesa noteikums to atteica (piemēram, rezervācijas laiks ārpus darba laika).
storage_quota_exceeded	422	Konts sasniedza sava plāna krātuves ierobežojumu. details satur used_bytes, quota_bytes un requested_bytes; atbrīvojiet vietu vai paaugstiniet plānu.
rate_limited	429	Samaziniet ātrumu. Ievērojiet Retry-After un details.retry_after_seconds.

Servera kļūdas

Kods	Statuss	Nozīme un ko darīt
internal_error	500	Negaidīta kļūme. Atkārtojiet vienreiz, pēc tam sazinieties ar atbalstu, norādot request_id.
upstream_unavailable	502	Vārteja vispār nevarēja sasniegt servisu. Īss atkārtojums parasti izdodas.
service_unavailable	503	Plānota apkope vai atvērts ķēdes pārtraucējs. Atkārtojiet pēc galvenes Retry-After.
ai_vendor_out_of_funds	503	Jūsu AI pakalpojumu sniedzējs atteica izsaukumu norēķinu dēļ (piegādātāja 402 vai kvotas 429). Papildiniet piegādātāja kontu; atkārtojums nepalīdzēs.
upstream_timeout	504	Serviss neatbildēja laikā. Atkārtojiet, ja ir norādīts retry_after.

Atkārtošana

Atkārtojiet 429, 502, 503, 504 un tīkla kļūmes ar eksponenciālu atkāpšanos un atkārtojumā sūtiet to pašu Idempotency-Key, lai rakstīšana nekad netiktu piemērota divreiz. Neatkārtojiet 4xx, izņemot 429.