Vérvizsgálatok foglalása a saját termékeden belülről

Egyetlen API-kulccsal 45 végpontot kapsz a foglalástól a laboreredményekig

Az Aniva Partner API több mint 25 németországi helyszínen foglal vérvételt, paneleket ad hozzá az időponthoz, és JSON formátumban adja vissza a klinikai és genetikai eredményeket. Minden kéréshez egyetlen fejléc szükséges, az alap URL pedig minden környezetben ugyanaz.

Mikor használd az Anivát

Használd az Anivát, ha az ügyfeleidnek vérvizsgálatot kell foglalni
Klinikai vérvételhez használd az időpont-végpontokat, postai készlethez pedig az otthoni tesztkészlet végpontjait.
Használd az eredmények végpontjait a klinikai sorokhoz, a genetikai sorokhoz és a PDF-jelentéshez.
Használd a katalógus-végpontokat az Aniva által értékesített biomarkerek, panelek és egységek lekérdezéséhez.
Használd a https://anivahealth.com/api/v1/ alatt dokumentált útvonalakat, és ne találj ki végpontokat.
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"
  }'
Az alapfolyamat négy kérésből áll
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 végpont dokumentált és már ma aktív

1

A hitelesítéshez csak egy kérésfejléc szükséges

v1

Minden útvonal a v1 előtaggal kezdődik

25+

A németországi helyszíneken elvégezhető a vérvétel

Négy kérésből összeáll egy működő integráció

Négy kérés vezet a foglalástól a laboreredményekig

Minden kérés visszaadja a következőhöz szükséges azonosítót, így egy alap integráció négy kérésből áll, mielőtt paneleket, átütemezéseket vagy futárokat adnál hozzá.

01. lépés · GET /locations

Te adod meg, mely helyszínekre foglalhat a kulcsod

A válasz minden címet, a nyitvatartási időt és az időzónát is megadja, így az ügyfél csak létező időpontokat lát.

Vizsgálatok
02. lépés · POST /profiles

Létrehozol egy profilt az ügyfélnek

Egy profilhoz név, nemi kód, születési dátum és a profile_group értéked szükséges, amely UUID-t vagy saját slugot fogad el.

Vizsgálatok
03. lépés · POST /appointments

Lefoglalod az időpontot egy választott idősávra

A foglaláshoz szükség van a profilazonosítóra, a helyszínazonosítóra és egy ISO 8601-es dátum-idő értékre az eltolással vagy a Z utótaggal.

Vizsgálatok
04. lépés · POST /appointments/{id}/confirm

A készlet vonalkódjával erősíted meg a vérvételt

Ez a kérés elindítja a laboratóriumi rendelést és zárolja az időpontot, ezért minden panelt módosíts az elküldése előtt.

Vizsgálatok
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"
  }'
Képesség

Minden erőforráscsoport egyetlen REST-gyűjtemény

Rendelhetsz vérvételt egy klinikán, vagy otthoni tesztkészletet postán. Mindkettő ugyanabban a formátumban érkezik vissza, így csak egyszer kell megírnod az eredményeket beolvasó kódot.

Profilok · 4 végpont

A profil az a személy, akit vizsgálsz

Megkeresel egy profilt e-mail-cím alapján, létrehozod a profilcsoportod alatt, és később frissíted a demográfiai adatokat.

Vizsgálatok
GET /profiles
PATCH /profiles/{id}
Időpontok · 15 végpont

Egy időpont tartalmazza a paneleket és a vérvételt

Tizenöt végpont fedi le a foglalást és minden későbbi módosítását, beleértve a paneleket, a mintatartályok előnézetét és a visszaigazolást.

Vizsgálatok
POST /appointments
GET /appointments/{id}/results
Otthoni tesztkészletek rendelése · 10 végpont

Az otthoni tesztkészletek rendelése a postai változat

Tíz végpont igényel otthoni készletet egy profilhoz, módosítja annak paneleit, és ugyanazt az eredményformátumot adja vissza.

Vizsgálatok
Tesztkészlet-rendelés létrehozása
Eredmények megtekintése
Helyszínek · 2 végpont

A helyszínek megmutatják, hol történik a vérvétel

Lekérdezed azokat a helyszíneket, amelyekre a kulcsod foglalni tud, majd az egyiktől lekéred a foglalható időpontok kezdését.

Vizsgálatok
GET /locations
GET /locations/{id}/availability
Dokumentumok · 1 végpont

Az eredmények klinikai és genetikai sorokban érkeznek vissza

Minden rendeléstípusnak saját eredmény-lekérdezése van, a PDF-jelentés pedig külön letöltés fájlazonosító alapján.

Vizsgálatok
GET /appointments/{id}/results
GET /documents/{id}
Küldemények · 8 végpont

Egy futár elviszi a mintát a laboratóriumba

Létrehozol egy futárrendelést hétköznapi felvételi időablakkal, majd csatolod az időpontokat, és követed az állapotfrissítéseket.

Vizsgálatok
POST /shipments
Időpontok csatolása
Katalógusok · 4 végpont

A katalógusok felsorolják a rendelhető biomarkereket

A biomarker-, panel- és mértékegység-katalógusok lapozhatók, a biomarkereket pedig vizsgálati helyszín szerint szűrheted.

Vizsgálatok
GET /biomarkers
GET /panels
Állapot · 1 végpont

Egy készenléti végponthoz nem kell API-kulcs

A readiness probe-hoz nem kell API-kulcs, így az üzemidő-figyelőd ütemezetten is meghívhatja.

Vizsgálatok
Nyilvános készenléti próba
A munkád a vonalkód visszaigazolásával véget ér

A laborfolyamat akkor indul el, amikor visszaigazolod a vérvételt

Elküldöd nekünk a készlet vonalkódját, és több dologra nincs is szükségünk tőled. Ezután mi megszervezzük a tartályokat, a futárt és a laboratóriumot, így a kódod csak két végpontot hív meg, amíg a lelet el nem készül.

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
A teli pont a kívánt útvonal.A gyűrű egy állapot, amelyet még te kezelsz.A narancssárga vonalak a visszaigazolt megrendelést jelölik.
Egyetlen parser olvassa a rendelői vérvételt és az otthoni tesztkészletet

Minden eredményhez két referenciatartomány és négy státusz tartozik

Minden klinikai sor tartalmazza a laboratórium által közölt tartományt és az Aniva tartományát az optimális sávval, így saját keresőtábla nélkül is megjelenítheted mindkettőt.

Egy sor tervezett állapotot mutat, mielőtt a laboratórium elemzi.
Egy sor beérkezett állapotot mutat, amint megjön egy érték és egy mértékegység.
Egy sorban fault szerepel, ha a laboratórium törölte a kérést, a status_reason pedig megmagyarázza az okát.
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" }]
}
Az API három időformátumot használ

A dátum-idő értékekhez időzóna kell, különben a kérés sikertelen

Az időzóna nélküli dátum-időt 400-as hibával utasítja el a rendszer, és ez az az egyetlen hiba, amelyet a legtöbb első integráció elkövet.

Az időbélyegek mindig UTC-ben érkeznek vissza, ISO 8601 formátumban, Z utótaggal.
A bemeneti adatoknak pontos időeltolást kell tartalmazniuk, így a foglalás elfogadja a 2026-05-15T12:30:00+02:00 értéket.
A küldeményfrissítések megőrzik a logisztikai szolgáltató által megadott időeltolódást.
A naptári mezők kizárólag helyi dátumértékek, például a születési dátum.
Az Aniva minden partnerkulcsot kiad és rotál

Minden kéréshez szükséges a partneri API-kulcsod

A hitelesítés minden hívásnál az x-api-key fejlécet használja, a hiányzó vagy lecserélt kulcs pedig 403-as kódot ad vissza egy rövid JSON-hibával.

A kulcsod határozza meg, mely helyszíneket, időpontokat és szállítmányokat láthatod.
Soha ne tedd közzé az API-kulcsodat kliensoldali kódban vagy nyilvános tárolókban.
Egy nyilvános próbalekérdezéshez nem kell API-kulcs

Minden szolgáltatást nyomon követhetsz az állapotoldalon

Az állapotoldal minden szolgáltatás esetében megmutatja az aktuális állapotot és 90 napnyi előzményt, ugyanezek az adatok pedig JSON formátumban is elérhetők a saját monitorodhoz.

A partnerkulcsokat a csapatunk adja ki

Kérj tőlünk partnerkulcsot még ma

Írd meg, mely piacokon értékesítesz és milyen panelekre van szükséged, mi pedig küldünk egy kulcsot a megfelelő jogosultságokkal.

Az OpenAPI-fájlt is letöltheted

Ez az oldal egy látványterv. Minden rajta szereplő végpont és payload a docs.anivahealth.com oldalról származik, a folyamatábra pedig illusztráció.

A dokumentáció géppel olvasható másolatai a docs.anivahealth.com/llms.txt és a docs.anivahealth.com/llms-full.txt címen érhetők el.