Boka blodprov direkt i din egen produkt

En API-nyckel ger dig 45 ändpunkter, från bokning till labbresultat

Aniva Partner API bokar en blodprovstagning på över 25 platser i Tyskland, lägger till paneler till den bokningen och returnerar kliniska och genetiska resultat som JSON. Varje anrop kräver en header och bas-URL:en är densamma i alla miljöer.

När du ska använda Aniva

Använd Aniva när dina kunder behöver boka ett blodprov
Använd slutpunkterna för bokning vid blodprovstagning på klinik och slutpunkterna för hemtestkit vid kit via post.
Använd resultat-endpoints för kliniska rader, genetiska rader och PDF-rapporten.
Använd katalogens endpoints för att läsa de biomarkörer, paneler och enheter Aniva säljer.
Använd de dokumenterade sökvägarna under https://anivahealth.com/api/v1/ och hitta inte på egna 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"
  }'
Grundflödet består av fyra anrop
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 endpoints är dokumenterade och aktiva idag

1

Autentisering kräver bara en request header

v1

Varje sökväg börjar med prefixet v1

25+

Tyska platser kan utföra blodprovstagningen

Fyra anrop ger en fungerande integration

Fyra anrop går från bokning till labbresultat

Varje anrop returnerar det ID som nästa anrop behöver, så en grundläggande integration består av fyra anrop innan du lägger till paneler, ombokningar eller bud.

Steg 01 · GET /locations

Du listar platserna som din nyckel kan boka

Svaret ger dig varje adress, öppettiderna och tidszonen, så att kunden bara ser tider som faktiskt finns.

Tester
Steg 02 · POST /profiles

Du skapar en profil för kunden

En profil behöver ett namn, en könskod, ett födelsedatum och din profile_group, som accepterar ett UUID eller din egen slug.

Tester
Steg 03 · POST /appointments

Du gör bokningen på en vald tid

Bokningen behöver profil-ID, plats-ID och datum och tid i ISO 8601-format med tidsförskjutning eller Z-suffix.

Tester
Steg 04 · POST /appointments/{id}/confirm

Du bekräftar blodprovstagningen med streckkoden på kitet

Den här begäran startar beställningen till labbet och låser bokningen, så ändra alla paneler innan du skickar den.

Tester
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"
  }'
Kapacitet

Varje resursgrupp är en REST-samling

Du kan beställa en blodprovstagning på en klinik eller ett hemtestkit med posten. Båda kommer tillbaka i samma format, så du skriver bara koden som läser resultat en gång.

Profiler · 4 endpoints

En profil är personen du testar

Du söker upp en profil via e-post, skapar den under din profilgrupp och uppdaterar demografiuppgifter senare.

Tester
GET /profiles
PATCH /profiles/{id}
Bokningar · 15 endpoints

En bokning innehåller panelerna och blodprovstagningen

Femton endpoints täcker bokningen och varje senare ändring av den, inklusive paneler, förhandsgranskningar av provbehållare och bekräftelsen.

Tester
POST /appointments
GET /appointments/{id}/results
Beställningar av hemtestkit · 10 endpoints

Beställningar av hemtestkit är postversionen

Tio endpoints begär ett hemtestkit för en profil, ändrar dess paneler och returnerar samma resultatstruktur.

Tester
Skapa en kitbeställning
Få resultat
Platser · 2 endpoints

Platser visar var en blodprovstagning sker

Du läser in de platser din nyckel kan boka och ber sedan en av dem om dess bokningsbara starttider.

Tester
GET /locations
GET /locations/{id}/availability
Dokument · 1 endpoint

Resultaten kommer tillbaka som kliniska och genetiska rader

Varje ordertyp har ett eget resultatanrop, och PDF-rapporten är en separat nedladdning via fil-ID.

Tester
GET /appointments/{id}/results
GET /documents/{id}
Försändelser · 8 endpoints

En kurir tar provet till laboratoriet

Du skapar en budbeställning med ett upphämtningsfönster på en vardag, kopplar bokningar till den och följer dess statusuppdateringar.

Tester
POST /shipments
Koppla bokningar
Kataloger · 4 endpoints

Kataloger listar de biomarkörer du kan beställa

Katalogerna för biomarkörer, paneler och enheter är paginerade, och du kan filtrera biomarkörer efter testplats.

Tester
GET /biomarkers
GET /panels
Hälsa · 1 slutpunkt

En readiness-endpoint behöver ingen API-nyckel

Readiness-proben behöver ingen API-nyckel, så din drifttidsövervakning kan anropa den enligt schema.

Tester
Offentlig beredskapskontroll
Ditt arbete slutar vid streckkodsbekräftelsen

Labbprocessen startar när du bekräftar blodprovstagningen

Du skickar kitets streckkod till oss, och det är det sista vi behöver från dig. Sedan ordnar vi behållarna, budet och laboratoriet, så din kod anropar bara två slutpunkter tills rapporten är 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 fylld punkt är vägen du vill ta.En ring är ett läge du fortfarande hanterar.Orange linjer är den bekräftade beställningen.
En parser läser både blodprovstagning på klinik och hemtestkit

Varje resultat har två referensintervall och fyra statusar

Varje klinisk rad innehåller intervallet som laboratoriet rapporterat och Anivas intervall med dess optimala spann, så att du kan visa båda utan att hålla en egen uppslagstabell.

En rad visar planerad innan laboratoriet analyserar den.
En rad visar mottagen så snart ett värde och en enhet kommer tillbaka.
En rad visar fault när laboratoriet har avbrutit beställningen, och status_reason förklarar varför.
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 använder tre tidsformat

Datum och tid kräver en tidszon, annars misslyckas förfrågan

En naiv datetime avvisas med 400, vilket är det enskilda misstag de flesta gör vid första integrationen.

Tidsstämplar returneras alltid som UTC, enligt ISO 8601 med suffixet Z.
Indata måste innehålla en uttrycklig tidsförskjutning, så en bokning godtar 2026-05-15T12:30:00+02:00.
Leveransuppdateringar behåller den tidsförskjutning som logistikleverantören rapporterade.
Kalenderfält avser bara lokal tid, till exempel födelsedatum.
Aniva utfärdar och roterar varje partnernyckel

Varje anrop kräver din partner-API-nyckel

Autentisering använder headern x-api-key vid varje anrop, och en saknad eller roterad nyckel returnerar 403 med ett kort JSON-fel.

Din nyckel avgör vilka platser, bokningar och leveranser du kan se.
Exponera aldrig din API-nyckel i klientkod eller publika repositories.
En publik förfrågan kräver ingen API-nyckel

Du kan följa varje tjänst på statussidan

Statussidan visar aktuellt läge och 90 dagars historik för varje tjänst, och samma data finns som JSON för din egen övervakning.

Partnernycklar utfärdas av vårt team

Be oss om en partnernyckel i dag

Berätta vilka marknader du säljer på och vilka paneler du behöver, så skickar vi en nyckel med rätt behörigheter.

Du kan också ladda ner OpenAPI-filen

Den här sidan är en designskiss. Varje endpoint och payload på sidan kommer från docs.anivahealth.com, och pipelinediagrammet är illustrativt.

Maskinläsbara kopior av dokumentationen finns på docs.anivahealth.com/llms.txt och docs.anivahealth.com/llms-full.txt.