Rezerviraj krvne pretrage izravno iz vlastitog proizvoda

Jedan API ključ daje ti 45 krajnjih točaka, od rezervacije do laboratorijskih rezultata

Aniva Partner API rezervira vađenje krvi na više od 25 lokacija u Njemačkoj, dodaje panele tom terminu i vraća kliničke i genetske rezultate u formatu JSON. Svaki zahtjev treba jedno zaglavlje, a osnovni URL isti je u svakom okruženju.

Kada koristiti Anivu

Koristi Anivu kada tvoji klijenti trebaju rezervirati krvnu pretragu
Za vađenje krvi u klinici koristi krajnje točke za termin, a za komplet poštom krajnje točke za kućni testni komplet.
Za kliničke retke, genetske retke i PDF izvješće koristi krajnje točke za rezultate.
Koristi krajnje točke kataloga za čitanje biomarkera, panela i jedinica koje Aniva prodaje.
Koristi dokumentirane putanje pod https://anivahealth.com/api/v1/ i nemoj izmišljati krajnje točke.
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"
  }'
Osnovni tijek čine četiri zahtjeva
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

Danas je dokumentirano i aktivno 45 krajnjih točaka

1

Za autentifikaciju je potrebno samo jedno zaglavlje zahtjeva

v1

Svaka putanja počinje prefiksom v1

25+

Na lokacijama u Njemačkoj moguće je obaviti vađenje krvi

Četiri zahtjeva stvaraju funkcionalnu integraciju

Četiri zahtjeva vode od rezervacije do laboratorijskih rezultata

Svaki zahtjev vraća ID koji treba sljedeći, pa osnovna integracija ima četiri zahtjeva prije nego što dodaš panele, promjene termina ili kurire.

Korak 01 · GET /locations

Dohvaćaš popis lokacija koje tvoj ključ može rezervirati

Odgovor ti daje svaku adresu, radno vrijeme i vremensku zonu, tako da kupac vidi samo postojeće termine.

Pretrage
Korak 02 · POST /profiles

Izrađuješ profil za klijenta

Profil treba ime, oznaku spola, datum rođenja i tvoj profile_group, koji prihvaća UUID ili vlastiti slug.

Pretrage
Korak 03 · POST /appointments

Rezerviraš termin u odabrano vrijeme

Za rezervaciju su potrebni ID profila, ID lokacije te datum i vrijeme u formatu ISO 8601 s vremenskim pomakom ili sufiksom Z.

Pretrage
Korak 04 · POST /appointments/{id}/confirm

Vađenje krvi potvrđuješ barkodom kompleta

Ovaj zahtjev pokreće laboratorijsku narudžbu i zaključava termin, stoga promijeni svaki panel prije slanja.

Pretrage
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"
  }'
Mogućnost

Svaka grupa resursa jedna je REST kolekcija

Možeš naručiti vađenje krvi u ordinaciji ili kućni testni komplet poštom. Oboje se vraća u istom formatu, pa kôd koji čita rezultate pišeš samo jednom.

Profili · 4 krajnje točke

Profil je osoba koju testiraš

Pronađeš profil putem e-pošte, kreiraš ga unutar svoje grupe profila i kasnije ažuriraš demografske podatke.

Pretrage
GET /profiles
PATCH /profiles/{id}
Termini · 15 krajnjih točaka

Termin uključuje panele i vađenje krvi

Petnaest krajnjih točaka pokriva rezervaciju i svaku kasniju izmjenu, uključujući panele, preglede spremnika i potvrdu.

Pretrage
POST /appointments
GET /appointments/{id}/results
Narudžbe kućnih testnih kompleta · 10 krajnjih točaka

Narudžbe kućnog testnog kompleta poštanska su verzija

Deset krajnjih točaka traži DIY komplet za profil, mijenja njegove panele i vraća istu strukturu rezultata.

Pretrage
Izradi narudžbu kompleta
Primi rezultate
Lokacije · 2 krajnje točke

Lokacije ti pokazuju gdje se obavlja vađenje krvi

Čitaš lokacije za koje tvoj ključ može rezervirati, a zatim od jedne od njih tražiš početke slobodnih termina.

Pretrage
GET /locations
GET /locations/{id}/availability
Dokumenti · 1 krajnja točka

Rezultati stižu kao klinički i genetski redci

Svaka vrsta narudžbe ima vlastiti poziv za rezultate, a PDF izvješće preuzima se zasebno putem ID-a datoteke.

Pretrage
GET /appointments/{id}/results
GET /documents/{id}
Pošiljke · 8 krajnjih točaka

Kurir odnosi uzorak u laboratorij

Kreiraš kurirski nalog s vremenskim okvirom preuzimanja radnim danom, zatim pridružiš termine i pratiš ažuriranja njegovog statusa.

Pretrage
POST /shipments
Pridruži termine
Katalozi · 4 krajnje točke

Katalozi navode biomarkere koje možeš naručiti

Katalozi biomarkera, panela i jedinica podijeljeni su u stranice, a biomarkere možeš filtrirati prema lokaciji testiranja.

Pretrage
GET /biomarkers
GET /panels
Zdravlje · 1 krajnja točka

Jedna krajnja točka za spremnost ne treba API ključ

Provjera spremnosti ne zahtijeva API ključ, pa je tvoj monitor dostupnosti može pozivati prema rasporedu.

Pretrage
Javna provjera spremnosti
Tvoj posao završava potvrdom barkoda

Laboratorijski proces počinje kada potvrdiš vađenje krvi

Pošalješ nam barkod kompleta i to je zadnje što nam treba od tebe. Zatim organiziramo spremnike, kurira i laboratorij, pa tvoj kod poziva samo dvije krajnje točke dok nalaz ne bude spreman.

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
Puna točka je put koji želiš.Prsten je stanje koje i dalje rješavaš.Narančaste linije su potvrđena narudžba.
Jedan parser obrađuje vađenje krvi u klinici i kućni testni komplet

Svaki rezultat ima dva referentna raspona i četiri statusa

Svaki klinički redak sadrži raspon koji je dostavio laboratorij i raspon Anive s njegovim optimalnim okvirom, pa možeš prikazati oba bez održavanja vlastite tablice za pretraživanje.

U retku stoji planirano prije nego što ga laboratorij analizira.
Redak prikazuje primljeno čim stignu vrijednost i jedinica.
U retku piše fault kada je laboratorij otkazao zahtjev, a status_reason to objašnjava.
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 koristi tri formata vremena

Datumi i vremena moraju imati vremensku zonu ili zahtjev neće uspjeti

Datum i vrijeme bez vremenske zone odbijaju se s 400, što je upravo ona greška koju napravi većina prvih integracija.

Vremenske oznake uvijek se vraćaju u UTC formatu, prema standardu ISO 8601 sa sufiksom Z.
Unosi moraju sadržavati eksplicitni vremenski pomak, pa rezervacija prihvaća 2026-05-15T12:30:00+02:00.
Ažuriranja pošiljke zadržavaju pomak koji je prijavio pružatelj logističkih usluga.
Kalendarska polja koriste samo lokalno vrijeme, poput datuma rođenja.
Aniva izdaje i rotira svaki partnerski ključ

Svaki zahtjev treba tvoj partnerski API ključ

Autentifikacija koristi zaglavlje x-api-key pri svakom pozivu, a ključ koji nedostaje ili je rotiran vraća 403 uz kratku JSON pogrešku.

Tvoj ključ određuje koje lokacije, termine i pošiljke možeš vidjeti.
Nikada ne izlaži svoj API ključ u klijentskom kodu ili javnim repozitorijima.
Javna provjera ne zahtijeva API ključ

Možeš pratiti svaku uslugu na stranici statusa

Stranica statusa prikazuje trenutačno stanje i 90 dana povijesti za svaku uslugu, a isti su podaci dostupni kao JSON za tvoj vlastiti nadzor.

Partnerske ključeve izdaje naš tim

Zatraži od nas partnerski ključ već danas

Reci nam na kojim tržištima prodaješ i koje panele trebaš, a mi ćemo poslati ključ s odgovarajućim dozvolama.

Možeš preuzeti i OpenAPI datoteku

Ova je stranica dizajnerski prikaz. Svaki endpoint i payload na njoj preuzet je s docs.anivahealth.com, a dijagram toka podataka služi kao ilustracija.

Strojno čitljive kopije dokumentacije nalaze se na docs.anivahealth.com/llms.txt i docs.anivahealth.com/llms-full.txt.