Pāriet uz galveno saturu
Kad asins paņemšana ir apstiprināta un laboratorija ir apstrādājusi paraugus, pierakstā kļūst pieejami rezultāti. Rezultātus iegūst ar GET /api/v1/appointments/{id}/results, un tie ietver klīnisko biomarķieru rezultātus, ģenētisko biomarķieru rezultātus un lejupielādējamus laboratorijas pārskatu dokumentus.

Rezultātu statuss

Augstākā līmeņa lauks status rezultātu atbildē norāda kopējo apstrādes gaitu: Atsevišķiem rezultātiem atbildē ir savs statuss (skatīt zemāk), tāpēc vari rādīt daļējus rezultātus, kamēr kopējais statuss vēl ir in_progress. Lai uzzinātu, kad rezultāti mainās, abonē webhook paziņojumus. appointment.results.updated nostrādā pie katras rezultātu satura izmaiņas, un appointment.results.completed nostrādā, kad augstākā līmeņa statuss pāriet uz completed. Mājas testa komplektu pasūtījumi sūta tos pašus notikumus ar prefiksu home_kit_order.. Katrā notikumā ir iekļauts rezultātu URL, no kura tos izgūt. Joprojām vari periodiski vaicāt šo galapunktu, lai saskaņotu datus. Masīvs submissions sadala augstākā līmeņa statusu pa laboratorijas nosūtījumiem. Asins paņemšanai, kas aptver vairākus stobriņus vai vairākas laboratorijas, ir vairāki ieraksti — katrs ar savu lab_code (stobriņa svītrkodu), ar kuru tas reģistrēts, un savu statusu in_progress / completed / fault. Ieraksts ar statusu fault laboratorijā tika noraidīts vai pārtraukts un nekad nesniegs rezultātus: paraugs bieži tika pārvietots uz citu laboratoriju, kas pēc tam izveido savu ierakstu. Augstākā līmeņa statuss ir completed, kad visi ieraksti ir noslēgti un vismaz viens ir sniedzis rezultātus. Katram saņemtajam rezultātam un katram dokumentam ir tas pats lab_code, tāpēc vari noteikt, no kura stobriņa vērtība nāk.

Klīniskie rezultāti

Klīniskie rezultāti ir standarta asins biomarķieru mērījumi — piemēram, D vitamīna līmenis, holesterīns, vairogdziedzera hormoni un citi. Katrs klīniskais rezultāts ietver:
  • id — laboratorijas rezultāta rindas identifikators. Tas nemainās, kad laboratorija labo šo rindu, tāpēc izmanto to upsert darbībām. null rezultātam ar statusu planned.
  • biomarker_name un category — kas tika mērīts un tā grupa (piem., Vitamīni, Hormoni).
  • lab_code — laboratorijas kods (stobriņa svītrkods), ar kuru rezultāts tika reģistrēts — viens no pasūtījuma laboratorijas kodiem. null rezultātam ar statusu planned un rezultātiem, kurus laboratorija sniedza bez koda.
  • value un value_operator — faktiskais mērījums. Operators ir eq (vienāds) precīzām vērtībām vai lt/gt, kad laboratorija ziņo par vērtību zem vai virs izmērāmā diapazona.
  • unit — mērvienība (piem., ng/mL, µIU/mL).
  • reference_range_lab — laboratorijas norādītās normas un optimālās min./maks. robežas šim rezultātam, pārrēķinātas tajā pašā skalā kā value. Robeža, ko laboratorija atstāj atvērtu, ir null, tāpēc vienpusējs intervāls, piemēram, < 50, tiek saņemts kā normal_min: null, normal_max: 50. Katram rezultātam ir pievienots intervāls, pret kuru tas tika mērīts, tāpēc pacients ar rezultātiem no vairākām asins paņemšanām vai laboratorijām katram rezultātam saņem pareizo intervālu.
  • reference_range_lab_absent_reason — kāpēc reference_range_lab ir null. null, ja intervāls ir norādīts, kā arī rezultātam ar statusu planned. Skatīt Kad nav laboratorijas intervāla.
  • aniva_range — Aniva apkopotās salīdzinājuma vērtības tajā pašā skalā kā value. Tās atšķiras atkarībā no vecuma, dzimuma un grūtniecības nedēļas. normal_* ir vispārīgais intervāls. optimal_* ir šaurāks intervāls. Vērtības ir paredzētas tikai informācijai. Tās nav medicīnisks padoms, nav diagnoze un nav rezultāta novērtējums. Aniva pret tām neiestata nekādas atzīmes. Kā rezultāta standartu izmanto reference_range_lab. null, ja tavai atslēgai nav aniva_ranges_view tvēruma vai ja Aniva nav vērtību šim biomarķierim.
  • tested_at — datums, kad analīze tika veikta.
  • comment — laboratorijas brīva teksta piezīme par šo konkrēto rezultātu (piem., norādes par references intervālu, brīdinājumi par parauga kvalitāti). null, ja laboratorija piezīmi nav pievienojusi.
  • status_reason — kāpēc likely_wrong rezultāts ir apšaubāms vai fault vai undeliverable rezultāts nav izmantojams. null visiem pārējiem statusiem. Atšķiras no comment, kas ir pašas laboratorijas piezīme un kļūdainiem rezultātiem bieži ir tukša.
  • origin — kas piegādāja dokumentu, no kura nāk vērtība; tās pašas vērtības kā dokumenta laukam origin zemāk. Vērtība no augšupielādēta dokumenta (member_upload, staff_upload, partner_upload) rodas, Aniva nolasot failu, nevis no laboratorijas pārskata: pirms klīniskas izmantošanas salīdzini to ar failu. null rezultātam ar statusu planned.
  • lab_reported — izpildītājlaboratorijas pārskata rinda burtiski un bez pārrēķināšanas. Skatīt zemāk.

Aniva intervāli

aniva_range satur salīdzinājuma vērtības, ko Aniva apkopojusi no publicētiem avotiem un savas atlases. Intervāli atšķiras atkarībā no vecuma, dzimuma un grūtniecības nedēļas. sources uzskaita publicētos avotus, ko Aniva reģistrējusi šīm vērtībām. Saraksts var būt tukšs.
Šīs vērtības ir vispārīga informācija. Tās nav medicīnisks padoms, nav diagnoze, nav medicīnisks slēdziens un nav rezultāta novērtējums. Aniva tās nenodrošina kā medicīnas ierīci. Aniva nesalīdzina rezultātu ar tām un pret tām neiestata nekādas atzīmes. reference_range_lab un ārsta novērtējums paliek rezultāta standarts.
Noteikumi tavam produktam:
  • Rādi Aniva intervālu tikai papildus laboratorijas intervālam, nekad tā vietā.
  • Ja no Aniva intervāla atvasini atzīmi, brīdinājumu vai ieteikumu, tu to dari savā vārdā un uz savu atbildību.
  • Rādi paziņojumu no sava līguma ar Aniva visur, kur rādi Aniva intervālu.
Lai iegūtu piekļuvi, paraksti īso vienošanos par Aniva intervāliem. Pēc tam mēs tavai atslēgai pievienojam aniva_ranges_view tvērumu. Vērtības var mainīties bez iepriekšēja brīdinājuma.

Normalizētās vērtības salīdzinājumā ar laboratorijas oriģinālo rindu

value, unit un reference_range_lab ir normalizēti: mēs pārrēķinām katru mērījumu biomarķiera kanoniskajā mērvienībā un sniedzam to ar mūsu pašu biomarķiera nosaukumu, lai viens un tas pats analīts būtu salīdzināms dažādās laboratorijās un laika gaitā. Tas ir tieši tas, kas tev nepieciešams tendenču izsekošanai un salīdzināšanai starp laboratorijām, un tas nav tas, ko redz ārsts, pārskatot laboratorijas PDF — sārmainā fosfatāze, kas izdrukāta kā 48 U/l (40 - 129), pie tevis nonāk kā 0.8 µkat/L. lab_reported līdztekus ietver šo izdrukāto rindu: laboratorijas analīta nosaukumu un kodu, vērtību un mērvienību tieši tā, kā tās izdrukātas, references intervālu gan kā tekstu (< 50, > 55, 40 - 129), gan kā pašas laboratorijas nepārrēķinātās robežas, kā arī tās novirzes atzīmi, rezultāta statusu un piezīmi. Izmanto lab_reported, kad cilvēks salīdzina tavus datus ar laboratorijas pārskatu, un kanoniskos laukus visiem aprēķiniem. Tiek aizpildīti tikai tie lauki, kurus laboratorija faktiski nosūtīja; nekas laukā lab_reported netiek secināts, aizstāts ar noklusējuma vērtību vai pārrēķināts, un viss objekts ir null, ja mums par rezultātu nav sākotnējā ieraksta.

Kad nav laboratorijas intervāla

Kad reference_range_lab ir null, reference_range_lab_absent_reason paskaidro iemeslu: Dažas laboratorijas references intervāla vietā drukā mērķvērtību vai riska līmeni, piemēram, Ziel: <200. >240 hoch vai <5.7 neg >=6.5 pos. Tie nenonāk laukā reference_range_lab, tāpēc tā robežas ir null un iemesls ir lab_text_only. Rādi izdrukāto tekstu burtiski. Vienpusējs intervāls, piemēram, < 20, ir intervāls. Tas nonāk laukā reference_range_lab ar vienu robežu null, un iemesls ir null. Rādot to, atstāj atvērto pusi atvērtu.

Klīnisko rezultātu statusi

Rādot rezultātus pacientiem, izmanto tieši lauku value — tas jau atspoguļo laboto vērtību, ja tāda ir.
Nekad neattēlo fault rezultātu kā slēdzienu — tā value ir aizpildīts, taču apstiprināts kā kļūdains.

Ģenētiskie rezultāti

Ģenētiskie rezultāti ir gēnu līmeņa atradumi no DNS analīzes. Katrs rezultāts atbilst vienam gēnam (piem., APOE, MTHFR) un ietver:
  • id — laboratorijas rezultāta rindas identifikators. Tas nemainās, kad laboratorija labo šo rindu, tāpēc izmanto to upsert darbībām. null rezultātam ar statusu planned.
  • gene — gēna simbols.
  • lab_code — laboratorijas kods (stobriņa svītrkods), ar kuru rezultāts tika reģistrēts. null rezultātam ar statusu planned un rezultātiem, kurus laboratorija sniedza bez koda.
  • genotype — konstatētais genotips (piem., E3/E4).
  • clinical_significance — uz ACMG balstīta atraduma klasifikācija.
  • risk_description — cilvēkam lasāms skaidrojums par to, ko genotips nozīmē.
  • comment — laboratorijas brīva teksta piezīme par šo konkrēto rezultātu. null, ja laboratorija piezīmi nav pievienojusi.
  • status_reason — kāpēc likely_wrong rezultāts ir apšaubāms vai fault vai undeliverable rezultāts nav izmantojams. null visiem pārējiem statusiem.
  • origin — kas piegādāja dokumentu, no kura nāk vērtība, tāpat kā klīniskajiem rezultātiem.
  • variants — konkrētie konstatētie ģenētiskie varianti, katrs ar SNV līmeņa informāciju.

Klīniskās nozīmes vērtības

Ģenētisko rezultātu statusi

Varianta struktūra

Katrs ģenētiskais rezultāts satur masīvu variants. Katrs variants ietver:
  • name — parastais nosaukums (piemēram, APOE E4).
  • clinical_significance — varianta līmeņa nozīme (var atšķirties no gēna līmeņa nozīmes).
  • conditions — saistītās slimības/stāvokļi ar aprakstiem.
  • snvs — pamatā esošie viena nukleotīda varianti, katrs ar rs_id, allele, reference_allele un neobligātu HGVS pierakstu.

Dokumenti

Rezultātu atbildes masīvs documents satur atsauces uz lejupielādējamiem laboratorijas pārskatu failiem. Katram dokumentam ir:
  • id — faila UUID. Norādi to pieprasījumā GET /api/v1/documents/{id}, lai lejupielādētu failu.
  • file_name — faila nosaukums, tas pats, ko nosūta lejupielāde (piemēram, 20260405 - Quade Befund - 7642001234.pdf).
  • original_file_name — faila nosaukums tieši tāds, kādu to piegādāja laboratorija vai augšupielādētājs (piemēram, 7642001234_B0012_FA_E.pdf).
  • origin — kas piegādāja failu: lab, member_upload, staff_upload vai partner_upload (tu to augšupielādēji ar Augšupielādēt dokumentu).
  • content_type — faila mediju tips (piemēram, application/pdf). Lielākā daļa pārskatu ir PDF formātā. Augšupielādētie skenējumi var būt attēli vai CSV faili.
  • etag — faila satura versija; tā mainās ikreiz, kad mainās baiti. Saglabā to un lejupielādē vēlreiz tikai tad, kad tā mainās. Tas ir standarta HTTP vienības tags, kādu izmanto S3 vai Google Cloud Storage.
  • size_bytes — faila izmērs baitos.
  • lab_code — laboratorijas kods (mēģenes svītrkods), kuram pieder pārskats; null, ja laboratorija tādu nav norādījusi.
Piekļuve dokumentiem tiek pārbaudīta attiecībā pret profilu, kuram dokuments pieder.

Rezultātu nosūtīšana klientam e-pastā

Tu vari paziņot klientam e-pastā, ka viņa rezultāti ir gatavi. Izsauc Nosūtīt rezultātus e-pastā pierakstam vai Nosūtīt rezultātus e-pastā mājas testa komplekta pasūtījumam. Katrs izsaukums nosūta vienu e-pastu. Izsaukumi netiek deduplicēti.
  • E-pasts tiek nosūtīts uz profila email adresi. Aizstājēja @aniva.email adrese tiek noraidīta.
  • E-pastā redzams profila galvenās profilu grupas nosaukums un logotips.
  • E-pasts ir profila language valodā, pēc noklusējuma angļu valodā.
  • Iestati with_reports vērtību true, lai pievienotu laboratorijas pārskatus.
  • Pievieno note, lai e-pastā parādītu personisku piezīmi līdz 1 000 rakstzīmēm.
Ja profils ir izslēdzis darījumu e-pastus, izsaukums atgriež 409 ar iemeslu unsubscribed. Lai tos atkal ieslēgtu, iestati transactional_emails_enabled uz true, izmantojot Atjaunināt profilu.

E-pasti par gataviem rezultātiem

Tu vari saņemt e-pastu, kad rezervācijas rezultāti ir gatavi. Norādi līdz 5 adresēm laukā results_ready_emails, izsaucot Izveidot pierakstu vai Izveidot mājas testa komplekta pasūtījumu. Vēlāk maini sarakstu ar Atjaunināt pierakstu vai Atjaunināt mājas testa komplekta pasūtījumu; [] izslēdz e-pastus.
  • Palūdz mums iestatīt noklusējuma e-pasta adreses tavai profilu grupai. Rezervācija, kas izveidota bez results_ready_emails, saņems tās. Saraksts aizstāj tās attiecīgajai rezervācijai, tāpēc iekļauj savu noklusējuma e-pasta adresi, lai to saglabātu. [] nenosūta nevienu e-pastu.
  • Katra adrese saņem vienu e-pastu, tiklīdz visi rezervācijas laboratorijas rezultāti ir galīgi.
  • Adrese, kas pievienota pēc tam, kad rezultāti ir galīgi, saņem e-pastu uzreiz.
  • E-pastā ir saite uz rezultātu lapu Aniva administratora panelī. Klients to nesaņem.
  • Tavai atslēgai nepieciešama results_view piekļuve pacientam. Bez tās pieprasījums atgriež 403.

Rezultātu rādīšana tavā lietotnē

Izveidot iegulto sesiju atgriež vienreizēju URL tikai lasāmai rezultātu lapai. Atver to savas lietotnes WebView, lai pacients redzētu rezultātus bez pieteikšanās.
  • Tavai atslēgai nepieciešamas embed un results_view pilnvaras pacientam. Pieprasi Aniva embed pilnvaru.
  • Izsauc to no sava servera ikreiz, kad pacients atver rezultātus. URL darbojas vienu reizi un 5 minūtes, un pēc tam lapa uztur 60 minūšu sesiju.
  • route atver kādu no mūsu pieejamajām lapām: biomarķieru sarakstu, vienu biomarķieri vai 3D Twin.
  • appearance iestata motīvu, pogu un saišu krāsu, kā arī to, vai tiek rādīts tavs logotips.
  • report ierobežo lapu līdz vienam pierakstam, vienam mājas testa komplekta pasūtījumam vai vienam laboratorijas pārskatam, ko tu augšupielādēji ar POST /api/v1/documents. Tad pacients redz tikai tā pārskata rezultātus.
  • Lapa rāda tikai laboratorijas rezultātus, tāpat kā šī API. Tajā netiek rādīti faili, čats vai iestatījumi.

Rezultātu atbildes piemērs