Ugrás a fő tartalomhoz
GET
Kérd le egy időpont klinikai és genetikai laboreredményeit, a PDF laborleletek dokumentumhivatkozásaival együtt. Az időponthoz rendelt minden biomarker megjelenik a válaszban, így a teljes rendelést nyomon követheted, nem csak a már megérkezett eredményeket. Olvasd ki minden eredmény status mezőjét, mielőtt a value értékét használod:
  • A még függőben lévő vizsgálatok planned állapottal jelennek meg, amíg az időpont in_progress állapotú.
  • Azok az eredmények, amelyeket a laboratórium leszállított, de klinikailag nem szabad felhasználni, fault vagy undeliverable állapottal jelennek meg, és egy status_reason mező magyarázza meg az okát. Egy fault eredménynél a value még ki van töltve — ez az érték hibás. Soha ne jelenítsd meg leletként.
  • Azok az eredmények, amelyeket az Aniva vagy a tag kétségbe von, likely_wrong állapottal és status_reason mezővel jelennek meg. Az érték nincs megerősítve. Felülvizsgálat nélkül ne jelenítsd meg leletként.
Minden beérkezett eredmény és dokumentum tartalmazza a lab_code (a cső vonalkódja) értéket, amely alatt iktatták, a submissions tömb pedig a vérvétel minden laboratóriumi vizsgálatkérését listázza a saját állapotával — a több csövet vagy laboratóriumot érintő vérvétel vizsgálatkérésenként fejeződik be. Használd a Dokumentum letöltése végpontot a documents tömbben hivatkozott PDF laborleletek letöltéséhez. Nem kell folyamatosan lekérdezned ezt a végpontot. Iratkozz fel az appointment.results.updated vagy az appointment.results.completed webhookokra, és akkor hívd meg, amikor egy esemény megérkezik. A rendszeres lekérdezés tartalék megoldásként továbbra is működik. A results_view scope szükséges.

Kérés

Útvonalparaméterek

string
kötelező
Annak az időpontnak az egyedi azonosítója (UUID), amelynek az eredményeit lekéred.

Válasz

Siker esetén az API 200 OK választ ad vissza az eredmények objektumával.
string
kötelező
Az eredmények összesített állapota. Az alábbiak egyike:
  • in_progress — néhány vizsgálatkérés még a laboratóriumban van.
  • completed — minden vizsgálatkérés lezárult, és legalább egyhez érkezett lelet.
  • fault — minden vizsgálatkérés lelet nélkül meghiúsult. Semmi nem marad függőben.
object[]
kötelező
Egy bejegyzés laboratóriumi vizsgálatkérésenként — egy több csövet vagy laboratóriumot érintő vérvételhez több is tartozik. A legfelső szintű status értéke completed, amint minden bejegyzés lezárult, és legalább egyhez érkezett lelet.
object[]
kötelező
Klinikai biomarker-eredmények tömbje.
object[]
kötelező
Genetikai biomarker-eredmények tömbje.
object[]
kötelező
Laborlelet-dokumentumok. Az egyes fájlok letöltéséhez használd a GET /api/v1/documents/{id} végpontot.

Ismételt hívások

Az Aniva minden API-kulcshoz 60 percig tárolja ennek a végpontnak a válaszát. Ezen az időn belül egy ismételt hívás a tárolt választ kapja vissza, amíg az időpont és annak eredményei változatlanok. Változás után friss választ kapsz. A Cache-Status és az Age fejléc mutatja, hogy a válasz tárolt, és mennyi idős. Ha azonnal értesülni szeretnél egy változásról, iratkozz fel az appointment.results.updated, appointment.results.completed és appointment.results.fault webhookeseményekre. Lásd: Ismételt olvasások.

Hibaválaszok