GET /api/v1/appointments/{id}/results végponton kérhetők le, és tartalmazzák a klinikai biomarker-eredményeket, a genetikai biomarker-eredményeket és a letölthető laborlelet-dokumentumokat.
Eredmények állapota
Az eredmények válaszának felső szintűstatus mezője a feldolgozás általános állapotát jelzi:
A válaszon belüli egyes eredmények saját, eredményenkénti állapottal rendelkeznek (lásd alább), így a részeredményeket már akkor is megjelenítheted, amikor az általános állapot még
in_progress.
Ha értesülni szeretnél az eredmények változásáról, iratkozz fel a webhookokra. Az appointment.results.updated az eredmények törzsének minden változásakor aktiválódik, az appointment.results.completed pedig akkor, amikor a felső szintű állapot completed értékre vált. Az otthoni tesztkészlet-rendelések ugyanezeket az eseményeket küldik a home_kit_order. előtaggal. Minden esemény tartalmazza a lekérhető eredmények URL-jét. Az egyeztetéshez továbbra is lekérdezheted ezt a végpontot.
A submissions tömb laboratóriumi igénylésenként bontja le a felső szintű állapotot. Egy több csövet vagy több laboratóriumot érintő vérvétel több bejegyzést tartalmaz, mindegyiket azzal a lab_code értékkel (a cső vonalkódjával), amely alatt benyújtották, valamint a saját in_progress / completed / fault állapotával. A fault állapotú bejegyzést a laboratórium elutasította vagy félbehagyta, és soha nem fog eredményt küldeni: a mintát gyakran egy másik laboratóriumba helyezték át, amely ezután saját bejegyzést hoz létre. A felső szintű állapot akkor completed, ha minden bejegyzés lezárult, és legalább egy küldött eredményt. Minden beérkezett eredmény és minden dokumentum ugyanezt a lab_code értéket viseli, így meg tudod állapítani, melyik csőből származik az adott érték.
Klinikai eredmények
A klinikai eredmények a szokásos vérbeli biomarker-méréseket jelentik — például a D-vitamin-szintet, a koleszterint, a pajzsmirigyhormonokat és hasonlókat. Minden klinikai eredmény tartalmazza az alábbiakat:id— a laboreredmény sorának azonosítója. Akkor is változatlan marad, ha a laboratórium javítja az adott sort, ezért használd ezt upsert művelethez.plannederedmény eseténnull.biomarker_nameéscategory— a mért anyag és annak csoportosítása (pl. Vitaminok, Hormonok).lab_code— a laborkód (a cső vonalkódja), amely alatt az eredményt benyújtották; a rendelés egyik laborkódja.nullegyplannederedmény esetén, valamint azoknál az eredményeknél, amelyeket a laboratórium kód nélkül jelentett.valueésvalue_operator— a tényleges mért érték. Az operátoreq(egyenlő) pontos értékeknél, vagylt/gt, ha a laboratórium a mérhető tartomány alatti vagy feletti értéket jelent.unit— a mértékegység (pl. ng/mL, µIU/mL).reference_range_lab— a laboratórium által ehhez az eredményhez megadott normál és optimális min/max határok, avalueskálájára átváltva. A laboratórium által nyitva hagyott határ értékenull, így egy egyoldalú tartomány, például a< 50,normal_min: null, normal_max: 50formában érkezik. Minden eredmény tartalmazza azt a tartományt, amelyhez képest mérték, így egy több vérvételből vagy laboratóriumból származó eredménnyel rendelkező páciens minden eredményhez a megfelelőt kapja meg.reference_range_lab_absent_reason— annak oka, hogy areference_range_labmiértnull.null, ha a tartomány jelen van, valamintplannederedmény esetén. Lásd: Ha nincs laboratóriumi tartomány.aniva_range— Az Aniva által összeállított összehasonlító értékek, avalueskáláján. Életkor, nem és terhességi hét szerint eltérnek. Anormal_*az általános tartomány. Azoptimal_*egy szűkebb tartomány. Az értékek csak tájékoztató jellegűek. Nem minősülnek orvosi tanácsnak, diagnózisnak vagy az eredmény értékelésének. Az Aniva nem állít be jelölést hozzájuk képest. Az eredmény irányadó értékeként areference_range_labmezőt használd.null, ha a kulcsod nem rendelkezik azaniva_ranges_viewscope-pal, vagy ha az Aniva nem rendelkezik értékekkel ehhez a biomarkerhez.tested_at— a vizsgálat elvégzésének dátuma.comment— a laboratórium szabad szöveges megjegyzése ehhez a konkrét eredményhez (pl. referenciatartományra vonatkozó útmutatás, mintaminőségi figyelmeztetések).null, ha a laboratórium nem csatolt ilyet.status_reason— miért kétséges egylikely_wrongeredmény, illetve miért használhatatlan egyfaultvagyundeliverableeredmény. Minden más állapot eseténnull. Eltér acommentmezőtől, amely a laboratórium saját megjegyzése, és hibás eredményeknél gyakran üres.origin— ki szolgáltatta a dokumentumot, amelyből az érték származik; ugyanazok az értékek, mint az alábbi dokumentumoriginmezőjénél. A feltöltött dokumentumból (member_upload,staff_upload,partner_upload) származó érték az Aniva fájlbeolvasásából ered, nem laborleletből: klinikai felhasználás előtt ellenőrizd a fájl alapján.plannederedmény eseténnull.lab_reported— a vizsgálatot végző laboratórium saját leletsora, szó szerint és átváltás nélkül. Lásd alább.
Aniva-tartományok
Azaniva_range az Aniva által publikált forrásokból és
saját válogatás alapján összeállított összehasonlító értékeket tartalmazza. A tartományok életkor, nem és terhességi hét szerint eltérnek.
A sources azokat a publikált forrásokat sorolja fel, amelyeket az Aniva az értékekhez rögzített. A lista üres is lehet.
A termékedre vonatkozó szabályok:
- Az Aniva-tartományt csak a laboratórium tartománya mellett jelenítsd meg, soha ne helyette.
- Ha az Aniva-tartományból jelölést, figyelmeztetést vagy ajánlást vezetsz le, azt a saját nevedben és saját felelősségedre teszed.
- Mindenhol jelenítsd meg az Anivával kötött megállapodásodban szereplő tájékoztatót, ahol az Aniva-tartományt megjeleníted.
aniva_ranges_view scope-ot a kulcsodhoz. Az értékek előzetes értesítés nélkül változhatnak.
Normalizált értékek a laboratórium saját sorával szemben
Avalue, a unit és a reference_range_lab normalizált: minden mérést átváltunk a biomarker kanonikus mértékegységére, és a saját biomarkernév alatt jelentjük, így ugyanaz az analit összehasonlítható a különböző laboratóriumok között és az idő múlásával is. Erre van szükséged a trendek követéséhez és a laboratóriumok közötti összehasonlításhoz, ez azonban nem az, amit az eredményeket áttekintő orvos a laboratórium PDF-jében lát — a 48 U/l (40 - 129) formában nyomtatott alkalikus foszfatáz 0.8 µkat/L értékként érkezik hozzád.
A lab_reported emellett tartalmazza ezt a nyomtatott sort: a laboratórium analitnevét és -kódját, az értéket és a mértékegységet nyomtatott formában, a referenciatartományt szövegként (< 50, > 55, 40 - 129) és a laboratórium saját, átváltatlan határaiként is, továbbá az eltérésjelzőt, az eredmény állapotát és a megjegyzést.
A lab_reported mezőt akkor használd, amikor egy ember egyezteti az adataidat a laboratóriumi lelettel, a kanonikus mezőket pedig minden számított művelethez. Csak azok a mezők vannak kitöltve, amelyeket a laboratórium ténylegesen elküldött; a lab_reported objektumban semmi nincs kikövetkeztetve, alapértelmezetten kitöltve vagy átváltva, és a teljes objektum null, ha nincs nyers rekordunk az adott eredményhez.
Ha nincs laboratóriumi tartomány
Amikor areference_range_lab értéke null, a reference_range_lab_absent_reason megmutatja az okát:
Egyes laboratóriumok a referenciatartomány helyett célértéket vagy kockázati szintet nyomtatnak, például
Ziel: <200. >240 hoch vagy <5.7 neg >=6.5 pos. Ezek nem kerülnek be a reference_range_lab mezőbe, ezért annak
határai null értékűek, az ok pedig lab_text_only. A nyomtatott szöveget szó szerint jelenítsd meg.
Egy egyoldalú tartomány, például a < 20, tartománynak számít. A reference_range_lab mezőben egyik határával
null értékként érkezik, az ok pedig null. Megjelenítéskor hagyd nyitva a nyitott oldalt.
Klinikai eredmények állapotai
Genetikai eredmények
A genetikai eredmények a DNS-elemzésből származó génszintű leleteket jelentik. Minden eredmény egy adott génhez tartozik (pl. APOE, MTHFR), és tartalmazza az alábbiakat:id— a laboreredmény sorának azonosítója. Akkor is változatlan marad, ha a laboratórium javítja az adott sort, ezért használd ezt upsert művelethez.plannederedmény eseténnull.gene— a gén szimbóluma.lab_code— a laborkód (a cső vonalkódja), amely alatt az eredményt benyújtották.nullegyplannederedmény esetén, valamint azoknál az eredményeknél, amelyeket a laboratórium kód nélkül jelentett.genotype— a kimutatott genotípus (pl. E3/E4).clinical_significance— a lelet ACMG-alapú besorolása.risk_description— ember által olvasható magyarázat arról, hogy mit jelent a genotípus.comment— a laboratórium szabad szöveges megjegyzése ehhez a konkrét eredményhez.null, ha a laboratórium nem csatolt ilyet.status_reason— miért kétséges egylikely_wrongeredmény, illetve miért használhatatlan egyfaultvagyundeliverableeredmény. Minden más állapot eseténnull.origin— ki szolgáltatta a dokumentumot, amelyből az érték származik, ahogy a klinikai eredményeknél is.variants— a kimutatott konkrét genetikai variánsok, mindegyik SNV-szintű részletezéssel.
A klinikai jelentőség értékei
Genetikai eredmények státuszai
Variáns felépítése
Minden genetikai eredmény tartalmaz egyvariants tömböt. Minden variáns az alábbiakat tartalmazza:
name— közismert név (pl. APOE E4).clinical_significance— variánsszintű jelentőség (eltérhet a génszintű jelentőségtől).conditions— kapcsolódó betegségek/állapotok leírásokkal.snvs— az alapul szolgáló egynukleotidos variánsok, mindegyikrs_id,allele,reference_alleleés opcionális HGVS-jelöléssel.
Dokumentumok
Az eredményválaszdocuments tömbje a letölthető laborlelet-fájlokra mutató hivatkozásokat tartalmazza. Minden dokumentum a következőket tartalmazza:
id— egy fájl-UUID. Add át ezt aGET /api/v1/documents/{id}végpontnak a fájl letöltéséhez.file_name— a fájlnév, ugyanaz, amelyet a letöltés küld (pl.20260405 - Quade Befund - 7642001234.pdf).original_file_name— a fájlnév pontosan úgy, ahogyan a laboratórium vagy a feltöltő leadta (pl.7642001234_B0012_FA_E.pdf).origin— aki a fájlt beküldte:lab,member_upload,staff_uploadvagypartner_upload(te töltötted fel a Dokumentum feltöltése végponttal).content_type— a fájl médiatípusa (pl.application/pdf). A legtöbb lelet PDF. A feltöltött szkennelt dokumentumok képek vagy CSV-fájlok lehetnek.etag— a fájltartalom verziója; minden alkalommal változik, amikor a bájtok változnak. Tárold el, és csak akkor töltsd le újra, ha megváltozik. Ez a szabványos HTTP entity tag, ahogyan az S3 vagy a Google Cloud Storage is használja.size_bytes— a fájlméret bájtban.lab_code— a laborkód (csővonalkód), amelyhez a lelet tartozik;null, ha a laboratórium nem adott meg ilyet.
A dokumentumokhoz való hozzáférést a dokumentumot birtokló profil alapján ellenőrizzük.
Eredmények elküldése e-mailben az ügyfélnek
E-mailben értesítheted az ügyfelet arról, hogy az eredményei elkészültek. Hívd meg az Eredmények elküldése e-mailben végpontot egy időponthoz, vagy az Eredmények elküldése e-mailben végpontot egy otthoni tesztkészlet-rendeléshez. Minden hívás egy e-mailt küld. A hívások nincsenek deduplikálva.- Az e-mail a profil
emailcímére megy. A helykitöltő@aniva.emailcímet a rendszer elutasítja. - Az e-mail a profil elsődleges profilcsoportjának nevét és logóját jeleníti meg.
- Az e-mail nyelve a profil
languageértéke, alapértelmezés szerint angol. - Állítsd a
with_reportsmezőttrueértékre a laborleletek csatolásához. - Add meg a
notemezőt, hogy egy legfeljebb 1 000 karakteres személyes megjegyzés jelenjen meg az e-mailben.
409 kóddal és unsubscribed okkal
tér vissza. Az újbóli bekapcsoláshoz állítsd a transactional_emails_enabled mezőt true értékre a
Profil frissítése végponttal.
E-mailek az elkészült eredményekről
Kaphatsz e-mailt, amikor egy foglalás eredményei elkészültek. Adj meg legfeljebb 5 címet aresults_ready_emails mezőben az Időpont létrehozása vagy az
Otthoni tesztkészlet-rendelés létrehozása hívásban. A listát később az
Időpont frissítése vagy az
Otthoni tesztkészlet-rendelés frissítése végponttal módosíthatod; a [] kikapcsolja az e-maileket.
- Kérd tőlünk alapértelmezett e-mail-címek beállítását a profilcsoportodhoz. A
results_ready_emailsnélkül létrehozott foglalások ezeket kapják meg. Egy megadott lista felülírja őket az adott foglalásnál, ezért vedd fel az alapértelmezett e-mail-címedet is, ha meg akarod tartani. A[]nem küld e-mailt. - Minden cím egy e-mailt kap, amint a foglalás összes laboreredménye véglegessé válik.
- Az eredmények véglegesítése után hozzáadott cím azonnal megkapja az e-mailt.
- Az e-mail az Aniva adminfelületének eredményoldalára mutat. Az ügyfél nem kapja meg.
- A kulcsodnak
results_viewhozzáférésre van szüksége a pácienshez. Enélkül a kérés403kóddal tér vissza.
Eredmények megjelenítése az alkalmazásodban
A Beágyazási munkamenet létrehozása egy egyszer használatos URL-t ad vissza egy csak olvasható eredményoldalhoz. Nyisd meg az alkalmazásod WebView nézetében, hogy a páciens bejelentkezés nélkül láthassa az eredményeket.- A kulcsodnak szüksége van az
embedés aresults_viewscope-ra a pácienshez. Kérd az Anivától azembedscope-ot. - Hívd meg a szerveredről minden alkalommal, amikor a páciens megnyitja az eredményeket. Az URL egyszer és 5 percig működik, ezután az oldal egy 60 perces munkamenetet tart fenn.
- A
routemegnyitja az általunk közzétett oldalak egyikét: a biomarkerlistát, egy biomarkert vagy a 3D Twint. - Az
appearancebeállítja a témát, a gombok és linkek színét, valamint azt, hogy megjelenjen-e a logód. - A
reportegyetlen időpontra, egyetlen otthoni tesztkészlet-rendelésre vagy egy általad aPOST /api/v1/documentsvégponttal feltöltött laborleletre korlátozza az oldalt. A páciens ekkor csak annak a leletnek az eredményeit látja. - Az oldal csak laboreredményeket jelenít meg, akárcsak ez az API. Nem jelenít meg fájlokat, chatet vagy beállításokat.