Užsakyti kraujo tyrimus tiesiai iš savo produkto

Vienas API raktas suteikia 45 galinius taškus – nuo registracijos iki laboratorijos rezultatų

Aniva Partner API užsako kraujo paėmimą daugiau nei 25 vietose Vokietijoje, prideda Panel prie to vizito ir grąžina klinikinius bei genetinius rezultatus JSON formatu. Kiekvienai užklausai reikia vienos antraštės, o pagrindinis URL visose aplinkose yra tas pats.

Kada naudotis Aniva

Naudok Aniva, kai tavo klientams reikia užsakyti kraujo tyrimą
Naudok vizito galinius taškus kraujo paėmimui klinikoje, o namų tyrimo rinkinio galinius taškus – rinkiniui paštu.
Naudok rezultatų galinius taškus klinikinėms eilutėms, genetinėms eilutėms ir PDF ataskaitai.
Naudok katalogo galinius taškus, kad nuskaitytum Aniva parduodamus biožymenis, Panel ir vienetus.
Naudok dokumentuotus kelius adresu https://anivahealth.com/api/v1/ ir neišgalvok galinių taškų.
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"
  }'
Pagrindinį procesą sudaro keturios užklausos
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

Šiandien dokumentuoti ir veikia 45 galiniai taškai

1

Autentifikavimui pakanka vienos užklausos antraštės

v1

Kiekvienas kelias prasideda priešdėliu v1

25+

Padaliniai Vokietijoje gali atlikti kraujo paėmimą

Keturios užklausos sukuria veikiančią integraciją

Nuo užsakymo iki laboratorijos rezultatų – keturios užklausos

Kiekviena užklausa grąžina ID, kurio reikia kitai, todėl bazinę integraciją sudaro keturios užklausos, kol dar nepridėjai tyrimų paketų, perkėlimų ar kurjerių.

01 žingsnis · GET /locations

Nurodai vietas, kurias tavo raktas gali rezervuoti

Atsakyme gauni kiekvieną adresą, darbo laiką ir laiko juostą, todėl klientas mato tik esamus laikus.

Tyrimai
02 žingsnis · POST /profiles

Sukuri klientui profilį

Profiliui reikia vardo, lyties kodo, gimimo datos ir tavo profile_group, kuris priima UUID arba tavo paties slug.

Tyrimai
03 žingsnis · POST /appointments

Užsisakai vizitą pasirinktu laiku

Rezervacijai reikalingas profilio ID, vietos ID ir ISO 8601 formato data bei laikas su poslinkiu arba Z priesaga.

Tyrimai
04 žingsnis · POST /appointments/{id}/confirm

Kraujo paėmimą patvirtini rinkinio brūkšniniu kodu

Ši užklausa pradeda laboratorijos užsakymą ir užrakina vizitą, todėl kiekvieną Panel pakeisk prieš ją siunčiant.

Tyrimai
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"
  }'
Galimybė

Kiekviena išteklių grupė yra viena REST kolekcija

Gali užsakyti kraujo paėmimą klinikoje arba namų tyrimo rinkinį paštu. Abu grįžta tuo pačiu formatu, todėl kodą, kuris nuskaito rezultatus, rašai tik kartą.

Profiliai · 4 galiniai taškai

Profilis – tai asmuo, kuriam atlieki tyrimą

Susirandi profilį pagal el. paštą, sukuri jį savo profilių grupėje, o demografinius duomenis atnaujini vėliau.

Tyrimai
GET /profiles
PATCH /profiles/{id}
Vizitai · 15 galinių taškų

Vizitas apima tyrimų paketus ir kraujo paėmimą

Penkiolika galinių taškų apima užsakymą ir kiekvieną vėlesnį jo pakeitimą, įskaitant Panel, talpyklų peržiūras ir patvirtinimą.

Tyrimai
POST /appointments
GET /appointments/{id}/results
Namų tyrimo rinkinių užsakymai · 10 galinių taškų

Namų tyrimo rinkinio užsakymai yra siuntimo paštu versija

Dešimt galinių taškų užsako savarankiško tyrimo rinkinį profiliui, pakeičia jo Panel ir grąžina tą pačią rezultatų struktūrą.

Tyrimai
Sukurti rinkinio užsakymą
Gauti rezultatus
Vietos · 2 galiniai taškai

Vietos parodo, kur vyksta kraujo paėmimas

Nuskaitai vietas, kurias leidžia rezervuoti tavo raktas, tada iš vienos jų paprašai laisvų laikų pradžios.

Tyrimai
GET /locations
GET /locations/{id}/availability
Dokumentai · 1 galinis taškas

Rezultatai grįžta kaip klinikinės ir genetinės eilutės

Kiekvienas užsakymo tipas turi savo rezultatų užklausą, o PDF ataskaita atsisiunčiama atskirai pagal failo ID.

Tyrimai
GET /appointments/{id}/results
GET /documents/{id}
Siuntos · 8 galiniai taškai

Kurjeris nuveža mėginį į laboratoriją

Sukuri kurjerio užsakymą su darbo dienos paėmimo laiku, tada pridedi vizitus ir matai jo būsenos atnaujinimus.

Tyrimai
POST /shipments
Prisegti vizitus
Katalogai · 4 galiniai taškai

Kataloguose pateikiami biožymenys, kuriuos gali užsisakyti

Biožymenų, Panel ir vienetų katalogai suskirstyti į puslapius, o biožymenis gali filtruoti pagal tyrimo vietą.

Tyrimai
GET /biomarkers
GET /panels
Sveikata · 1 galinis taškas

Vienam parengties galutiniam taškui nereikia API rakto

Parengties patikrai nereikia API rakto, todėl tavo veikimo laiko stebėjimo įrankis gali ją iškviesti pagal grafiką.

Tyrimai
Viešoji parengties patikra
Tavo darbas baigiasi patvirtinus brūkšninį kodą

Laboratorinis procesas prasideda, kai patvirtini kraujo paėmimą

Tu atsiunti mums rinkinio brūkšninį kodą, ir tai paskutinis dalykas, kurio mums iš tavęs reikia. Tada mes suorganizuojame talpas, kurjerį ir laboratoriją, todėl tavo kodas kreipiasi tik į du galinius taškus, kol ataskaita bus paruošta.

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
Pilnas taškas – kelias, kurio nori.Žiedas – būsena, kurią dar tvarkai.Oranžinės linijos – patvirtintas užsakymas.
Vienas analizatorius nuskaito tiek klinikos kraujo paėmimo, tiek namų tyrimo rinkinio duomenis

Kiekvienas rezultatas turi du referencinius intervalus ir keturias būsenas

Kiekvienoje klinikinėje eilutėje pateikiamas laboratorijos nurodytas intervalas ir Aniva intervalas su optimaliu langu, todėl gali atvaizduoti abu be savo paieškos lentelės.

Eilutėje rodoma suplanuota, kol laboratorija neatlieka analizės.
Eilutėje rodoma būsena gauta, kai grįžta reikšmė ir vienetas.
Eilutėje rodoma fault, kai laboratorija atšaukė užsakymą, o status_reason tai paaiškina.
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 naudoja tris laiko formatus

Datai ir laikui reikia laiko juostos, kitaip užklausa nepavyks

Data ir laikas be laiko juostos atmetami su kodu 400 – tai pagrindinė klaida, kurią daro dauguma pirmųjų integracijų.

Laiko žymos visada grąžinamos UTC laiku, naudojant ISO 8601 formatą su Z sufiksu.
Įvestyse turi būti nurodytas aiškus laiko poslinkis, todėl užsakymas priima 2026-05-15T12:30:00+02:00.
Siuntos atnaujinimai išlaiko poslinkį, kurį pateikė logistikos tiekėjas.
Kalendoriaus laukuose naudojamas tik vietinis laikas, pavyzdžiui, gimimo datai.
Aniva išduoda ir rotuoja kiekvieną partnerio raktą

Kiekvienai užklausai reikia tavo partnerio API rakto

Autentifikavimui kiekvienoje užklausoje naudojama x-api-key antraštė, o nesant rakto arba jį pakeitus grąžinama 403 klaida su trumpu JSON pranešimu.

Tavo raktas lemia, kurias vietas, vizitus ir siuntas gali matyti.
Niekada neviešink savo API rakto kliento pusės kode ar viešose saugyklose.
Viešam patikrinimui nereikia API rakto

Kiekvieną paslaugą gali stebėti būsenos puslapyje

Būsenos puslapyje rodoma dabartinė kiekvienos paslaugos būsena ir 90 dienų istorija, o tie patys duomenys pateikiami JSON formatu tavo stebėjimo sistemai.

Partnerių raktus išduoda mūsų komanda

Paprašyti partnerio rakto šiandien

Pasakyk mums, kuriose rinkose parduodi ir kurių Panel tau reikia, ir atsiųsime raktą su tinkamais leidimais.

Taip pat gali atsisiųsti OpenAPI failą

Šis puslapis yra dizaino maketas. Kiekvienas jame nurodytas galinis taškas ir duomenų paketas yra paimtas iš docs.anivahealth.com, o proceso diagrama yra iliustracinė.

Kompiuteriu skaitomos dokumentacijos kopijos yra adresu docs.anivahealth.com/llms.txt ir docs.anivahealth.com/llms-full.txt.