Rezervovat krevní testy přímo z vlastního produktu

Jeden API klíč ti dá 45 endpointů, od rezervace až po laboratorní výsledky

Aniva Partner API rezervuje odběr krve na více než 25 místech v Německu, přidá k tomuto termínu panely a vrátí klinické i genetické výsledky ve formátu JSON. Každý požadavek vyžaduje jednu hlavičku a základní URL je v každém prostředí stejná.

Kdy využít Aniva

Použij službu Aniva, když tvoji zákazníci potřebují rezervovat krevní test
Pro odběr krve na klinice použij endpointy pro termíny a pro sadu poštou endpointy pro domácí testovací sadu.
Pro klinické řádky, genetické řádky a PDF zprávu použij endpointy výsledků.
Použij katalogové endpointy k načtení biomarkerů, panelů a jednotek, které Aniva prodává.
Používej zdokumentované cesty pod https://anivahealth.com/api/v1/ a nevymýšlej si endpointy.
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"
  }'
Základní postup tvoří čtyři požadavky
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 endpointů je dnes zdokumentováno a v provozu

1

Autentizace potřebuje jen jednu hlavičku požadavku

v1

Každá cesta začíná předponou v1

25+

Pobočky v Německu mohou provést odběr krve

Čtyři požadavky vytvoří funkční integraci

Od rezervace k výsledkům z laboratoře vedou čtyři požadavky

Každý požadavek vrátí ID, které potřebuje ten další, takže základní integrace jsou čtyři požadavky, než přidáš panely, přeplánování nebo kurýry.

Krok 01 · GET /locations

Uvedeš místa, která může tvůj klíč rezervovat

Odpověď ti vrátí každou adresu, otevírací dobu i časové pásmo, takže zákazník vidí jen termíny, které skutečně existují.

Testy
Krok 02 · POST /profiles

Vytvoříš pro zákazníka profil

Profil potřebuje jméno, kód pohlaví, datum narození a tvoje profile_group, které přijímá UUID nebo tvůj vlastní slug.

Testy
Krok 03 · POST /appointments

Rezervuješ si termín ve zvoleném čase

Rezervace potřebuje ID profilu, ID místa a datum s časem ve formátu ISO 8601 včetně časového posunu nebo přípony Z.

Testy
Krok 04 · POST /appointments/{id}/confirm

Odběr krve potvrdíš čárovým kódem ze sady

Tento požadavek zahájí laboratorní objednávku a uzamkne termín, proto každý panel uprav před odesláním.

Testy
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"
  }'
Schopnost

Každá skupina zdrojů je jedna kolekce REST

Můžeš objednat odběr krve na klinice nebo domácí testovací sadu poštou. Obojí se vrátí ve stejném formátu, takže kód pro čtení výsledků napíšeš jen jednou.

Profily · 4 endpointy

Profil je osoba, kterou testuješ

Vyhledáš profil podle e-mailu, vytvoříš ho ve své skupině profilů a demografické údaje aktualizuješ později.

Testy
GET /profiles
PATCH /profiles/{id}
Termíny · 15 endpointů

Termín zahrnuje panely i odběr krve

Patnáct endpointů pokrývá rezervaci i každou její pozdější změnu, včetně panelů, náhledů odběrových nádobek a potvrzení.

Testy
POST /appointments
GET /appointments/{id}/results
Objednávky domácích testovacích sad · 10 endpointů

Objednávky domácích testovacích sad jsou poštovní verzí

Deset endpointů vyžádá pro profil domácí sadu, změní jeho panely a vrátí stejnou strukturu výsledku.

Testy
Vytvořit objednávku sady
Získat výsledky
Lokality · 2 endpointy

Lokality ti ukážou, kde probíhá odběr krve

Načteš místa, která tvůj klíč může rezervovat, a pak si u jednoho z nich vyžádáš začátky dostupných termínů.

Testy
GET /locations
GET /locations/{id}/availability
Dokumenty · 1 endpoint

Výsledky přicházejí jako klinické a genetické řádky

Každý typ objednávky má vlastní volání pro výsledky a PDF zpráva se stahuje zvlášť podle ID souboru.

Testy
GET /appointments/{id}/results
GET /documents/{id}
Zásilky · 8 endpointů

Kurýr odveze vzorek do laboratoře

Vytvoříš objednávku kurýra s časovým oknem pro vyzvednutí v pracovní den, pak připojíš termíny a sleduješ aktualizace stavu.

Testy
POST /shipments
Připojit termíny
Katalogy · 4 endpointy

Katalogy uvádějí biomarkery, které si můžeš objednat

Katalogy biomarkerů, panelů a jednotek jsou stránkované a biomarkery můžeš filtrovat podle místa testování.

Testy
GET /biomarkers
GET /panels
Zdraví · 1 endpoint

Jeden readiness endpoint nepotřebuje API klíč

Sonda připravenosti nepotřebuje API klíč, takže ji tvůj monitor dostupnosti může volat podle plánu.

Testy
Veřejná sonda připravenosti
Tvoje práce končí potvrzením čárového kódu

Laboratorní proces se spustí, jakmile potvrdíš odběr krve

Pošleš nám čárový kód sady a to je to poslední, co od tebe potřebujeme. Pak zařídíme obaly, kurýra i laboratoř, takže tvůj kód zavolá jen dva endpointy, než bude zpráva hotová.

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
Plná tečka je cesta, kterou chceš.Kroužek je stav, který ještě řešíš.Oranžové čáry jsou potvrzená objednávka.
Jeden parser zpracuje odběr krve na klinice i domácí testovací sadu

Každý výsledek má dvě referenční rozmezí a čtyři stavy

Každý klinický řádek obsahuje rozmezí z laboratoře i rozmezí Anivy s jejím optimálním oknem, takže můžeš vykreslit obojí bez nutnosti udržovat vlastní vyhledávací tabulku.

Řádek uvádí plánováno, než ho laboratoř analyzuje.
Řádek zobrazí stav přijato, jakmile dorazí hodnota a jednotka.
Řádek zobrazuje fault, když laboratoř zrušila požadavek, a status_reason to vysvětluje.
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 používá tři formáty času

Datum a čas musí obsahovat časové pásmo, jinak požadavek selže

Naivní datetime je odmítnut s kódem 400, což je jediná chyba, kterou dělá většina prvních integrací.

Časová razítka se vždy vrací v UTC ve formátu ISO 8601 s příponou Z.
Vstupy musí obsahovat explicitní časový posun, takže rezervace přijme hodnotu 2026-05-15T12:30:00+02:00.
Aktualizace zásilky zachovávají časový posun, který nahlásil poskytovatel logistiky.
Kalendářní pole používají pouze běžný místní čas, například datum narození.
Aniva vydává a obměňuje každý partnerský klíč

Každý požadavek vyžaduje tvůj partnerský API klíč

Autentizace používá u každého volání hlavičku x-api-key a chybějící nebo obměněný klíč vrátí 403 s krátkou chybou JSON.

Tvůj klíč určuje, která místa, termíny a zásilky můžeš vidět.
Nikdy nezveřejňuj svůj API klíč v klientském kódu ani ve veřejných repozitářích.
Veřejná sonda nepotřebuje API klíč

Každou službu můžeš sledovat na stavové stránce

Stavová stránka zobrazuje aktuální stav a 90 dní historie pro každou službu a stejná data jsou dostupná jako JSON pro tvůj vlastní monitoring.

Partnerské klíče vydává náš tým

Požádat nás o partnerský klíč ještě dnes

Řekni nám, na kterých trzích prodáváš a jaké panely potřebuješ, a pošleme ti klíč se správnými oprávněními.

Můžeš si také stáhnout soubor OpenAPI

Tato stránka je ukázka designu. Každý endpoint a payload na ní pochází z docs.anivahealth.com a schéma pipeline je ilustrativní.

Strojově čitelné kopie dokumentace najdeš na docs.anivahealth.com/llms.txt a docs.anivahealth.com/llms-full.txt.