Ugrás a fő tartalomhoz
Miután a vérvételt megerősítették és a laboratórium feldolgozta a mintákat, az eredmények elérhetővé válnak az időpontnál. Az eredmények a 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. planned eredmény esetén null.
  • biomarker_name és category — 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. null egy planned eredmény esetén, valamint azoknál az eredményeknél, amelyeket a laboratórium kód nélkül jelentett.
  • value és value_operator — a tényleges mért érték. Az operátor eq (egyenlő) pontos értékeknél, vagy lt/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, a value skálájára átváltva. A laboratórium által nyitva hagyott határ értéke null, így egy egyoldalú tartomány, például a < 50, normal_min: null, normal_max: 50 formá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 a reference_range_lab miért null. null, ha a tartomány jelen van, valamint planned eredmény esetén. Lásd: Ha nincs laboratóriumi tartomány.
  • aniva_range — Az Aniva által összeállított összehasonlító értékek, a value skáláján. Életkor, nem és terhességi hét szerint eltérnek. A normal_* az általános tartomány. Az optimal_* 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 a reference_range_lab mezőt használd. null, ha a kulcsod nem rendelkezik az aniva_ranges_view scope-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 egy likely_wrong eredmény, illetve miért használhatatlan egy fault vagy undeliverable eredmény. Minden más állapot esetén null. Eltér a comment mező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 dokumentum origin mező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. planned eredmény esetén null.
  • 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

Az aniva_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.
Az értékek általános tájékoztatást nyújtanak. Nem minősülnek orvosi tanácsnak, diagnózisnak, orvosi leletnek és az eredmény értékelésének sem. Az Aniva nem orvostechnikai eszközként biztosítja őket. Az Aniva nem hasonlítja össze velük az eredményeket, és nem állít be jelölést hozzájuk képest. Az eredmények irányadó alapja továbbra is a reference_range_lab és az orvos értékelése.
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.
A hozzáféréshez írd alá az Aniva-tartományokról szóló rövid megállapodást. Ezután hozzáadjuk az 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

A value, 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 a reference_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

Amikor eredményeket jelenítesz meg a pácienseknek, használd közvetlenül a value mezőt — ez már a javított értéket tükrözi, ha létezik ilyen.
Soha ne jeleníts meg fault állapotú eredményt leletként — a value mezője ki van töltve, de igazoltan hibás.

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. planned eredmény esetén null.
  • gene — a gén szimbóluma.
  • lab_code — a laborkód (a cső vonalkódja), amely alatt az eredményt benyújtották. null egy planned eredmé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 egy likely_wrong eredmény, illetve miért használhatatlan egy fault vagy undeliverable eredmény. Minden más állapot esetén null.
  • 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 egy variants 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, mindegyik rs_id, allele, reference_allele és opcionális HGVS-jelöléssel.

Dokumentumok

Az eredményválasz documents 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 a GET /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_upload vagy partner_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 email címére megy. A helykitöltő @aniva.email cí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_reports mezőt true értékre a laborleletek csatolásához.
  • Add meg a note mezőt, hogy egy legfeljebb 1 000 karakteres személyes megjegyzés jelenjen meg az e-mailben.
Ha a profil kikapcsolta a tranzakciós e-maileket, a hívás 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 a results_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_emails né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_view hozzáférésre van szüksége a pácienshez. Enélkül a kérés 403 kó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 a results_view scope-ra a pácienshez. Kérd az Anivától az embed scope-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 route megnyitja az általunk közzétett oldalak egyikét: a biomarkerlistát, egy biomarkert vagy a 3D Twint.
  • Az appearance beállítja a témát, a gombok és linkek színét, valamint azt, hogy megjelenjen-e a logód.
  • A report egyetlen időpontra, egyetlen otthoni tesztkészlet-rendelésre vagy egy általad a POST /api/v1/documents vé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.

Példa eredményválaszra