GET /api/v1/appointments/{id}/results en bevatten klinische biomarkerresultaten, genetische biomarkerresultaten en downloadbare labrapporten.
Status van resultaten
Hetstatus-veld op het hoogste niveau van de resultatenrespons geeft de algehele verwerkingsvoortgang aan:
Afzonderlijke resultaten binnen de respons hebben hun eigen status per resultaat (zie hieronder), zodat je al deelresultaten kunt tonen terwijl de algehele status nog
in_progress is.
Abonneer je op webhooks om te weten wanneer resultaten veranderen. appointment.results.updated wordt geactiveerd bij elke wijziging van de resultatenbody en appointment.results.completed wordt geactiveerd wanneer de status op het hoogste niveau naar completed gaat. Bestellingen voor thuistestkits sturen dezelfde events met het voorvoegsel home_kit_order.. Elk event bevat de URL om de resultaten op te halen. Je kunt dit endpoint nog steeds pollen om te synchroniseren.
De submissions-array splitst de status op het hoogste niveau op per laboratoriumaanvraag. Een bloedafname die meerdere buisjes of meerdere laboratoria omvat, heeft meerdere vermeldingen, elk met de lab_code (buisbarcode) waaronder deze is ingediend en een eigen status in_progress / completed / fault. Een fault-vermelding is door het lab afgewezen of stopgezet en zal nooit rapporteren: het monster is vaak naar een ander laboratorium verplaatst, dat vervolgens zijn eigen vermelding aanmaakt. De status op het hoogste niveau is completed wanneer elke vermelding is afgesloten en minstens één heeft gerapporteerd. Elk ontvangen resultaat en elk document heeft dezelfde lab_code, zodat je kunt zien uit welk buisje een waarde komt.
Klinische resultaten
Klinische resultaten zijn standaard metingen van bloedbiomarkers — zoals vitamine D-waarden, cholesterol, schildklierhormonen enzovoort. Elk klinisch resultaat bevat:id— de identifier van de labresultaatrij. Deze blijft hetzelfde wanneer het lab die rij corrigeert, dus gebruik deze om te upserten.nullvoor eenplanned-resultaat.biomarker_nameencategory— wat er is gemeten en de categorie (bijv. Vitamines, Hormonen).lab_code— de labcode (buisbarcode) waaronder het resultaat is ingediend, een van de labcodes van de bestelling.nullvoor eenplanned-resultaat en voor resultaten die het lab zonder code heeft gerapporteerd.valueenvalue_operator— de daadwerkelijke meting. De operator iseq(gelijk aan) voor exacte waarden, oflt/gtwanneer het lab een waarde onder of boven het meetbare bereik rapporteert.unit— de meeteenheid (bijv. ng/mL, µIU/mL).reference_range_lab— normale en optimale min/max-grenzen zoals gerapporteerd door het lab voor dit resultaat, omgerekend naar dezelfde schaal alsvalue. Een grens die het lab openlaat isnull, dus een eenzijdig interval zoals< 50komt binnen alsnormal_min: null, normal_max: 50. Elk resultaat bevat het interval waartegen het is gemeten, zodat een patiënt met resultaten van meerdere bloedafnames of labs per resultaat het juiste interval krijgt.reference_range_lab_absent_reason— waaromreference_range_labnullis.nullwanneer het bereik aanwezig is, en bij eenplanned-resultaat. Zie Wanneer er geen labbereik is.aniva_range— Vergelijkingswaarden die Aniva heeft samengesteld, op dezelfde schaal alsvalue. Ze verschillen per leeftijd, geslacht en zwangerschapsweek.normal_*is het algemene bereik.optimal_*is een smaller bereik. De waarden zijn uitsluitend ter informatie. Ze zijn geen medisch advies, geen diagnose en geen beoordeling van het resultaat. Aniva plaatst er geen markering bij. Gebruikreference_range_labals norm voor het resultaat.nullwanneer je sleutel de scopeaniva_ranges_viewniet heeft, of wanneer Aniva geen waarden voor deze biomarker heeft.tested_at— de datum waarop de test is uitgevoerd.comment— vrije-tekstopmerking van het lab bij dit specifieke resultaat (bijv. toelichting op het referentiebereik, waarschuwingen over de monsterkwaliteit).nullwanneer het lab er geen heeft toegevoegd.status_reason— waarom eenlikely_wrong-resultaat twijfelachtig is, of eenfault- ofundeliverable-resultaat onbruikbaar is.nullvoor elke andere status. Anders dancomment, wat de eigen opmerking van het lab is en bij foutieve resultaten vaak leeg is.origin— wie het document heeft aangeleverd waaruit de waarde afkomstig is, dezelfde waarden als het documentveldoriginhieronder. Een waarde uit een geüpload document (member_upload,staff_upload,partner_upload) is afkomstig van Aniva die het bestand uitleest, niet van een labrapport: controleer deze met het bestand voor klinisch gebruik.nullvoor eenplanned-resultaat.lab_reported— de eigen rapportregel van het uitvoerende lab, letterlijk en niet omgerekend. Zie hieronder.
Aniva-bereiken
aniva_range bevat vergelijkingswaarden die Aniva heeft samengesteld uit gepubliceerde bronnen en
eigen selectie. De bereiken verschillen per leeftijd, geslacht en zwangerschapsweek.
sources vermeldt de gepubliceerde bronnen die Aniva voor de waarden heeft vastgelegd. De lijst kan leeg zijn.
Regels voor je product:
- Toon het Aniva-bereik alleen naast het bereik van het laboratorium, nooit in plaats daarvan.
- Als je een markering, een waarschuwing of een aanbeveling afleidt uit het Aniva-bereik, doe je dit uit eigen naam en op eigen verantwoordelijkheid.
- Toon de melding uit je overeenkomst met Aniva overal waar je het Aniva-bereik toont.
aniva_ranges_view toe aan je sleutel. De waarden kunnen zonder voorafgaande kennisgeving veranderen.
Genormaliseerde waarden versus de eigen regel van het lab
value, unit en reference_range_lab zijn genormaliseerd: we rekenen elke meting om naar de canonieke eenheid van de biomarker en rapporteren deze onder onze eigen biomarkernaam, zodat dezelfde analyt vergelijkbaar is tussen labs en door de tijd heen. Dat is wat je wilt voor trends en voor vergelijking tussen labs, en het is niet wat een beoordelende arts ziet op de pdf van het lab — alkalische fosfatase afgedrukt als 48 U/l (40 - 129) bereikt je als 0.8 µkat/L.
lab_reported bevat die afgedrukte regel daarnaast: de analytnaam en -code van het lab, de waarde en eenheid zoals afgedrukt, het referentie-interval zowel als tekst (< 50, > 55, 40 - 129) als de eigen niet-omgerekende grenzen van het lab, plus de afwijkingsmarkering, resultaatstatus en opmerking.
Gebruik lab_reported wanneer iemand je gegevens vergelijkt met het labrapport, en de canonieke velden voor alles wat wordt berekend. Alleen velden die het lab daadwerkelijk heeft verzonden zijn gevuld; niets in lab_reported is afgeleid, standaard ingesteld of omgerekend, en het hele object is null wanneer we geen ruwe gegevens voor een resultaat hebben.
Wanneer er geen labbereik is
Wanneerreference_range_lab null is, laat reference_range_lab_absent_reason je zien waarom:
Sommige labs drukken een streefwaarde of een risicocategorie af in plaats van een referentiebereik, bijvoorbeeld
Ziel: <200. >240 hoch of <5.7 neg >=6.5 pos. Deze komen niet in reference_range_lab, dus de
grenzen ervan zijn null en de reden is lab_text_only. Toon de afgedrukte tekst letterlijk.
Een eenzijdig bereik zoals < 20 is wel een bereik. Het komt binnen in reference_range_lab met één grens op
null en de reden is null. Houd de open kant open wanneer je het toont.
Statussen van klinische resultaten
Genetische resultaten
Genetische resultaten zijn bevindingen op genniveau uit DNA-analyse. Elk resultaat hoort bij een gen (bijv. APOE, MTHFR) en bevat:id— de identifier van de labresultaatrij. Deze blijft hetzelfde wanneer het lab die rij corrigeert, dus gebruik deze om te upserten.nullvoor eenplanned-resultaat.gene— het gensymbool.lab_code— de labcode (buisbarcode) waaronder het resultaat is ingediend.nullvoor eenplanned-resultaat en voor resultaten die het lab zonder code heeft gerapporteerd.genotype— het gedetecteerde genotype (bijv. E3/E4).clinical_significance— een op ACMG gebaseerde classificatie van de bevinding.risk_description— een leesbare uitleg van wat het genotype betekent.comment— vrije-tekstopmerking van het lab bij dit specifieke resultaat.nullwanneer het lab er geen heeft toegevoegd.status_reason— waarom eenlikely_wrong-resultaat twijfelachtig is, of eenfault- ofundeliverable-resultaat onbruikbaar is.nullvoor elke andere status.origin— wie het document heeft aangeleverd waaruit de waarde afkomstig is, net als bij klinische resultaten.variants— de specifieke gedetecteerde genetische varianten, elk met details op SNV-niveau.
Waarden voor klinische significantie
Statussen van genetische resultaten
Structuur van varianten
Elk genetisch resultaat bevat eenvariants-array. Elke variant bevat:
name— gangbare naam (bijv. APOE E4).clinical_significance— klinische betekenis op variantniveau (kan afwijken van de betekenis op genniveau).conditions— bijbehorende ziekten/aandoeningen met beschrijvingen.snvs— de onderliggende single-nucleotidevarianten, elk metrs_id,allele,reference_alleleen optionele HGVS-notatie.
Documenten
Dedocuments-array in de resultatenrespons bevat verwijzingen naar downloadbare labrapportbestanden. Elk document heeft:
id— een bestands-UUID. Geef deze door aanGET /api/v1/documents/{id}om het bestand te downloaden.file_name— de bestandsnaam, dezelfde die de download meestuurt (bijv.20260405 - Quade Befund - 7642001234.pdf).original_file_name— de bestandsnaam precies zoals het lab of de uploader die heeft aangeleverd (bijv.7642001234_B0012_FA_E.pdf).origin— wie het bestand heeft aangeleverd:lab,member_upload,staff_uploadofpartner_upload(je hebt het geüpload met Document uploaden).content_type— het mediatype van het bestand (bijv.application/pdf). De meeste rapporten zijn pdf’s. Geüploade scans kunnen afbeeldingen of csv-bestanden zijn.etag— de versie van de bestandsinhoud; deze verandert zodra de bytes veranderen. Sla deze op en download alleen opnieuw als deze verandert. Dit is de standaard HTTP entity tag, zoals gebruikt door S3 of Google Cloud Storage.size_bytes— de bestandsgrootte in bytes.lab_code— de labcode (buisbarcode) waarbij het rapport hoort;nullals het lab er geen heeft opgegeven.
Toegang tot documenten wordt gecontroleerd aan de hand van het profiel dat eigenaar is van het document.
Resultaten naar de klant e-mailen
Je kunt de klant per e-mail laten weten dat de resultaten klaarstaan. Roep Resultaten e-mailen aan voor een afspraak, of Resultaten e-mailen voor een thuistestkitbestelling. Elke aanroep verstuurt één e-mail. Aanroepen worden niet gededupliceerd.- De e-mail gaat naar de
emailvan het profiel. Een placeholder-adres met@aniva.emailwordt geweigerd. - De e-mail toont de naam en het logo van de primaire profielgroep van het profiel.
- De e-mail is in de
languagevan het profiel, standaard Engels. - Zet
with_reportsoptrueom de labrapporten bij te voegen. - Voeg
notetoe om een persoonlijke notitie in de e-mail te tonen, maximaal 1.000 tekens.
409 terug met de reden
unsubscribed. Om ze weer in te schakelen, stel je transactional_emails_enabled in op true met
Profiel bijwerken.
E-mails zodra resultaten klaarstaan
Je kunt een e-mail ontvangen wanneer de resultaten van een boeking klaarstaan. Stelresults_ready_emails in op maximaal 5
adressen bij Afspraak aanmaken of
Thuistestkitbestelling aanmaken. Wijzig de lijst later met
Afspraak bijwerken of
Thuistestkitbestelling bijwerken; [] schakelt de e-mails uit.
- Vraag ons om standaard e-mailadressen voor jouw profielgroep in te stellen. Een boeking die zonder
results_ready_emailswordt aangemaakt, krijgt deze adressen. Een lijst vervangt ze voor die boeking, dus neem je standaard e-mailadres op om het te behouden.[]verstuurt geen e-mail. - Elk adres ontvangt één e-mail zodra elk labresultaat van de boeking definitief is.
- Een adres dat wordt toegevoegd nadat de resultaten definitief zijn, ontvangt de e-mail direct.
- De e-mail linkt naar de resultatenpagina in het Aniva-beheerpaneel. De klant ontvangt deze niet.
- Je sleutel heeft
results_view-toegang tot de patiënt nodig. Zonder die toegang geeft het verzoek403terug.
Resultaten tonen in je app
Embed-sessie aanmaken geeft een eenmalige URL terug voor een alleen-lezen resultatenpagina. Open deze in een WebView van je app, zodat de patiënt de resultaten ziet zonder in te loggen.- Je sleutel heeft de scopes
embedenresults_viewnodig voor de patiënt. Vraag Aniva om deembed-scope. - Roep dit vanaf je server aan telkens wanneer de patiënt de resultaten opent. De URL werkt één keer en is 5 minuten geldig, waarna de pagina een sessie van 60 minuten aanhoudt.
routeopent een van de pagina’s die we beschikbaar stellen: de biomarkerlijst, één biomarker of de 3D Twin.appearancestelt het thema in, de kleur van knoppen en links, en of je logo wordt getoond.reportbeperkt de pagina tot één afspraak, één thuistestkitbestelling of één labrapport dat je hebt geüpload metPOST /api/v1/documents. De patiënt ziet dan alleen de resultaten van dat rapport.- De pagina toont alleen labresultaten, net als deze API. Er worden geen bestanden, geen chat en geen instellingen getoond.