Ibbukkja testijiet tad-demm minn ġewwa l-prodott tiegħek stess

Ċavetta waħda tal-API tagħtik 45 endpoint, mill-ibbukkjar sar-riżultati tal-laboratorju

L-Aniva Partner API jibbukkja teħid tad-demm f'aktar minn 25 post fil-Ġermanja, iżid panels ma' dak l-appuntament, u jirritorna riżultati kliniċi u ġenetiċi bħala JSON. Kull talba teħtieġ header wieħed, u l-base URL hija l-istess f'kull ambjent.

Meta tuża Aniva

Uża Aniva meta l-klijenti tiegħek ikollhom bżonn jibbukkjaw test tad-demm
Uża l-endpoints tal-appuntamenti għal teħid tad-demm fi klinika u l-endpoints tal-kit tat-test għad-dar għal kit bil-posta.
Uża l-endpoints tar-riżultati għar-ringieli kliniċi, ir-ringieli ġenetiċi u r-rapport PDF.
Uża l-endpoints tal-katalgu biex taqra l-bijomarkaturi, il-panels u l-unitajiet li tbigħ Aniva.
Uża l-mogħdijiet dokumentati taħt https://anivahealth.com/api/v1/ u tivvintax endpoints.
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"
  }'
Il-fluss bażiku huwa ta' erba' talbiet
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 endpoint huma dokumentati u attivi llum

1

L-awtentikazzjoni teħtieġ header wieħed biss tat-talba

v1

Kull mogħdija tibda bil-prefiss v1

25+

Il-postijiet fil-Ġermanja jistgħu jagħmlu t-teħid tad-demm

Erba' talbiet jibnu integrazzjoni li taħdem

Erba' talbiet iwasslu mill-ibbukkjar sar-riżultati tal-laboratorju

Kull talba tirritorna l-ID li teħtieġ dik li jmiss, għalhekk integrazzjoni bażika hija erba' talbiet qabel ma żżid panels, skedar mill-ġdid jew kurrieri.

Pass 01 · GET /locations

Int telenka l-postijiet li ċ-ċavetta tiegħek tista' tibbukkja

It-tweġiba tagħtik kull indirizz, il-ħinijiet tal-ftuħ u ż-żona tal-ħin, biex klijent jara biss ħinijiet li jeżistu.

Testijiet
Pass 02 · POST /profiles

Toħloq profil għall-klijent

Profil għandu bżonn isem, kodiċi tas-sess, data tat-twelid u l-profile_group tiegħek, li jaċċetta UUID jew is-slug tiegħek stess.

Testijiet
Pass 03 · POST /appointments

Tibbukkja l-appuntament fil-ħin li tagħżel

L-ibbukkjar jeħtieġ l-ID tal-profil, l-ID tal-post u data u ħin ISO 8601 bl-offset tagħhom jew bis-suffiss Z.

Testijiet
Pass 04 · POST /appointments/{id}/confirm

Tikkonferma t-teħid tad-demm bil-barcode tal-kit

Din it-talba tibda l-ordni tal-laboratorju u ssakkar l-appuntament, għalhekk biddel kull panel qabel tibgħatha.

Testijiet
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"
  }'
Kapaċità

Kull grupp ta' riżorsi huwa kollezzjoni REST waħda

Tista' tordna teħid tad-demm f'klinika, jew kit tat-test għad-dar bil-posta. It-tnejn jiġu lura bl-istess format, għalhekk tikteb il-kodiċi li jaqra r-riżultati darba biss.

Profili · 4 endpoints

Profil huwa l-persuna li tittestja

Tfittex profil bl-email, toħolqu taħt il-grupp ta' profili tiegħek, u taġġorna d-dejta demografika aktar tard.

Testijiet
GET /profiles
PATCH /profiles/{id}
Appuntamenti · 15-il endpoint

Appuntament fih il-panels u t-teħid tad-demm

Ħmistax-il endpoint ikopru l-ibbukkjar u kull bidla sussegwenti fih, inklużi l-panels, il-previews tal-kontenituri u l-konferma.

Testijiet
POST /appointments
GET /appointments/{id}/results
Ordnijiet tal-kits tat-test għad-dar · 10 endpoints

L-ordnijiet tal-kit tat-test għad-dar huma l-verżjoni bil-posta

Għaxar endpoints jitolbu kit DIY għal profil, ibiddlu l-panels tiegħu, u jirritornaw l-istess forma tar-riżultat.

Testijiet
Oħloq ordni ta' kit
Ikseb ir-riżultati
Postijiet · 2 endpoints

Il-postijiet juruk fejn isir it-teħid tad-demm

Taqra l-postijiet li ċ-ċavetta tiegħek tista' tibbukkja, imbagħad titlob lil wieħed minnhom il-ħinijiet tal-bidu disponibbli għall-ibbukkjar.

Testijiet
GET /locations
GET /locations/{id}/availability
Dokumenti · 1 endpoint

Ir-riżultati jiġu lura bħala ringieli kliniċi u ġenetiċi

Kull tip ta' ordni għandu s-sejħa tar-riżultati tiegħu, u r-rapport PDF huwa tniżżil separat permezz tal-ID tal-fajl.

Testijiet
GET /appointments/{id}/results
GET /documents/{id}
Vjeġġi · 8 endpoints

Kurrier jieħu l-kampjun fil-laboratorju

Toħloq ordni ta' kurrier b'ħin tal-ġbir f'jum tax-xogħol, imbagħad tehmeż l-appuntamenti u taqra l-aġġornamenti tal-istatus tiegħu.

Testijiet
POST /shipments
Ehmeż appuntamenti
Katalogi · 4 endpoints

Il-katalgi jelenkaw il-bijomarkaturi li tista' tordna

Il-katalgi tal-bijomarkaturi, tal-panels u tal-unitajiet huma mqassmin f'paġni, u tista' tiffiltra l-bijomarkaturi skont il-post tat-test.

Testijiet
GET /biomarkers
GET /panels
Saħħa · 1 endpoint

Endpoint wieħed ta' readiness ma jeħtieġx API key

Il-probe ta' prontezza m'għandux bżonn API key, allura l-monitor tal-uptime tiegħek jista' jsejjaħlu skont skeda.

Testijiet
Verifika pubblika ta' prontezza
Ix-xogħol tiegħek jispiċċa mal-konferma tal-barcode

Il-proċess tal-laboratorju jibda meta tikkonferma t-teħid tad-demm

Int tibgħatilna l-barcode tal-kit, u dik hija l-aħħar ħaġa li għandna bżonn mingħandek. Imbagħad norganizzaw il-kontenituri, il-kurrier u l-laboratorju, biex il-kodiċi tiegħek isejjaħ biss żewġ endpoints sakemm ir-rapport ikun lest.

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
Tikka mimlija hija r-rotta li trid.Ċirku vojt huwa stat li xorta tieħu ħsiebu.Linji oranġjo huma l-ordni kkonfermata.
Parser wieħed jaqra teħid tad-demm fil-klinika u kit tat-test għad-dar

Kull riżultat għandu żewġ meded ta' referenza u erba' statusi

Kull ringiela klinika għandha l-medda li rrapporta l-laboratorju u l-medda ta' Aniva bit-tieqa ottimali tagħha, sabiex tkun tista' turi t-tnejn mingħajr ma żżomm tabella ta' tfittxija tiegħek stess.

Ringiela turi ppjanat qabel ma janalizzaha l-laboratorju.
Ringiela turi irċevut ladarba jaslu valur u unità.
Ringiela turi fault meta l-laboratorju jkun ikkanċella t-talba, u status_reason jispjega dan.
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" }]
}
L-API juża tliet formati tal-ħin

Id-dati u l-ħinijiet jeħtieġu żona tal-ħin inkella t-talba tfalli

Datetime mingħajr żona tal-ħin jiġi rrifjutat b'400, li hu l-aktar żball komuni li jagħmlu l-ewwel integrazzjonijiet.

It-timestamps dejjem jiġu lura bħala UTC, bl-użu ta' ISO 8601 bis-suffiss Z.
L-inputs iridu jinkludu offset espliċitu, għalhekk prenotazzjoni taċċetta 2026-05-15T12:30:00+02:00.
L-aġġornamenti tal-konsenja jżommu l-offset li rrapporta l-fornitur tal-loġistika.
L-oqsma tal-kalendarju huma ħin lokali biss, bħal data tat-twelid.
Aniva toħroġ u tbiddel regolarment kull ċavetta ta' sieħeb

Kull talba teħtieġ l-API key tiegħek bħala sieħeb

L-awtentikazzjoni tuża l-header x-api-key fuq kull sejħa, u ċavetta nieqsa jew mibdula tagħti 403 bi żball qasir ta' JSON.

Iċ-ċavetta tiegħek tiddeċiedi liema postijiet, appuntamenti u vjeġġi tista' tara.
Qatt m'għandek tesponi l-API key tiegħek f'kodiċi client-side jew f'repożitorji pubbliċi.
Verifika pubblika ma teħtieġx API key

Tista' ssegwi kull servizz fuq il-paġna tal-istatus

Il-paġna tal-istatus turi l-istat attwali u 90 jum ta' storja għal kull servizz, u l-istess data hija disponibbli bħala JSON għall-monitor tiegħek stess.

Iċ-ċwievet tal-imsieħba jinħarġu mit-tim tagħna

Itlobna ċavetta ta' sieħeb illum

Għidilna f'liema swieq tbigħ u liema panels għandek bżonn, u nibagħtulek ċavetta bil-permessi t-tajbin.

Tista' wkoll tniżżel il-fajl OpenAPI

Din il-paġna hija mudell tad-disinn. Kull endpoint u payload fuqha ttieħed minn docs.anivahealth.com, u d-dijagramma tal-pipeline hija illustrattiva.

Kopji tad-dokumentazzjoni li jinqraw mill-magni jinsabu fuq docs.anivahealth.com/llms.txt u docs.anivahealth.com/llms-full.txt.