Rezervovať krvné testy priamo z vlastného produktu

Jeden API kľúč ti sprístupní 45 endpointov, od rezervácie až po laboratórne výsledky

Aniva Partner API rezervuje odber krvi na viac ako 25 miestach v Nemecku, pridáva k tomuto termínu panely a vracia klinické a genetické výsledky vo formáte JSON. Každá požiadavka potrebuje jednu hlavičku a základná URL je v každom prostredí rovnaká.

Kedy použiť Aniva

Použi Aniva, keď tvoji zákazníci potrebujú rezervovať krvný test
Na odber krvi na klinike použi endpointy pre termíny a na súpravu poštou endpointy pre domácu testovaciu súpravu.
Použi endpointy pre výsledky na klinické riadky, genetické riadky a PDF správu.
Použi koncové body katalógu na načítanie biomarkerov, panelov a jednotiek, ktoré Aniva predáva.
Používaj zdokumentované cesty pod https://anivahealth.com/api/v1/ a nevymýšľaj 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 tvoria štyri požiadavky
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 endpointov je dnes zdokumentovaných a v prevádzke

1

Na autentifikáciu stačí jedna hlavička požiadavky

v1

Každá cesta sa začína predponou v1

25+

Nemecké pobočky môžu urobiť odber krvi

Štyri požiadavky vytvoria funkčnú integráciu

Od rezervácie po výsledky z laboratória vedú štyri požiadavky

Každá požiadavka vráti ID, ktoré potrebuje nasledujúca, takže základná integrácia sú štyri požiadavky, kým pridáš panely, zmeny termínov alebo kuriérov.

Krok 01 · GET /locations

Vypíšeš si miesta, ktoré môže tvoj kľúč rezervovať

Odpoveď ti vráti každú adresu, otváracie hodiny a časové pásmo, takže zákazník vidí len existujúce termíny.

Testy
Krok 02 · POST /profiles

Vytvoríš zákazníkovi profil

Profil potrebuje meno, kód pohlavia, dátum narodenia a tvoj profile_group, ktorý prijíma UUID alebo tvoj vlastný slug.

Testy
Krok 03 · POST /appointments

Rezervuješ si termín na vybraný čas

Rezervácia vyžaduje ID profilu, ID lokality a dátum s časom vo formáte ISO 8601 s časovým posunom alebo príponou Z.

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

Odber krvi potvrdíš čiarovým kódom súpravy

Táto požiadavka spustí laboratórnu objednávku a uzamkne termín, takže každý panel zmeň pred jej odoslaní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"
  }'
Schopnosť

Každá skupina zdrojov je jedna REST kolekcia

Môžeš objednať odber krvi na klinike alebo domácu testovaciu súpravu poštou. Oboje príde v rovnakom formáte, takže kód na čítanie výsledkov napíšeš len raz.

Profily · 4 koncové body

Profil je osoba, ktorú testuješ

Profil vyhľadáš podľa e-mailu, vytvoríš ho v rámci svojej skupiny profilov a demografické údaje doplníš neskôr.

Testy
GET /profiles
PATCH /profiles/{id}
Termíny · 15 koncových bodov

Termín zahŕňa panely aj odber krvi

Pätnásť endpointov pokrýva rezerváciu aj každú jej neskoršiu zmenu vrátane panelov, náhľadov odberových nádob a potvrdenia.

Testy
POST /appointments
GET /appointments/{id}/results
Objednávky domácich testovacích súprav · 10 endpointov

Objednávky domácich testovacích súprav sú poštová verzia

Desať endpointov vyžiada domácu súpravu pre profil, zmení jeho panely a vráti rovnakú štruktúru výsledkov.

Testy
Vytvoriť objednávku súpravy
Získať výsledky
Lokality · 2 endpointy

Lokality ti ukážu, kde prebieha odber krvi

Načítaš miesta, na ktorých môže tvoj kľúč rezervovať, a potom si od jedného z nich vyžiadaš začiatky voľných termínov.

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

Výsledky prichádzajú ako klinické a genetické riadky

Každý typ objednávky má vlastné volanie pre výsledky a PDF správa sa sťahuje samostatne podľa ID súboru.

Testy
GET /appointments/{id}/results
GET /documents/{id}
Zásielky · 8 koncových bodov

Kuriér odvezie vzorku do laboratória

Vytvoríš objednávku kuriéra s časovým oknom vyzdvihnutia v pracovný deň, potom priradíš termíny a sleduješ aktualizácie jej stavu.

Testy
POST /shipments
Pripojiť termíny
Katalógy · 4 koncové body

Katalógy uvádzajú biomarkery, ktoré si môžeš objednať

Katalógy biomarkerov, panelov a jednotiek sú stránkované a biomarkery môžeš filtrovať podľa miesta testovania.

Testy
GET /biomarkers
GET /panels
Zdravie · 1 endpoint

Jeden endpoint pripravenosti nepotrebuje API kľúč

Sonda pripravenosti nevyžaduje žiadny API kľúč, takže ju tvoj monitor dostupnosti môže volať podľa plánu.

Testy
Verejná sonda pripravenosti
Tvoja práca sa končí potvrdením čiarového kódu

Laboratórny proces sa spustí, keď potvrdíš odber krvi

Pošleš nám čiarový kód súpravy a to je posledná vec, ktorú od teba potrebujeme. My potom zorganizujeme nádoby, kuriéra a laboratórium, takže tvoj kód volá len dva endpointy, kým nie je sprá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á bodka je cesta, ktorú chceš.Krúžok je stav, ktorý ešte riešiš.Oranžové čiary sú potvrdená objednávka.
Jeden parser prečíta odber krvi na klinike aj domácu testovaciu súpravu

Každý výsledok má dve referenčné rozmedzia a štyri stavy

Každý klinický riadok obsahuje rozmedzie, ktoré uviedlo laboratórium, aj rozmedzie Aniva s jeho optimálnym pásmom, takže môžeš zobraziť obe bez udržiavania vlastnej vyhľadávacej tabuľky.

Riadok zobrazuje naplánované predtým, než ho laboratórium analyzuje.
Riadok zobrazí stav prijaté, hneď ako dorazí hodnota aj jednotka.
V riadku sa zobrazí fault, keď laboratórium zrušilo požiadavku, a status_reason to vysvetľuje.
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žíva tri formáty času

Dátumy a časy vyžadujú časové pásmo, inak požiadavka zlyhá

Dátum a čas bez časovej zóny systém zamietne kódom 400, čo je chyba, ktorú robí väčšina prvých integrácií.

Časové pečiatky sa vždy vracajú v UTC vo formáte ISO 8601 s príponou Z.
Vstupy musia obsahovať explicitný časový posun, takže rezervácia prijme 2026-05-15T12:30:00+02:00.
Aktualizácie zásielky zachovávajú posun, ktorý nahlásil poskytovateľ logistiky.
Kalendárne polia predstavujú len miestny údaj bez časového pásma, napríklad dátum narodenia.
Aniva vydáva a obmieňa každý partnerský kľúč

Každá požiadavka potrebuje tvoj partnerský API kľúč

Autentifikácia používa hlavičku x-api-key pri každom volaní a chýbajúci alebo obmenený kľúč vráti 403 s krátkou chybou JSON.

Tvoj kľúč určuje, ktoré lokality, termíny a zásielky vidíš.
Nikdy nezverejňuj svoj API kľúč v klientskom kóde ani vo verejných repozitároch.
Verejná sonda nepotrebuje API kľúč

Každú službu môžeš sledovať na stránke stavu služieb

Stavová stránka zobrazuje aktuálny stav a históriu za 90 dní pre každú službu a tie isté údaje sú dostupné ako JSON pre tvoj vlastný monitoring.

Partnerské kľúče vydáva náš tím

Požiadať o partnerský kľúč ešte dnes

Povedz nám, na ktorých trhoch predávaš a ktoré panely potrebuješ, a pošleme ti kľúč so správnymi oprávneniami.

Môžeš si stiahnuť aj súbor OpenAPI

Táto stránka je dizajnový návrh. Každý endpoint a payload na nej pochádza z docs.anivahealth.com a diagram pipeline je ilustračný.

Strojovo čitateľné kópie dokumentácie sú na docs.anivahealth.com/llms.txt a docs.anivahealth.com/llms-full.txt.