Erroreen kudeaketa

vitalera osasun APIak HTTP egoera-kode estandarrak erabiltzen ditu eta errore-erantzun egituratuak itzultzen ditu zure urruneko pazienteen monitorizazio (RPM) integrazioan arazoak diagnostikatu eta konpontzeko. Gailu medikoetatik bizi-konstanteak biltzen ari zarenean edo lan-fluxu klinikoak kudeatzen dituzunean, errore-kudeaketa koherenteak datuen truke fidagarria bermatzen du.

Errore-erantzunaren formatua

Errore-erantzun guztiek JSON egitura koherente bat jarraitzen dute:

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

Balioztatze-erroreetarako, erantzunak eremu-mailako xehetasunak biltzen ditu:

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

Ohiko HTTP egoera-kodeak

Bezero-erroreak (4xx)

Kodea	Esanahia	Deskribapena
400	Eskaera okerra	Eskaeraren gorputza gaizki osatua dago edo beharrezko eremuak falta dira. Egiaztatu erantzuna eremu-mailako balioztatze-erroreetarako.
401	Baimendu gabea	Autentifikazioak huts egin du. JWT tokena falta da, iraungita dago edo baliogabea da.
403	Debekatua	Autentifikatutako erabiltzaileak ez du baliabide honetara sarbiderik edo ekintza hau egiteko baimenik.
404	Ez da aurkitu	Eskatutako baliabidea ez da existitzen, edo erabiltzaileak ez du horretarako ikusgarritasunik.
422	Entitate ez-prozesagarria	Eskaera ongi osatua dago baina errore semantikoak ditu (adib., egoera-trantsizio baliogabea, negozio-arauaren urraketa).
429	Eskaera gehiegi	Tasa-muga gainditu da. Ikusi Tasa-mugak mugen eta berriro saiatze-estrategien xehetasunetarako.

Zerbitzari-erroreak (5xx)

Kodea	Esanahia	Deskribapena
500	Barneko zerbitzari-errorea	Ustekabeko errore bat gertatu da zerbitzarian. Hau irauten badu, jarri harremanetan laguntza-zerbitzuarekin eskaeraren IDarekin.
502	Atebide okerra	Beheko zerbitzu bat aldi baterako ez dago eskuragarri. Saiatu berriro tarte labur baten ondoren.
503	Zerbitzua ez dago eskuragarri	Zerbitzua mantentze-lanetan dago. Egiaztatu egoera-orria eguneraketarako.

Autentifikazio-erroreak

Iraungitako tokena

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

Konponbidea: Eskatu sarbide-token berri bat zure freskatze-tokena edo bezero-kredentzialak erabiliz. Ikusi Autentifikazioa.

Token falta

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

Konponbidea: Sartu JWT token baliozko bat Authorization: Bearer <token> goiburuan.

Balioztatze-erroreak

Balioztatze-erroreak 400 Bad Request itzultzen dute eremu-mailako mezuekin:

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

Konponbidea: Zuzendu adierazitako eremuak eta saiatu berriro eskaerarekin. Kontsultatu API erreferentzia eremu-balio baliozkoak eskuratzeko.

Tasa-mugaren erroreak

Tasa-muga gainditzen duzunean, APIak 429 Too Many Requests itzultzen du:

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

Konponbidea: Itxaron erantzunean edo Retry-After goiburuan adierazitako iraupenera arte berriro saiatu aurretik. Ikusi Tasa-mugak kuota-xehetasunetarako.

Arazoak konpontzeko aholkuak

1. Egiaztatu erantzunaren gorputza -- errore-erantzunek beti detail mezu irakurgarri bat biltzen dute.
2. Balioztatu zure JWT -- erabili jwt.io zure tokena deskodetzeko eta bere iraungitzea (exp claim) egiaztatzeko.
3. Egiaztatu baimenak -- ziurtatu zure aplikazioak edo erabiltzaile-rolak eskatutako baliabiderako sarbidea duela.
4. Berrikusi eskaeraren formatua -- konparatu zure eskaera API erreferentziako adibideekin.
5. Egiaztatu tasa-mugak -- 429 erantzunak jasotzen badituzu, inplementatu atzerapen esponentziala.
6. Jarri harremanetan laguntza-zerbitzuarekin -- 500 errore iraunkorretarako, jarri harremanetan support@vitalera.io helbidean eskaeraren data-zigiluarekin eta amaiera-puntuarekin.