Bóka blóðprufur innan úr þinni eigin vöru

Einn API-lykill gefur þér 45 endapunkta, frá bókun til rannsóknarniðurstaðna

Aniva Partner API bókar blóðtöku á yfir 25 stöðum í Þýskalandi, bætir panelum við þann tíma og skilar klínískum og erfðafræðilegum niðurstöðum sem JSON. Hver beiðni þarf einn haus og grunn-URL er það sama í hverju umhverfi.

Hvenær á að nota Aniva

Notaðu Aniva þegar viðskiptavinir þínir þurfa að bóka blóðprufu
Notaðu endapunktana fyrir tíma við blóðtöku á stofu og endapunktana fyrir heimaprófssett fyrir sett í pósti.
Notaðu niðurstöðuendapunktana fyrir klínískar raðir, erfðaraðir og PDF-skýrsluna.
Notaðu endapunkta vörulistans til að lesa þau lífmerki, panela og einingar sem Aniva selur.
Notaðu skráðar slóðir undir https://anivahealth.com/api/v1/ og búðu ekki til nýja endapunkta.
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"
  }'
Grunnflæðið er fjórar beiðnir
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 endapunktar eru skjalfestir og virkir í dag

1

Auðkenning þarf aðeins einn beiðnihaus

v1

Sérhver slóð byrjar á forskeytinu v1

25+

Þýskar starfsstöðvar geta séð um blóðtökuna

Fjórar fyrirspurnir mynda virka samþættingu

Fjórar beiðnir ganga frá bókun að niðurstöðum rannsóknarstofu

Hver beiðni skilar auðkenninu sem sú næsta þarf, þannig að grunnsamþætting er fjórar beiðnir áður en þú bætir við panelum, tímabreytingum eða sendlum.

Skref 01 · GET /locations

Þú skráir staðsetningarnar sem lykillinn þinn getur bókað

Svarið gefur þér hvert heimilisfang, opnunartíma og tímabelti, svo viðskiptavinur sjái aðeins tíma sem eru til staðar.

Prufur
Skref 02 · POST /profiles

Þú býrð til prófíl fyrir viðskiptavininn

Prófíll þarf nafn, kóða fyrir kyn, fæðingardag og þitt profile_group, sem tekur við UUID eða þínu eigin slug.

Prufur
Skref 03 · POST /appointments

Þú bókar tíma í völdu tímahólfi

Bókunin þarf prófílauðkenni, staðsetningarauðkenni og ISO 8601-dagsetningu og tíma með tímabeltisfráviki eða Z-endingunni.

Prufur
Skref 04 · POST /appointments/{id}/confirm

Þú staðfestir blóðtökuna með strikamerki sýnatökupakkans

Þessi beiðni setur rannsóknarpöntunina af stað og læsir tímanum, svo breyttu hverju panel áður en þú sendir hana.

Prufur
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"
  }'
Geta

Hver tilfangahópur er eitt REST-safn

Þú getur pantað blóðtöku á læknastofu eða heimaprófssett í pósti. Hvort tveggja kemur til baka á sama sniði, svo þú skrifar kóðann sem les niðurstöður aðeins einu sinni.

Prófílar · 4 endapunktar

Prófíll er einstaklingurinn sem þú mælir

Þú flettir upp notandasniði eftir netfangi, stofnar það í þínum notendahópi og uppfærir lýðfræðiupplýsingar síðar.

Prufur
GET /profiles
PATCH /profiles/{id}
Tímar · 15 endapunktar

Tími felur í sér panelana og blóðtökuna

Fimmtán endapunktar ná yfir bókunina og allar síðari breytingar á henni, þar á meðal panela, forskoðun íláta og staðfestinguna.

Prufur
POST /appointments
GET /appointments/{id}/results
Pantanir á heimaprófssettum · 10 endapunktar

Pantanir á heimaprófssetti eru póstútgáfan

Tíu endapunktar biðja um heimasett fyrir prófíl, breyta panelum hans og skila sama sniði á niðurstöðum.

Prufur
Stofna pöntun á prófsetti
Fá niðurstöður
Staðsetningar · 2 endapunktar

Staðsetningar sýna þér hvar blóðtaka fer fram

Þú lest staðsetningarnar sem lykillinn þinn getur bókað á og biður síðan eina þeirra um upphafstíma bókanlegra tíma.

Prufur
GET /locations
GET /locations/{id}/availability
Skjöl · 1 endapunktur

Niðurstöður koma til baka sem klínískar og erfðafræðilegar línur

Hver pöntunartegund hefur sitt eigið kall fyrir niðurstöður og PDF-skýrslan er eitt sérstakt niðurhal eftir skráarauðkenni.

Prufur
GET /appointments/{id}/results
GET /documents/{id}
Sendingar · 8 endapunktar

Sendiboði fer með sýnið á rannsóknarstofuna

Þú býrð til sendipöntun með tímaglugga fyrir sækingu á virkum degi, tengir svo tíma við hana og lest stöðuuppfærslur hennar.

Prufur
POST /shipments
Tengja tíma
Vöruskrár · 4 endapunktar

Vörulistar sýna lífmerkin sem þú getur pantað

Skrárnar yfir lífmerki, panel og mælieiningar eru síðuskiptar og þú getur síað lífmerki eftir prófunarstað.

Prufur
GET /biomarkers
GET /panels
Heilsa · 1 endapunktur

Einn readiness-endapunktur þarf engan API-lykil

Tilbúnaðarkönnunin þarf engan API-lykil, þannig að uppitímaeftirlitið þitt getur kallað á hana samkvæmt áætlun.

Prufur
Opinber viðbúnaðarprófun
Þínu verki lýkur þegar strikamerkið er staðfest

Rannsóknarferlið hefst þegar þú staðfestir blóðtökuna

Þú sendir okkur strikamerkið á settinu og það er það síðasta sem við þurfum frá þér. Við sjáum síðan um ílátin, sendilinn og rannsóknarstofuna, svo kóðinn þinn kallar aðeins á tvo endapunkta þar til skýrslan er tilbúin.

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
Fylltur punktur er leiðin sem þú vilt.Hringur er staða sem þú sérð enn um.Appelsínugular línur eru staðfesta pöntunin.
Einn þáttari les bæði blóðtöku á stofu og heimaprófssett

Hver niðurstaða hefur tvenn viðmiðunarmörk og fjórar stöður

Í hverri klínískri línu eru viðmiðunarmörkin sem rannsóknarstofan tilkynnti og viðmiðunarmörk Aniva ásamt ákjósanlegu bili, svo þú getur birt hvort tveggja án þess að halda úti eigin uppflettitöflu.

Á röðinni stendur áætlað áður en rannsóknarstofan greinir hana.
Lína sýnir móttekið um leið og gildi og eining berast.
Röð sýnir fault þegar rannsóknarstofan felldi niður beiðnina og status_reason útskýrir það.
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-viðmótið notar þrjú tímasnið

Dagsetningar og tímar þurfa tímabelti, annars mistekst beiðnin

Tímasetningu án tímabeltis er hafnað með 400, sem eru þau mistök sem flestar fyrstu samþættingar gera.

Tímastimplar koma alltaf til baka í UTC, á ISO 8601-sniði með Z-endingu.
Inntak verður að innihalda skýrt tímabeltisfrávik, þannig að bókun tekur við 2026-05-15T12:30:00+02:00.
Sendingaruppfærslur halda tímahliðruninni sem flutningsaðilinn tilkynnti.
Dagatalsreitir nota eingöngu staðartíma, eins og fæðingardagur.
Aniva gefur út og endurnýjar alla lykla samstarfsaðila

Hver beiðni þarf API-lykilinn þinn fyrir samstarfsaðila

Auðkenning notar hausinn x-api-key í hverju kalli og lykill sem vantar eða hefur verið endurnýjaður skilar 403 með stuttri JSON-villu.

Lykillinn þinn ræður því hvaða staðsetningar, tíma og sendingar þú getur séð.
Birtu aldrei API-lykilinn þinn í biðlarakóða eða opinberum kóðasöfnum.
Opinber prófun þarf engan API-lykil

Þú getur fylgst með hverri þjónustu á stöðusíðunni

Stöðusíðan sýnir núverandi stöðu og 90 daga sögu fyrir hverja þjónustu og sömu gögn eru í boði á JSON-sniði fyrir þína eigin vöktun.

Teymið okkar gefur út samstarfslykla

Biddu okkur um samstarfslykil í dag

Segðu okkur á hvaða mörkuðum þú selur og hvaða panela þú þarft og við sendum þér lykil með réttum heimildum.

Þú getur einnig sótt OpenAPI-skrána

Þessi síða er hönnunardrög. Allir endapunktar og gagnapakkar á henni koma frá docs.anivahealth.com og ferlismyndin er til skýringar.

Vélrænt lesanleg afrit af skjöluninni eru á docs.anivahealth.com/llms.txt og docs.anivahealth.com/llms-full.txt.