Salt la conținutul principal
GET
Obține rezultatele de laborator clinice și genetice pentru o programare, împreună cu referințele de document pentru rapoartele de laborator în format PDF. Fiecare biomarker comandat pentru programare apare în răspuns, astfel încât să poți urmări întreaga comandă, nu doar ceea ce a ajuns deja. Citește status pentru fiecare rezultat înainte de a folosi value:
  • Testele încă în așteptare apar cu statusul planned cât timp programarea este in_progress.
  • Rezultatele livrate de laborator, dar care nu trebuie folosite clinic, apar cu statusul fault sau undeliverable și includ un status_reason care explică motivul. Un rezultat fault are în continuare value completat — acea valoare este greșită. Nu o prezenta niciodată drept o constatare.
  • Rezultatele puse la îndoială de Aniva sau de membru apar cu statusul likely_wrong și un status_reason. Valoarea nu este confirmată. Nu o afișa drept o constatare fără verificare.
Fiecare rezultat și document primit include lab_code (codul de bare al eprubetei) sub care a fost înregistrat, iar array-ul submissions enumeră fiecare solicitare de laborator a recoltării de sânge cu propriul ei status — o recoltare de sânge împărțită pe mai multe eprubete sau laboratoare se finalizează solicitare cu solicitare. Folosește Descarcă documentul pentru a descărca rapoartele de laborator în format PDF menționate în array-ul documents. Nu trebuie să interoghezi periodic acest endpoint. Abonează-te la webhookurile appointment.results.updated sau appointment.results.completed și apelează-l când sosește un eveniment. Interogarea periodică funcționează în continuare ca soluție de rezervă. Necesită permisiunea results_view.

Cerere

Parametri de cale

string
obligatoriu
Identificatorul unic (UUID) al programării pentru care obții rezultatele.

Răspuns

La succes, API-ul returnează 200 OK cu obiectul de rezultate.
string
obligatoriu
Statusul general al rezultatelor. Una dintre valorile:
  • in_progress — unele solicitări sunt încă la laborator.
  • completed — fiecare solicitare s-a închis și cel puțin una a trimis un raport.
  • fault — fiecare solicitare a eșuat fără să trimită un raport. Nu se datorează nimic.
object[]
obligatoriu
Câte o intrare pentru fiecare solicitare de laborator — o recoltare de sânge care implică mai multe eprubete sau laboratoare are mai multe. Câmpul status de nivel superior este completed odată ce fiecare intrare s-a închis și una a trimis un raport.
object[]
obligatoriu
Listă de rezultate ale biomarkerilor clinici.
object[]
obligatoriu
Listă de rezultate ale biomarkerilor genetici.
object[]
obligatoriu
Documentele raportului de laborator. Folosește GET /api/v1/documents/{id} pentru a descărca fiecare fișier.

Apeluri repetate

Aniva stochează răspunsul acestui endpoint timp de 60 de minute pentru fiecare cheie API. Un apel repetat în acest interval primește răspunsul stocat cât timp programarea și rezultatele ei nu s-au schimbat. După o modificare, primești un răspuns nou. Antetele Cache-Status și Age arată că răspunsul este stocat și cât de vechi este. Pentru a afla imediat despre o modificare, abonează-te la evenimentele webhook appointment.results.updated, appointment.results.completed și appointment.results.fault. Vezi Citiri repetate.

Răspunsuri de eroare