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 lauksstatus 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.nullrezultātam ar statusuplanned.biomarker_nameuncategory— 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.nullrezultātam ar statusuplannedun rezultātiem, kurus laboratorija sniedza bez koda.valueunvalue_operator— faktiskais mērījums. Operators ireq(vienāds) precīzām vērtībām vailt/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, irnull, 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ēcreference_range_labirnull.null, ja intervāls ir norādīts, kā arī rezultātam ar statusuplanned. 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 izmantoreference_range_lab.null, ja tavai atslēgai navaniva_ranges_viewtvē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ēclikely_wrongrezultāts ir apšaubāms vaifaultvaiundeliverablerezultāts nav izmantojams.nullvisiem pārējiem statusiem. Atšķiras nocomment, 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 laukamoriginzemā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.nullrezultātam ar statusuplanned.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.
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.
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
Kadreference_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
Ģ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.nullrezultātam ar statusuplanned.gene— gēna simbols.lab_code— laboratorijas kods (stobriņa svītrkods), ar kuru rezultāts tika reģistrēts.nullrezultātam ar statusuplannedun 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ēclikely_wrongrezultāts ir apšaubāms vaifaultvaiundeliverablerezultāts nav izmantojams.nullvisiem 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īvuvariants. 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 arrs_id,allele,reference_alleleun neobligātu HGVS pierakstu.
Dokumenti
Rezultātu atbildes masīvsdocuments 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_uploadvaipartner_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
emailadresi. Aizstājēja@aniva.emailadrese tiek noraidīta. - E-pastā redzams profila galvenās profilu grupas nosaukums un logotips.
- E-pasts ir profila
languagevalodā, pēc noklusējuma angļu valodā. - Iestati
with_reportsvērtībutrue, lai pievienotu laboratorijas pārskatus. - Pievieno
note, lai e-pastā parādītu personisku piezīmi līdz 1 000 rakstzīmēm.
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_viewpiekļ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
embedunresults_viewpilnvaras pacientam. Pieprasi Anivaembedpilnvaru. - 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.
routeatver kādu no mūsu pieejamajām lapām: biomarķieru sarakstu, vienu biomarķieri vai 3D Twin.appearanceiestata motīvu, pogu un saišu krāsu, kā arī to, vai tiek rādīts tavs logotips.reportierobež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 arPOST /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.