Siirry pääsisältöön
Kun verinäytteenotto on vahvistettu ja laboratorio on käsitellyt näytteet, tulokset tulevat saataville ajanvaraukseen. Tulokset haetaan osoitteesta GET /api/v1/appointments/{id}/results, ja ne sisältävät kliiniset biomarkkeritulokset, geneettiset biomarkkeritulokset ja ladattavat laboratorioraportit.

Tulosten tila

Tulosvastauksen ylätason status-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 tilassa planned.
  • biomarker_name ja category — 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 tilassa planned tai laboratorio on raportoinut sen ilman koodia.
  • value ja value_operator — varsinainen mittausarvo. Operaattori on eq (yhtä suuri kuin) tarkoille arvoille, tai lt/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 kuin value. Laboratorion avoimeksi jättämä raja on null, joten toispuoleinen väli, kuten < 50, saapuu muodossa normal_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, miksi reference_range_lab on null. null, kun viitealue on olemassa sekä planned-tuloksilla. Katso Kun laboratorion viitealuetta ei ole.
  • aniva_range — Anivan kokoamat vertailuarvot samalla asteikolla kuin value. 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 ole aniva_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, miksi likely_wrong-tulos on epäilyttävä tai miksi fault- tai undeliverable-tulos on käyttökelvoton. null kaikissa muissa tiloissa. Eroaa comment-kentästä, joka on laboratorion oma huomautus ja usein tyhjä virheellisissä tuloksissa.
  • origin — kuka toimitti dokumentin, josta arvo on peräisin; samat arvot kuin dokumentin origin-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 tilassa planned.
  • 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ä.
Arvot ovat yleistä tietoa. Ne eivät ole lääketieteellistä neuvontaa, diagnoosi, lääketieteellinen löydös eivätkä tuloksen arviointi. Aniva ei tarjoa niitä lääkinnällisenä laitteena. Aniva ei vertaa tulosta niihin eikä aseta niiden perusteella merkintöjä. reference_range_lab ja lääkärin arvio pysyvät tuloksen perustana.
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.
Saadaksesi käyttöoikeuden allekirjoita lyhyt sopimus Aniva-alueista. Lisäämme sen jälkeen 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

Kun reference_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

Kun näytät tuloksia potilaille, käytä value-kenttää suoraan — se sisältää jo korjatun arvon, kun sellainen on olemassa.
Älä koskaan esitä fault-tilassa olevaa tulosta löydöksenä — sen value-kentässä on arvo, mutta se on vahvistetusti virheellinen.

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 tilassa planned.
  • gene — geenin tunnus.
  • lab_code — laboratoriokoodi (putken viivakoodi), jolla tulos on kirjattu. null, kun tulos on tilassa planned tai 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, miksi likely_wrong-tulos on epäilyttävä tai miksi fault- tai undeliverable-tulos on käyttökelvoton. null kaikissa 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 on rs_id, allele, reference_allele ja valinnainen HGVS-merkintä.

Dokumentit

Tulosvastauksen documents-taulukko sisältää viittaukset ladattaviin laboratorioraporttitiedostoihin. Jokaisella dokumentilla on:
  • id — tiedoston UUID. Välitä tämä pyynnölle GET /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_upload tai partner_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_reports arvoon true, jos haluat liittää laboratorioraportit.
  • Lisää note, jos haluat näyttää sähköpostissa henkilökohtaisen viestin, enintään 1 000 merkkiä.
Jos profiili on poistanut tapahtumasähköpostit käytöstä, kutsu palauttaa koodin 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. Aseta results_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 koodin 403.

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- ja results_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.
  • route avaa jonkin julkaisemistamme sivuista: biomarkkerilistan, yhden biomarkkerin tai 3D Twinin.
  • appearance määrittää teeman, painikkeiden ja linkkien värin sekä sen, näkyykö logosi.
  • report rajaa sivun yhteen ajanvaraukseen, yhteen kotitestipakkaustilaukseen tai yhteen laboratorioraporttiin, jonka latasit kutsulla POST /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.

Esimerkki tulosvastauksesta