Pieteikt asins analīzes tieši savā produktā

Viena API atslēga dod tev 45 galapunktus — no pieraksta līdz laboratorijas rezultātiem

Aniva Partner API piesaka asins paņemšanu vairāk nekā 25 vietās Vācijā, pievieno šim pierakstam paneļus un atgriež klīniskos un ģenētiskos rezultātus JSON formātā. Katram pieprasījumam nepieciešama viena galvene, un bāzes URL visās vidēs ir vienāds.

Kad izmantot Aniva

Izmanto Aniva, kad taviem klientiem jāpiesaka asins analīzes
Izmanto pieraksta galapunktus asins paņemšanai klīnikā un mājas testa komplekta galapunktus komplektam pa pastu.
Izmanto rezultātu galapunktus klīniskajām rindām, ģenētiskajām rindām un PDF pārskatam.
Izmanto kataloga galapunktus, lai nolasītu biomarķierus, paneļus un vienības, ko pārdod Aniva.
Izmanto dokumentētos ceļus adresē https://anivahealth.com/api/v1/ un neizdomā galapunktus.
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"
  }'
Pamata plūsma ir četri pieprasījumi
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 galapunkti šodien ir dokumentēti un darbojas

1

Autentifikācijai vajadzīga tikai viena pieprasījuma galvene

v1

Katrs ceļš sākas ar prefiksu v1

25+

Vācijas punktos var veikt asins paņemšanu

Četri pieprasījumi izveido strādājošu integrāciju

No pieteikšanās līdz laboratorijas rezultātiem ir četri pieprasījumi

Katrs pieprasījums atgriež ID, kas nepieciešams nākamajam, tāpēc pamata integrācija ir četri pieprasījumi, pirms pievieno paneļus, pārcelšanu vai kurjerus.

01. solis · GET /locations

Tu norādi vietas, kuras var rezervēt ar tavu atslēgu

Atbildē tu saņem katru adresi, darba laiku un laika joslu, tāpēc klients redz tikai reāli pieejamos laikus.

Analīzes
02. solis · POST /profiles

Tu izveido klientam profilu

Profilam nepieciešams vārds, dzimuma kods, dzimšanas datums un tavs profile_group, kurā var norādīt UUID vai savu slug.

Analīzes
03. solis · POST /appointments

Tu rezervē pierakstu izvēlētajā laikā

Rezervācijai nepieciešams profila ID, atrašanās vietas ID un ISO 8601 datums un laiks ar laika nobīdi vai Z sufiksu.

Analīzes
04. solis · POST /appointments/{id}/confirm

Tu apstiprini asins paņemšanu ar komplekta svītrkodu

Šis pieprasījums uzsāk laboratorijas pasūtījumu un bloķē pierakstu, tāpēc veic izmaiņas katrā panelī, pirms to nosūti.

Analīzes
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"
  }'
Iespēja

Katra resursu grupa ir viena REST kolekcija

Tu vari pasūtīt asins paņemšanu klīnikā vai mājas testa komplektu pa pastu. Abi atgriežas vienā formātā, tāpēc kodu rezultātu nolasīšanai raksti tikai vienu reizi.

Profili · 4 galapunkti

Profils ir persona, kuru tu testē

Tu uzmeklē profilu pēc e-pasta, izveido to savā profilu grupā un vēlāk atjaunini demogrāfiskos datus.

Analīzes
GET /profiles
PATCH /profiles/{id}
Pieraksti · 15 galapunkti

Pieraksts ietver paneļus un asins paņemšanu

Piecpadsmit galapunkti aptver pierakstu un visas vēlākās izmaiņas tajā, tostarp paneļus, konteineru priekšskatījumus un apstiprinājumu.

Analīzes
POST /appointments
GET /appointments/{id}/results
Mājas testa komplektu pasūtījumi · 10 galapunkti

Mājas testa komplektu pasūtījumi ir pasta versija

Desmit galapunkti pieprasa paštestēšanas komplektu profilam, maina tā paneļus un atgriež vienādu rezultātu struktūru.

Analīzes
Izveidot komplekta pasūtījumu
Saņemt rezultātus
Atrašanās vietas · 2 galapunkti

Atrašanās vietas parāda, kur notiek asins paņemšana

Tu nolasi atrašanās vietas, kurās tava atslēga var veikt pierakstu, un pēc tam vienai no tām pieprasi pieejamos pieraksta sākuma laikus.

Analīzes
GET /locations
GET /locations/{id}/availability
Dokumenti · 1 galapunkts

Rezultāti pienāk kā klīniskās un ģenētiskās rindas

Katram pasūtījuma veidam ir savs rezultātu pieprasījums, un PDF pārskats ir atsevišķa lejupielāde pēc faila ID.

Analīzes
GET /appointments/{id}/results
GET /documents/{id}
Sūtījumi · 8 galapunkti

Kurjers nogādā paraugu laboratorijā

Tu izveido kurjera pasūtījumu ar paņemšanas laiku darba dienā, tad pievieno pierakstus un skati tā statusa atjauninājumus.

Analīzes
POST /shipments
Pievienot pierakstus
Katalogi · 4 galapunkti

Katalogos ir uzskaitīti biomarķieri, ko vari pasūtīt

Biomarķieru, paneļu un mērvienību katalogi ir sadalīti lapās, un biomarķierus vari filtrēt pēc testēšanas vietas.

Analīzes
GET /biomarkers
GET /panels
Veselība · 1 galapunkts

Vienam gatavības galapunktam nav vajadzīga API atslēga

Gatavības pārbaudei nav nepieciešama API atslēga, tāpēc tavs pieejamības monitors var to izsaukt pēc grafika.

Analīzes
Publiskā gatavības pārbaude
Tavs darbs beidzas ar svītrkoda apstiprināšanu

Laboratorijas process sākas, kad apstiprini asins paņemšanu

Tu nosūti mums komplekta svītrkodu, un tas ir pēdējais, kas mums no tevis vajadzīgs. Pēc tam mēs noorganizējam konteinerus, kurjeru un laboratoriju, tāpēc tavs kods izsauc tikai divus galapunktus, līdz pārskats ir gatavs.

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
Aizpildīts punkts ir ceļš, ko vēlies.Gredzens ir stāvoklis, kas tev vēl jāapstrādā.Oranžās līnijas ir apstiprinātais pasūtījums.
Viens parsētājs nolasa klīnikas asins paņemšanu un mājas testa komplektu

Katram rezultātam ir divi references intervāli un četri statusi

Katrā klīniskajā rindā ir laboratorijas norādītais intervāls un Aniva intervāls ar optimālo diapazonu, tāpēc vari attēlot abus, neuzturot savu uzmeklēšanas tabulu.

Rindā norādīts plānots, pirms laboratorija to analizē.
Rindā parādās statuss saņemts, tiklīdz pienāk vērtība un mērvienība.
Rindā redzams fault, ja laboratorija ir atcēlusi pieprasījumu, un status_reason to izskaidro.
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 izmanto trīs laika formātus

Datuma un laika vērtībām ir nepieciešama laika josla, pretējā gadījumā pieprasījums neizdodas

Datums un laiks bez laika joslas tiek noraidīts ar 400, un tieši šo kļūdu pieļauj lielākā daļa pirmo integrāciju.

Laikspiedoli vienmēr tiek atgriezti kā UTC, izmantojot ISO 8601 ar Z sufiksu.
Ievades datiem jāietver skaidra laika nobīde, tāpēc rezervācija pieņem 2026-05-15T12:30:00+02:00.
Sūtījumu atjauninājumi saglabā loģistikas pakalpojumu sniedzēja ziņoto nobīdi.
Kalendāra lauki norāda tikai lokālo laiku, piemēram, dzimšanas datumu.
Aniva izsniedz un rotē katru partnera atslēgu

Katram pieprasījumam vajadzīga tava partnera API atslēga

Autentifikācija katrā pieprasījumā izmanto x-api-key galveni, un trūkstoša vai nomainīta atslēga atgriež 403 ar īsu JSON kļūdu.

Tava atslēga nosaka, kuras atrašanās vietas, pierakstus un sūtījumus vari redzēt.
Nekad neatklāj savu API atslēgu klienta puses kodā vai publiskos repozitorijos.
Publiskai pārbaudei nav nepieciešama API atslēga

Katram pakalpojumam vari sekot līdzi statusa lapā

Statusa lapā redzams katra pakalpojuma pašreizējais stāvoklis un 90 dienu vēsture, un tie paši dati ir pieejami JSON formātā tavai uzraudzības sistēmai.

Partneru atslēgas izsniedz mūsu komanda

Jautāt mums pēc partnera atslēgas jau šodien

Pastāsti mums, kuros tirgos pārdod un kuri paneļi tev vajadzīgi, un mēs nosūtīsim atslēgu ar atbilstošajām atļaujām.

Vari arī lejupielādēt OpenAPI failu

Šī lapa ir dizaina makets. Katrs galapunkts un datu pakete tajā ir ņemta no docs.anivahealth.com, un datu plūsmas shēma ir ilustratīva.

Mašīnlasāmas dokumentācijas kopijas pieejamas adresēs docs.anivahealth.com/llms.txt un docs.anivahealth.com/llms-full.txt.