Spring til hovedindhold
Aniva Partner API er et REST-API, der lader sundhedspartnere administrere patientprofiler, booke tider til blodprøvetagning på teststeder og udløse pipelines til laboratoriebestillinger. Du bruger API’et over HTTPS med din partner-API-nøgle.

Hvad du kan gøre

  • Profiladministration — Opret, hent og opdater demografiske patientprofiler.
  • Tidsbestilling — Book tider til blodprøvetagning på Anivas teststeder.
  • Paneladministration — Tilføj eller fjern laboratorietestpaneler på en eksisterende tid.
  • Enkelte biomarkører — Tilknyt eller fjern enkelte biomarkører på en tid uden at vælge et panel.
  • Bestillinger af hjemmetestkit — Send et hjemmetestkit med posten til en patient, spor pakkerne, og rapporter, hvornår prøven blev taget.
  • Panelkatalog — Gennemse tilgængelige paneler med GET /api/v1/panels for at finde panel-ID’er og se, hvilke biomarkører der indgår.
  • Biomarkørkatalog — Gennemse de biomarkører, du kan bestille på et teststed eller i et hjemmetestkit, med GET /api/v1/biomarkers for at finde ID’er.
  • Bekræftelse af blodprøvetagning — Indsend laboratoriekode(r) efter en blodprøvetagning for at udløse pipelinen til laboratoriebestillinger.
  • Laboratorieresultater — Hent kliniske og genetiske resultater, og download laboratorierapporter som PDF.
  • Oversigt over teststeder — Vis tilgængelige teststeder, du kan præsentere for patienter.
  • Forsendelseslogistik — Opret, spor, rediger og annuller kurerforsendelser.
  • Webhooks — Modtag et HTTPS-kald, når en tid, en bestilling af et hjemmetestkit, dens resultater, et teststed, en profil eller en forsendelse ændrer sig. Se Webhooks.

Udforsk dokumentationen

Autentificering

Autentificer forespørgsler med din partner-API-nøgle.

Hurtig start

Lav dit første API-kald på få minutter med trin-for-trin-eksempler.

Profiler

Lær, hvordan patientprofiler fungerer, og hvilke data de indeholder.

Tider

Forstå livscyklussen for en tid fra booking til bekræftelse.

Bestillinger af hjemmetestkit

Send et testkit hjem til en patient, og følg det, indtil prøven når frem til laboratoriet.

API-versionering

Den aktuelle API-version er v1. Alle endpoints starter med præfikset /api/v1/. Basis-URL’en er https://anivahealth.com.
Ikke-bagudkompatible ændringer introduceres under et nyt versionspræfiks. v1-API’et forbliver tilgængeligt, og eventuelle udfasninger varsles på forhånd.

Datoer og tidszoner

Alle tidspunkter i overførslen er UTC ISO 8601 (Z-suffiks). Rene kalenderfelter bruger lokale dato- og tidsdele (YYYY-MM-DD, HH:MM). Særlige bemærkninger:
  • Inputs, der tager dato og tid (f.eks. scheduled_at på POST / PATCH /api/v1/appointments), skal indeholde en tidszoneangivelse — enten Z eller en eksplicit tidsforskydning som +02:00. Dato- og tidsangivelser uden tidszone afvises med 400. Begge former angiver det samme tidspunkt, og svaret returnerer altid scheduled_at i UTC Z. Brug teststedets timezone-felt (eller en anden IANA-identifikator) til at formatere tidspunktet i lokal tid, når du viser det.
  • Inputs med lokal tid fortolkes i tidszonen for den ressource, de vedrører: datoer for ledighed bruger query-parameteren timezone (standard er teststedets tidszone); forsendelsens pickup_date / pickup_time_* fortolkes i afsendelsesstedets tidszone.
  • Svarfelter med kun dato (f.eks. tested_at, ledighedens availability[].date) er kalenderdatoer uden tidszone.

Få adgang

API-nøgler udstedes pr. partner af Aniva.
Kontakt Aniva for at få din partner-API-nøgle.