GET /api/v1/appointments/{id}/results, ja ne sisältävät kliiniset biomarkkeritulokset, geneettiset biomarkkeritulokset ja ladattavat laboratorioraportit.
Tulosten tila
Tulosvastauksen ylätasonstatus-kenttä kertoo käsittelyn yleisen etenemisen:
Yksittäisillä tuloksilla on vastauksessa oma tuloskohtainen tilansa (katso alta), joten voit näyttää osittaisia tuloksia, kun yleinen tila on vielä
in_progress.
Saat tiedon tulosten muutoksista tilaamalla webhookit. appointment.results.updated laukeaa aina, kun tulosten sisältö muuttuu, ja appointment.results.completed laukeaa, kun ylätason tila vaihtuu tilaan completed. Kotitestipakkausten tilaukset lähettävät samat tapahtumat home_kit_order.-etuliitteellä. Jokainen tapahtuma sisältää haettavan tulosten URL-osoitteen. Voit silti kysellä tästä päätepisteestä tietojen täsmäyttämiseksi.
submissions-taulukko erittelee ylätason tilan laboratoriolähetteittäin. Verinäytteenotolla, joka jakautuu useaan putkeen tai useaan laboratorioon, on useita merkintöjä, joista jokaisella on lab_code (putken viivakoodi), jolla se on kirjattu, sekä oma tilansa (in_progress / completed / fault). fault-tilassa oleva merkintä on hylätty tai keskeytetty laboratoriossa eikä koskaan tuota tuloksia: näyte on usein siirretty toiseen laboratorioon, joka luo oman merkintänsä. Ylätason tila on completed, kun jokainen merkintä on suljettu ja vähintään yksi raportoi tuloksia. Jokainen vastaanotettu tulos ja dokumentti sisältää saman lab_code-tunnisteen, joten näet, mistä putkesta arvo on peräisin.
Kliiniset tulokset
Kliiniset tulokset edustavat tavallisia veren biomarkkerimittauksia — esimerkiksi D-vitamiinitasoja, kolesterolia, kilpirauhashormoneja ja vastaavia. Jokainen kliininen tulos sisältää:id— laboratoriotulosrivin tunniste. Se pysyy samana, kun laboratorio korjaa kyseisen rivin, joten käytä sitä upsert-toimintoon.null, kun tulos on tilassaplanned.biomarker_namejacategory— mitä mitattiin ja mihin ryhmään se kuuluu (esim. vitamiinit, hormonit).lab_code— laboratoriokoodi (putken viivakoodi), jolla tulos on kirjattu, yksi tilauksen laboratoriokoodeista.null, kun tulos on tilassaplannedtai laboratorio on raportoinut sen ilman koodia.valuejavalue_operator— varsinainen mittausarvo. Operaattori oneq(yhtä suuri kuin) tarkoille arvoille, tailt/gt, kun laboratorio raportoi arvon mittausalueen ala- tai yläpuolelta.unit— mittayksikkö (esim. ng/mL, µIU/mL).reference_range_lab— laboratorion tälle tulokselle raportoimat normaalit ja optimaaliset ala- ja ylärajat muunnettuna samalle asteikolle kuinvalue. Laboratorion avoimeksi jättämä raja onnull, joten toispuoleinen väli, kuten< 50, saapuu muodossanormal_min: null, normal_max: 50. Jokainen tulos sisältää viitealueen, johon sitä verrattiin, joten useiden verinäytteenottojen tai laboratorioiden tuloksissa jokaisella tuloksella on oikea alue.reference_range_lab_absent_reason— syy siihen, miksireference_range_labonnull.null, kun viitealue on olemassa sekäplanned-tuloksilla. Katso Kun laboratorion viitealuetta ei ole.aniva_range— Anivan kokoamat vertailuarvot samalla asteikolla kuinvalue. Ne vaihtelevat iän, sukupuolen ja raskausviikon mukaan.normal_*on yleinen alue.optimal_*on kapeampi alue. Arvot ovat vain tiedoksi. Ne eivät ole lääketieteellistä neuvontaa, diagnoosi eivätkä tuloksen arviointi. Aniva ei aseta niiden perusteella merkintöjä. Käytäreference_range_lab-kenttää tuloksen perustana.null, kun avaimellasi ei oleaniva_ranges_view-käyttöoikeutta tai Anivalla ei ole arvoja tälle biomarkkerille.tested_at— päivämäärä, jolloin testi suoritettiin.comment— laboratorion vapaamuotoinen huomautus tästä tuloksesta (esim. viitealueen ohjeistus, näytteen laatuun liittyvät varoitukset).null, kun laboratorio ei ole liittänyt huomautusta.status_reason— syy siihen, miksilikely_wrong-tulos on epäilyttävä tai miksifault- taiundeliverable-tulos on käyttökelvoton.nullkaikissa muissa tiloissa. Eroaacomment-kentästä, joka on laboratorion oma huomautus ja usein tyhjä virheellisissä tuloksissa.origin— kuka toimitti dokumentin, josta arvo on peräisin; samat arvot kuin dokumentinorigin-kentässä alla. Ladatusta dokumentista (member_upload,staff_upload,partner_upload) peräisin oleva arvo on Anivan tiedostosta lukema, ei laboratorioraportista: tarkista se tiedostosta ennen kliinistä käyttöä.null, kun tulos on tilassaplanned.lab_reported— analyysin tehneen laboratorion oma raporttirivi sanatarkasti ja muuntamattomana. Katso alta.
Aniva-alueet
aniva_range sisältää vertailuarvoja, jotka Aniva on koonnut julkaistuista lähteistä ja
omasta kuratoinnistaan. Alueet vaihtelevat iän, sukupuolen ja raskausviikon mukaan.
sources luettelee julkaistut lähteet, jotka Aniva on kirjannut arvoille. Lista voi olla tyhjä.
Säännöt tuotteellesi:
- Näytä Aniva-alue vain laboratorion alueen lisäksi, älä koskaan sen tilalla.
- Jos johdat Aniva-alueesta merkinnän, varoituksen tai suosituksen, teet sen omissa nimissäsi ja omalla vastuullasi.
- Näytä Anivan kanssa tekemäsi sopimuksen mukainen huomautus kaikkialla, missä näytät Aniva-alueen.
aniva_ranges_view-käyttöoikeuden avaimeesi. Arvot voivat muuttua ilman ennakkoilmoitusta.
Normalisoidut arvot verrattuna laboratorion omaan riviin
value, unit ja reference_range_lab on normalisoitu: muunnamme jokaisen mittauksen biomarkkerin kanoniseen yksikköön ja raportoimme sen omalla biomarkkerinimellämme, jotta sama analyytti on vertailukelpoinen eri laboratorioiden välillä ja ajan myötä. Tämä on tarpeen trendien seurantaan ja laboratorioiden väliseen vertailuun, eikä se ole sama kuin mitä tuloksia tarkasteleva lääkäri näkee laboratorion PDF-tiedostossa — muodossa 48 U/l (40 - 129) tulostettu alkalinen fosfataasi saapuu sinulle muodossa 0.8 µkat/L.
lab_reported sisältää kyseisen tulostetun rivin sen rinnalla: laboratorion analyyttinimen ja -koodin, arvon ja yksikön tulostetussa muodossa, viitealueen sekä tekstinä (< 50, > 55, 40 - 129) että laboratorion omina muuntamattomina rajoina, sekä poikkeavuusmerkinnän, tuloksen tilan ja huomautuksen.
Käytä lab_reported-kenttää, kun ihminen täsmäyttää tietojasi laboratorioraporttiin, ja kanonisia kenttiä kaikkeen laskentaan. Vain laboratorion tosiasiallisesti lähettämät kentät täytetään; mitään lab_reported-kentässä ei päätellä, täytetä oletusarvoilla tai muunneta, ja koko objekti on null, kun meillä ei ole raakatietoa tuloksesta.
Kun laboratorion viitealuetta ei ole
Kunreference_range_lab on null, reference_range_lab_absent_reason kertoo syyn:
Jotkin laboratoriot tulostavat viitealueen tilalle tavoitteen tai riskiluokan, esimerkiksi
Ziel: <200. >240 hoch tai <5.7 neg >=6.5 pos. Nämä eivät siirry reference_range_lab-kenttään, joten sen
rajat ovat null ja syy on lab_text_only. Näytä tulostettu teksti sellaisenaan.
Toispuoleinen alue, kuten < 20, on viitealue. Se saapuu reference_range_lab-kentässä toinen raja
null-arvona, ja syy on null. Pidä avoin puoli avoimena, kun näytät sen.
Kliinisten tulosten tilat
Geneettiset tulokset
Geneettiset tulokset edustavat DNA-analyysin geenitason löydöksiä. Jokainen tulos vastaa yhtä geeniä (esim. APOE, MTHFR) ja sisältää:id— laboratoriotulosrivin tunniste. Se pysyy samana, kun laboratorio korjaa kyseisen rivin, joten käytä sitä upsert-toimintoon.null, kun tulos on tilassaplanned.gene— geenin tunnus.lab_code— laboratoriokoodi (putken viivakoodi), jolla tulos on kirjattu.null, kun tulos on tilassaplannedtai laboratorio on raportoinut sen ilman koodia.genotype— havaittu genotyyppi (esim. E3/E4).clinical_significance— löydöksen ACMG-pohjainen luokittelu.risk_description— selkokielinen selitys siitä, mitä genotyyppi tarkoittaa.comment— laboratorion vapaamuotoinen huomautus tästä tuloksesta.null, kun laboratorio ei ole liittänyt huomautusta.status_reason— syy siihen, miksilikely_wrong-tulos on epäilyttävä tai miksifault- taiundeliverable-tulos on käyttökelvoton.nullkaikissa muissa tiloissa.origin— kuka toimitti dokumentin, josta arvo on peräisin, kuten kliinisissä tuloksissa.variants— havaitut geneettiset variantit, joista jokaisella on SNV-tason tiedot.
Kliinisen merkityksen arvot
Geenitulosten tilat
Variantin rakenne
Jokainen geenitulos sisältäävariants-taulukon. Jokainen variantti sisältää:
name— yleisnimi (esim. APOE E4).clinical_significance— varianttitason merkitys (voi poiketa geenitason merkityksestä).conditions— liittyvät sairaudet/tilat kuvauksineen.snvs— taustalla olevat yhden emäksen variantit, joista jokaisella onrs_id,allele,reference_alleleja valinnainen HGVS-merkintä.
Dokumentit
Tulosvastauksendocuments-taulukko sisältää viittaukset ladattaviin laboratorioraporttitiedostoihin. Jokaisella dokumentilla on:
id— tiedoston UUID. Välitä tämä pyynnölleGET /api/v1/documents/{id}tiedoston lataamiseksi.file_name— tiedostonimi, sama jonka lataus lähettää (esim.20260405 - Quade Befund - 7642001234.pdf).original_file_name— tiedostonimi täsmälleen siinä muodossa kuin laboratorio tai lataaja toimitti sen (esim.7642001234_B0012_FA_E.pdf).origin— kuka toimitti tiedoston:lab,member_upload,staff_uploadtaipartner_upload(latasit sen kutsulla Lataa dokumentti).content_type— tiedoston mediatyyppi (esim.application/pdf). Useimmat raportit ovat PDF-tiedostoja. Ladatut skannaukset voivat olla kuvia tai CSV-tiedostoja.etag— tiedoston sisällön versio; se muuttuu aina, kun tavut muuttuvat. Tallenna se ja lataa tiedosto uudelleen vain, kun se muuttuu. Se on standardin mukainen HTTP entity tag, jota käyttävät myös S3 ja Google Cloud Storage.size_bytes— tiedoston koko tavuina.lab_code— laboratoriokoodi (putken viivakoodi), johon raportti kuuluu;null, jos laboratorio ei ole merkinnyt koodia.
Pääsy dokumentteihin tarkistetaan dokumentin omistavan profiilin perusteella.
Tulosten lähettäminen asiakkaalle sähköpostitse
Voit ilmoittaa asiakkaalle sähköpostitse, että tulokset ovat valmiit. Kutsu Lähetä tulokset sähköpostitse ajanvaraukselle tai Lähetä tulokset sähköpostitse kotitestipakkaustilaukselle. Jokainen kutsu lähettää yhden sähköpostin. Kutsuja ei deduplikoida.- Sähköposti lähetetään profiilin
email-osoitteeseen. Paikkamerkkinä oleva@aniva.email-osoite hylätään. - Sähköpostissa näkyvät profiilin ensisijaisen profiiliryhmän nimi ja logo.
- Sähköposti on profiilin
language-kielellä, oletuksena englanniksi. - Aseta
with_reportsarvoontrue, jos haluat liittää laboratorioraportit. - Lisää
note, jos haluat näyttää sähköpostissa henkilökohtaisen viestin, enintään 1 000 merkkiä.
409 syyllä
unsubscribed. Ota ne uudelleen käyttöön asettamalla transactional_emails_enabled arvoon true kutsulla
Päivitä profiili.
Sähköpostit tulosten valmistumisesta
Voit saada sähköpostin, kun varauksen tulokset ovat valmiit. Asetaresults_ready_emails-kenttään enintään 5
osoitetta kutsussa Luo ajanvaraus tai
Luo kotitestipakkaustilaus. Muuta listaa myöhemmin kutsulla
Päivitä ajanvaraus tai
Päivitä kotitestipakkaustilaus; [] poistaa sähköpostit käytöstä.
- Pyydä meitä asettamaan profiiliryhmällesi oletussähköpostiosoitteet. Ilman
results_ready_emails-kenttää luotu varaus käyttää niitä. Lista korvaa ne kyseisessä varauksessa, joten sisällytä oletussähköpostiosoitteesi, jos haluat säilyttää sen.[]ei lähetä sähköpostia. - Jokainen osoite saa yhden sähköpostin, kun varauksen kaikki laboratoriotulokset ovat lopullisia.
- Tulosten valmistumisen jälkeen lisätty osoite saa sähköpostin heti.
- Sähköposti linkittää tulossivulle Anivan hallintapaneelissa. Asiakas ei saa sitä.
- Avaimesi tarvitsee potilaaseen
results_view-oikeuden. Ilman sitä pyyntö palauttaa koodin403.
Näytä tulokset sovelluksessasi
Luo upotusistunto palauttaa kertakäyttöisen URL-osoitteen vain luku -muotoiselle tulossivulle. Avaa se sovelluksesi WebView-näkymässä, jotta potilas näkee tulokset kirjautumatta sisään.- Avaimesi tarvitsee potilaalle
embed- jaresults_view-oikeudet. Pyydäembed-oikeutta Anivalta. - Kutsu sitä palvelimeltasi aina, kun potilas avaa tulokset. URL-osoite toimii kerran ja on voimassa 5 minuuttia, minkä jälkeen sivulla on 60 minuutin istunto.
routeavaa jonkin julkaisemistamme sivuista: biomarkkerilistan, yhden biomarkkerin tai 3D Twinin.appearancemäärittää teeman, painikkeiden ja linkkien värin sekä sen, näkyykö logosi.reportrajaa sivun yhteen ajanvaraukseen, yhteen kotitestipakkaustilaukseen tai yhteen laboratorioraporttiin, jonka latasit kutsullaPOST /api/v1/documents. Potilas näkee silloin vain kyseisen raportin tulokset.- Sivu näyttää tämän rajapinnan tavoin vain laboratoriotulokset. Se ei näytä tiedostoja, chattia eikä asetuksia.