Zakaži analize krvi iz svog proizvoda

Jedan API ključ ti daje 45 krajnjih tačaka, od zakazivanja do laboratorijskih rezultata

Aniva Partner API zakazuje vađenje krvi na više od 25 lokacija u Nemačkoj, dodaje panele u taj termin i vraća kliničke i genetske rezultate u JSON formatu. Svakom zahtevu je potrebno jedno zaglavlje, a osnovni URL je isti u svakom okruženju.

Kada koristiti Aniva

Koristi Anivu kada tvojim klijentima treba zakazivanje analize krvi
Koristi krajnje tačke za termine kod vađenja krvi u klinici, a krajnje tačke za komplet za kućno testiranje za komplet koji se šalje poštom.
Koristi krajnje tačke rezultata za kliničke redove, genetske redove i PDF izveštaj.
Koristi krajnje tačke kataloga da očitaš biomarkere, panele i jedinice koje Aniva prodaje.
Koristi dokumentovane putanje pod https://anivahealth.com/api/v1/ i ne izmišljaj krajnje tač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 tok čine četiri zahteva
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 krajnjih tačaka je dokumentovano i aktivno danas

1

Za autentifikaciju je potrebno samo jedno zaglavlje zahteva

v1

Svaka putanja počinje prefiksom v1

25+

Lokacije u Nemačkoj mogu da urade vađenje krvi

Četiri zahteva čine funkcionalnu integraciju

Četiri zahteva vode od zakazivanja do laboratorijskih rezultata

Svaki zahtev vraća ID koji je potreban sledećem, pa osnovna integracija ima četiri zahteva pre nego što dodaš panele, promene termina ili kurire.

Korak 01 · GET /locations

Navodiš lokacije za koje tvoj ključ može da zakazuje

Odgovor ti daje svaku adresu, radno vreme i vremensku zonu, tako da klijent vidi samo termine koji postoje.

Testovi
Korak 02 · POST /profiles

Kreiraš profil za klijenta

Profilu su potrebni ime, oznaka pola, datum rođenja i tvoj profile_group, koji prihvata UUID ili tvoj sopstveni slug.

Testovi
Korak 03 · POST /appointments

Zakažeš termin za vreme koje izabereš

Za zakazivanje su potrebni ID profila, ID lokacije i datum i vreme u ISO 8601 formatu sa vremenskim pomerajem ili sufiksom Z.

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

Potvrđuješ vađenje krvi barkodom kompleta

Ovaj zahtev pokreće laboratorijski nalog i zaključava termin, pa izmeni sve panele pre nego što ga pošalješ.

Testovi
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 je jedna REST kolekcija

Možeš da naručiš vađenje krvi u klinici ili komplet za kućno testiranje poštom. Oba se vraćaju u istom formatu, tako da kod za čitanje rezultata pišeš samo jednom.

Profili · 4 krajnje tačke

Profil je osoba koju testiraš

Pronađeš profil po imejlu, kreiraš ga u okviru svoje grupe profila i kasnije dopuniš demografske podatke.

Testovi
GET /profiles
PATCH /profiles/{id}
Termini · 15 krajnjih tačaka

Termin obuhvata panele i vađenje krvi

Petnaest krajnjih tačaka pokriva zakazivanje i svaku kasniju izmenu, uključujući panele, pregled posuda za uzorke i potvrdu.

Testovi
POST /appointments
GET /appointments/{id}/results
Porudžbine kompleta za kućno testiranje · 10 endpointa

Porudžbine kompleta za kućno testiranje su poštanska verzija

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

Testovi
Kreiraj porudžbinu kompleta
Preuzmi rezultate
Lokacije · 2 krajnje tačke

Lokacije ti pokazuju gde se obavlja vađenje krvi

Prvo učitaš lokacije na kojima tvoj ključ može da zakazuje, a zatim od jedne od njih zatražiš početke dostupnih termina.

Testovi
GET /locations
GET /locations/{id}/availability
Dokumenti · 1 krajnja tačka

Rezultati stižu kao klinički i genetski redovi

Svaki tip porudžbine ima sopstveni poziv za rezultate, a PDF izveštaj se preuzima zasebno pomoću ID-a fajla.

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

Kurir nosi uzorak u laboratoriju

Kreiraš nalog za kurira sa vremenskim okvirom za preuzimanje radnim danom, zatim pridružiš termine i pratiš promene njegovog statusa.

Testovi
POST /shipments
Priloži termine
Katalozi · 4 krajnje tačke

Katalozi navode biomarkere koje možeš da naručiš

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

Testovi
GET /biomarkers
GET /panels
Zdravlje · 1 krajnja tačka

Jedan endpoint za proveru spremnosti ne zahteva API ključ

Provera spremnosti ne zahteva API ključ, pa tvoj monitor dostupnosti može da je poziva po rasporedu.

Testovi
Javna provera spremnosti
Tvoj posao se završava potvrdom bar-koda

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

Pošalješ nam bar-kod kompleta i to je poslednje što nam treba od tebe. Mi zatim organizujemo posude, kurira i laboratoriju, tako da tvoj kod poziva samo dva endpointa dok izveštaj 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 tačka je putanja koju želiš.Prsten je stanje koje i dalje obrađuješ.Narandžaste linije su potvrđena porudžbina.
Jedan parser čita vađenje krvi na klinici i komplet za kućno testiranje

Svaki rezultat ima dva referentna opsega i četiri statusa

Svaki klinički red sadrži opseg koji je laboratorija navela i Aniva opseg sa njegovim optimalnim rasponom, tako da možeš da prikažeš oba bez vođenja sopstvene referentne tabele.

U redu stoji planirano pre nego što ga laboratorija analizira.
U redu piše primljeno čim stignu vrednost i jedinica.
Red prikazuje fault kada je laboratorija otkazala zahtev, 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, inače zahtev ne uspeva

Datetime bez vremenske zone odbija se sa 400, što je jedina greška koju pravi većina prvih integracija.

Vremenske oznake se uvek vraćaju u UTC formatu, po standardu ISO 8601 sa sufiksom Z.
Unosi moraju da sadrže eksplicitan vremenski pomak, pa zakazivanje prihvata 2026-05-15T12:30:00+02:00.
Ažuriranja pošiljke zadržavaju vremenski pomak koji je prijavio logistički provajder.
Kalendarska polja koriste samo lokalno vreme bez vremenske zone, kao što je datum rođenja.
Aniva izdaje i rotira svaki partnerski ključ

Za svaki zahtev potreban je tvoj partnerski API ključ

Autentifikacija koristi zaglavlje x-api-key pri svakom pozivu, a nedostajući ili rotirani ključ vraća 403 sa kratkom JSON greškom.

Tvoj ključ određuje koje lokacije, termine i pošiljke možeš da vidiš.
Nikada ne otkrivaj svoj API ključ u kodu na strani klijenta niti u javnim repozitorijumima.
Za javnu proveru nije potreban API ključ

Svaku uslugu možeš da pratiš na stranici statusa

Stranica statusa prikazuje trenutno stanje i istoriju za 90 dana za svaku uslugu, a isti podaci su dostupni u JSON formatu za tvoj sopstveni nadzor.

Partnerske ključeve izdaje naš tim

Zatraži od nas partnerski ključ danas

Reci nam na kojim tržištima prodaješ i koji su ti paneli potrebni, i poslaćemo ti ključ sa odgovarajućim dozvolama.

Možeš i da preuzmeš OpenAPI fajl

Ova stranica je dizajnerski prototip. Svaki endpoint i payload na njoj preuzet je sa docs.anivahealth.com, a dijagram toka je ilustrativan.

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