Book blodprøver direkte i dit eget produkt

Én API-nøgle giver dig 45 endpoints, fra booking til laboratorieresultater

Aniva Partner API booker en blodprøvetagning på over 25 lokationer i Tyskland, tilføjer paneler til den tid og returnerer kliniske og genetiske resultater som JSON. Hver forespørgsel kræver én header, og base-URL'en er den samme i alle miljøer.

Hvornår du skal bruge Aniva

Brug Aniva, når dine kunder har brug for at få booket en blodprøve
Brug endpoints for tider til blodprøvetagning på klinik og endpoints for hjemmetestkit til et kit med posten.
Brug endpoints for resultater til kliniske rækker, genetiske rækker og PDF-rapporten.
Brug katalog-endpoints til at læse de biomarkører, paneler og enheder, Aniva sælger.
Brug de dokumenterede stier under https://anivahealth.com/api/v1/, og opfind ikke endpoints.
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Grundflowet er fire forespørgsler
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 endpoints er dokumenteret og live i dag

1

Autentificering kræver kun én request-header

v1

Hver sti starter med præfikset v1

25+

Tyske lokationer kan udføre blodprøvetagningen

Fire forespørgsler skaber en fungerende integration

Fire forespørgsler går fra booking til laboratorieresultater

Hver forespørgsel returnerer det ID, den næste har brug for, så en grundlæggende integration er på fire forespørgsler, før du tilføjer paneler, ombookinger eller kurerer.

Trin 01 · GET /locations

Du oplister de lokationer, din nøgle kan booke

Svaret giver dig hver adresse, åbningstiderne og tidszonen, så en kunde kun ser tider, der findes.

Tests
Trin 02 · POST /profiles

Du opretter en profil til kunden

En profil skal bruge et navn, en kønskode, en fødselsdato og din profile_group, som accepterer en UUID eller din egen slug.

Tests
Trin 03 · POST /appointments

Du booker tiden på et valgt tidspunkt

Bookingen kræver profil-id, lokations-id og en ISO 8601-tidsangivelse med offset eller Z-suffiks.

Tests
Trin 04 · POST /appointments/{id}/confirm

Du bekræfter blodprøvetagningen med stregkoden på kittet

Denne anmodning starter laboratorieordren og låser tiden, så ændr alle paneler, før du sender den.

Tests
POST /api/v1/appointments
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T12:30:00+02:00"
  }'
Funktion

Hver ressourcegruppe er én REST-samling

Du kan bestille en blodprøvetagning på en klinik eller et hjemmetestkit med posten. Begge kommer tilbage i samme format, så du kun behøver at skrive koden, der læser resultater, én gang.

Profiler · 4 endpoints

En profil er den person, du tester

Du slår en profil op via e-mail, opretter den under din profilgruppe og opdaterer demografiske data senere.

Tests
GET /profiles
PATCH /profiles/{id}
Tider · 15 endpoints

En tid omfatter panelerne og blodprøvetagningen

Femten endpoints dækker bookingen og enhver senere ændring af den, herunder paneler, forhåndsvisninger af prøvebeholdere og bekræftelsen.

Tests
POST /appointments
GET /appointments/{id}/results
Bestillinger af hjemmetestkit · 10 endpoints

Bestillinger af hjemmetestkit er postversionen

Ti endpoints anmoder om et gør-det-selv-kit til en profil, ændrer dens paneler og returnerer den samme resultatstruktur.

Tests
Opret en kitbestilling
Få resultater
Lokationer · 2 endpoints

Lokationer viser dig, hvor en blodprøvetagning finder sted

Du læser de lokationer, din nøgle kan booke, og beder derefter en af dem om dens bookbare starttidspunkter.

Tests
GET /locations
GET /locations/{id}/availability
Dokumenter · 1 endpoint

Resultaterne kommer tilbage som kliniske og genetiske rækker

Hver ordretype har sit eget kald til resultater, og PDF-rapporten er en separat download via fil-ID.

Tests
GET /appointments/{id}/results
GET /documents/{id}
Forsendelser · 8 endpoints

En kurer bringer prøven til laboratoriet

Du opretter en kurerbestilling med et afhentningsvindue på en hverdag, tilknytter derefter tider og følger statusopdateringerne.

Tests
POST /shipments
Tilknyt tider
Kataloger · 4 endpoints

Kataloger viser de biomarkører, du kan bestille

Katalogerne over biomarkører, paneler og enheder er opdelt i sider, og du kan filtrere biomarkører efter teststed.

Tests
GET /biomarkers
GET /panels
Sundhed · 1 endpoint

Ét readiness-endpoint kræver ingen API-nøgle

Readiness-proben kræver ingen API-nøgle, så din oppetidsovervågning kan kalde den efter en fast tidsplan.

Tests
Offentligt parathedstjek
Dit arbejde slutter ved stregkodebekræftelsen

Laboratorieprocessen starter, når du bekræfter blodprøvetagningen

Du sender os stregkoden på kittet, og det er det sidste, vi har brug for fra dig. Derefter organiserer vi beholderne, kureren og laboratoriet, så din kode kun kalder to endpoints, indtil rapporten er klar.

The Aniva lab pipeline from confirmation to results Confirming the draw is followed by container selection, courier collection and laboratory analysis, and each biomarker row then reads as planned, received or fault. POST /appointments/{id}/confirmYou confirm the draw GET /appointments/{id}/previewContainers are known POST /shipmentsA courier collects it Aniva laboratory networkThe laboratory analyses planned received fault GET /appointments/{id}/results
En udfyldt prik er den vej, du ønsker.En ring er en tilstand, du stadig skal håndtere.Orange linjer er den bekræftede ordre.
Én parser læser en blodprøvetagning på klinik og et hjemmetestkit

Hvert resultat har to referenceintervaller og fire statusser

Hver klinisk række indeholder det interval, som laboratoriet har rapporteret, samt Aniva-intervallet med sit optimale vindue, så du kan vise begge dele uden at vedligeholde din egen opslagstabel.

En række står som planlagt, før laboratoriet analyserer den.
En række viser modtaget, så snart en værdi og en enhed kommer tilbage.
En række viser fault, når laboratoriet har annulleret bestillingen, og status_reason forklarer det.
GET /api/v1/appointments/{id}/results
{
  "status": "in_progress",
  "clinical_results": [{
    "status": "received",
    "biomarker_name": "Vitamin D",
    "value": 38.5, "unit": "ng/mL",
    "reference_range_lab": { "normal_min": 30, "normal_max": 100 },
    "reference_range_aniva": { "optimal_min": 40, "optimal_max": 60 },
    "tested_at": "2026-04-05"
  }],
  "documents": [{ "file_name": "lab-report-2026-04-05.pdf" }]
}
API'et bruger tre tidsformater

Dato- og tidsangivelser skal have en tidszone, ellers fejler forespørgslen

En naiv datetime afvises med 400, hvilket er den ene fejl, de fleste første integrationer begår.

Tidsstempler returneres altid som UTC efter ISO 8601 med Z-suffikset.
Input skal indeholde en eksplicit tidsforskydning, så en booking accepterer 2026-05-15T12:30:00+02:00.
Forsendelsesopdateringer bevarer den tidsforskydning, som logistikudbyderen rapporterede.
Kalenderfelter angiver kun lokal tid, såsom en fødselsdato.
Aniva udsteder og roterer hver partnernøgle

Hver forespørgsel kræver din partner-API-nøgle

Autentificering bruger x-api-key-headeren ved hvert kald, og en manglende eller roteret nøgle returnerer 403 med en kort JSON-fejl.

Din nøgle afgør, hvilke lokationer, tider og forsendelser du kan se.
Eksponér aldrig din API-nøgle i klientkode eller offentlige repositories.
En offentlig probe kræver ingen API-nøgle

Du kan følge alle tjenester på statussiden

Statussiden viser den aktuelle status og 90 dages historik for hver tjeneste, og de samme data er tilgængelige som JSON til din egen overvågning.

Partnernøgler udstedes af vores team

Bed os om en partnernøgle i dag

Fortæl os, hvilke markeder du sælger på, og hvilke paneler du har brug for, så sender vi en nøgle med de rette tilladelser.

Du kan også downloade OpenAPI-filen

Denne side er en designskitse. Hvert endpoint og hver payload på siden er hentet fra docs.anivahealth.com, og pipelinediagrammet er illustrativt.

Maskinlæsbare kopier af dokumentationen findes på docs.anivahealth.com/llms.txt og docs.anivahealth.com/llms-full.txt.