Naar hoofdinhoud gaan
Nadat een bloedafname is bevestigd en het lab de monsters heeft verwerkt, worden de resultaten beschikbaar op de afspraak. Resultaten worden opgehaald via GET /api/v1/appointments/{id}/results en bevatten klinische biomarkerresultaten, genetische biomarkerresultaten en downloadbare labrapporten.

Status van resultaten

Het status-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. null voor een planned-resultaat.
  • biomarker_name en category — 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. null voor een planned-resultaat en voor resultaten die het lab zonder code heeft gerapporteerd.
  • value en value_operator — de daadwerkelijke meting. De operator is eq (gelijk aan) voor exacte waarden, of lt/gt wanneer 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 als value. Een grens die het lab openlaat is null, dus een eenzijdig interval zoals < 50 komt binnen als normal_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 — waarom reference_range_lab null is. null wanneer het bereik aanwezig is, en bij een planned-resultaat. Zie Wanneer er geen labbereik is.
  • aniva_range — Vergelijkingswaarden die Aniva heeft samengesteld, op dezelfde schaal als value. 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. Gebruik reference_range_lab als norm voor het resultaat. null wanneer je sleutel de scope aniva_ranges_view niet 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). null wanneer het lab er geen heeft toegevoegd.
  • status_reason — waarom een likely_wrong-resultaat twijfelachtig is, of een fault- of undeliverable-resultaat onbruikbaar is. null voor elke andere status. Anders dan comment, 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 documentveld origin hieronder. 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. null voor een planned-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.
De waarden zijn algemene informatie. Ze zijn geen medisch advies, geen diagnose, geen medische bevinding en geen beoordeling van een resultaat. Aniva biedt ze niet aan als medisch hulpmiddel. Aniva vergelijkt een resultaat er niet mee en plaatst er geen markering bij. reference_range_lab en de beoordeling door een arts blijven de norm voor een resultaat.
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.
Onderteken de korte overeenkomst voor Aniva-bereiken om toegang te krijgen. We voegen dan de scope 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

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

Gebruik bij het tonen van resultaten aan patiënten direct het veld value — dit bevat al de gecorrigeerde waarde wanneer die bestaat.
Presenteer een fault-resultaat nooit als bevinding — de value is ingevuld, maar is bevestigd onjuist.

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. null voor een planned-resultaat.
  • gene — het gensymbool.
  • lab_code — de labcode (buisbarcode) waaronder het resultaat is ingediend. null voor een planned-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. null wanneer het lab er geen heeft toegevoegd.
  • status_reason — waarom een likely_wrong-resultaat twijfelachtig is, of een fault- of undeliverable-resultaat onbruikbaar is. null voor 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 een variants-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 met rs_id, allele, reference_allele en optionele HGVS-notatie.

Documenten

De documents-array in de resultatenrespons bevat verwijzingen naar downloadbare labrapportbestanden. Elk document heeft:
  • id — een bestands-UUID. Geef deze door aan GET /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_upload of partner_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; null als 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 email van het profiel. Een placeholder-adres met @aniva.email wordt geweigerd.
  • De e-mail toont de naam en het logo van de primaire profielgroep van het profiel.
  • De e-mail is in de language van het profiel, standaard Engels.
  • Zet with_reports op true om de labrapporten bij te voegen.
  • Voeg note toe om een persoonlijke notitie in de e-mail te tonen, maximaal 1.000 tekens.
Als het profiel transactionele e-mails heeft uitgeschakeld, geeft de aanroep 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. Stel results_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_emails wordt 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 verzoek 403 terug.

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 embed en results_view nodig voor de patiënt. Vraag Aniva om de embed-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.
  • route opent een van de pagina’s die we beschikbaar stellen: de biomarkerlijst, één biomarker of de 3D Twin.
  • appearance stelt het thema in, de kleur van knoppen en links, en of je logo wordt getoond.
  • report beperkt de pagina tot één afspraak, één thuistestkitbestelling of één labrapport dat je hebt geüpload met POST /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.

Voorbeeld van een resultatenrespons