Felhantering

vitalera haelsovaards-API anvaender standard HTTP-statuskoder och returnerar strukturerade felsvar foer att hjaelpa dig att diagnostisera och loesa problem i din fjaerroevervakningsintegration (RPM). Oavsett om du samlar in vitala tecken fraan medicinska enheter eller hanterar kliniska arbetsfloeden saekerstaeller konsekvent felhantering paalitligt datautbyte.

Felsvarformat

Alla felsvar foeljer en konsekvent JSON-struktur:

{
  "detail": "A human-readable description of the error.",
  "code": "error_code"
}

Foer valideringsfel inkluderar svaret detaljer paa faeltnivaa:

{
  "field_name": ["This field is required."],
  "nested_field": {
    "sub_field": ["Ensure this value is greater than 0."]
  }
}

Vanliga HTTP-statuskoder

Klientfel (4xx)

Kod	Betydelse	Beskrivning
400	Bad Request	Begaerans kropp aer felformaterad eller saknar obligatoriska faelt. Kontrollera svaret foer valideringsfel paa faeltnivaa.
401	Unauthorized	Autentiseringen misslyckades. JWT-tokenet saknas, har loept ut eller aer ogiltigt.
403	Forbidden	Den autentiserade anvaendaren har inte behoerighet att komma aat denna resurs eller utfoera denna aatgaerd.
404	Not Found	Den begaerda resursen finns inte, eller saa har anvaendaren inte synlighet till den.
422	Unprocessable Entity	Begaeran aer vaelformaterad men innehaaller semantiska fel (t.ex. ogiltig tillstaandsoevergaang, brott mot affaersregel).
429	Too Many Requests	Hastighetsgraensen oeverskriden. Se Hastighetsgraenser foer detaljer.

Serverfel (5xx)

Kod	Betydelse	Beskrivning
500	Internal Server Error	Ett oevaentat fel intraeffade paa servern. Om detta kvarstaar, kontakta support med begaeran-ID:t.
502	Bad Gateway	En nedstroems tjaenst aer tillfaeligt otillgaenglig. Foersoek igen efter en kort foerdroejning.
503	Service Unavailable	Tjaensten genomgaar underhaall. Kolla statussidan foer uppdateringar.

Autentiseringsfel

Utgaanget token

{
  "detail": "Given token not valid for any token type",
  "code": "token_not_valid"
}

Loesning: Begaer ett nytt aatkomsttoken med hjaelp av ditt refresh token eller klientuppgifter. Se Autentisering.

Saknat token

{
  "detail": "Authentication credentials were not provided."
}

Loesning: Inkludera ett giltigt JWT-token i Authorization: Bearer <token>-huvudet.

Valideringsfel

Valideringsfel returnerar 400 Bad Request med faeltspecifika meddelanden:

{
  "status": ["\"invalid\" is not a valid choice."],
  "effective_period_start": ["This field is required."]
}

Loesning: Fix de angivna faelten och foersoek igen. Se API-referens foer giltiga faeltvaerden.

Hastighetsgraens-fel

Naer du oeverskrider hastighetsgraensen returnerar API:et 429 Too Many Requests:

{
  "detail": "Request was throttled. Expected available in 30 seconds."
}

Loesning: Vaenta paa den angivna tiden i svaret eller Retry-After-huvudet innan du foersoeker igen. Se Hastighetsgraenser foer kvotdetaljer.

Felsoekningstips

1. Kontrollera svarskroppen -- felsvar inkluderar alltid ett laesbart detail-meddelande.
2. Validera din JWT -- anvaend jwt.io foer att avkoda ditt token och kontrollera dess utgaang (exp-paastaaende).
3. Verifiera behoerheter -- se till att din applikation eller anvaendarroll har aatkomst till den begaerda resursen.
4. Granska begaeran-formatet -- jaemfoer din begaeran med API-referensexempel.
5. Kontrollera hastighetsgraenser -- om du faar 429-svar, implementera exponentiell backoff.
6. Kontakta support -- foer permanenta 500-fel, kontakta support@vitalera.io med begaeran-tidsstaempel och aendpunkt.