Feil

Feil deler én konvolutt (se oversikten). Forgren på code, logg meta.request_id, og behandle message som engelsk tekst beregnet på mennesker.

Klientfeil

Kode	Status	Betydning og hva du bør gjøre
validation_failed	400	Et felt besto ikke valideringen. field angir hvilket; details forklarer. Rett feltet.
bad_request	400	Forespørselen kunne ikke leses i det hele tatt: ugyldig JSON, en ødelagt Content-Encoding-strøm, en avbrutt body. Det finnes ikke noe felt å rette; kontroller transporten.
validation_error	400	X-Account-Id ble sendt til et endepunkt som ikke tillater den (/auth/login, /auth/refresh, /auth/swap-company, /auth/logout).
cursor_expired	400	Pagineringsmarkøren er eldre enn 24 timer. Start listingen på nytt.
unauthenticated	401	Manglende eller ugyldig token. Forny økten eller kontroller nøkkelen.
invalid_signature	401	En webhook-signatur kunne ikke verifiseres. Se Webhooks.
forbidden	403	Tokenet er gyldig, men mangler tillatelsen.
account_context_mismatch	403	X-Account-Id samsvarer ikke med tokenets konto. Klientens oppfatning av gjeldende selskap har forskjøvet seg; les den på nytt fra økten.
not_found	404	Ressursen finnes ikke eller tilhører en annen konto eller et annet nettsted. API-et skiller aldri mellom de to.
conflict	409	Tilstandskonflikt: optimistisk lås, unikhetsbegrensning eller en handling som ikke er tillatt i gjeldende tilstand (for eksempel å skrive til en sammenslått samtale).
idempotency_key_conflict	409	Idempotency-Key ble gjenbrukt med en annen body.
payload_too_large	413	Bodyen overskrider grensen for denne endepunktfamilien.
unsupported_media_type	415	Feil Content-Type.
unprocessable	422	Gyldig JSON, men en forretningsregel avviste den (for eksempel et bookingtidspunkt utenfor arbeidstiden).
storage_quota_exceeded	422	Kontoen har nådd lagringsgrensen i abonnementet. details inneholder used_bytes, quota_bytes og requested_bytes; frigjør plass eller oppgrader.
rate_limited	429	Senk tempoet. Respekter Retry-After og details.retry_after_seconds.

Serverfeil

Kode	Status	Betydning og hva du bør gjøre
internal_error	500	Uventet feil. Prøv én gang til, og kontakt deretter kundestøtte med request_id.
upstream_unavailable	502	Gatewayen nådde ikke tjenesten i det hele tatt. Et nytt forsøk etter kort tid lykkes vanligvis.
service_unavailable	503	Planlagt vedlikehold eller en åpen kretsbryter. Prøv igjen etter tiden i headeren Retry-After.
ai_vendor_out_of_funds	503	AI-leverandøren din avviste kallet av faktureringsårsaker (en 402 eller en kvote-429 fra leverandøren). Fyll på leverandørkontoen; et nytt forsøk hjelper ikke.
upstream_timeout	504	Tjenesten svarte ikke i tide. Prøv igjen når retry_after er til stede.

Nye forsøk

Prøv 429, 502, 503, 504 og nettverksfeil på nytt med eksponentiell backoff, og send samme Idempotency-Key ved nytt forsøk, slik at en skriveoperasjon aldri utføres to ganger. Ikke prøv 4xx på nytt, bortsett fra 429.