Programează analize de sânge direct din propriul tău produs

O singură cheie API îți oferă 45 de endpoint-uri, de la programare până la rezultatele de laborator

Aniva Partner API programează o recoltare de sânge în peste 25 de locații din Germania, adaugă paneluri la acea programare și returnează rezultate clinice și genetice în format JSON. Fiecare cerere are nevoie de un singur header, iar URL-ul de bază este același în orice mediu.

Când să folosești Aniva

Folosește Aniva când clienții tăi au nevoie să programeze o analiză de sânge
Folosește endpoint-urile de programare pentru o recoltare de sânge în clinică și endpoint-urile de kit de testare la domiciliu pentru un kit trimis prin poștă.
Folosește endpointurile de rezultate pentru rândurile clinice, rândurile genetice și raportul PDF.
Folosește endpoint-urile de catalog pentru a citi biomarkerii, panelurile și unitățile pe care le vinde Aniva.
Folosește căile documentate de sub https://anivahealth.com/api/v1/ și nu inventa endpointuri.
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"
  }'
Fluxul de bază constă în patru cereri
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 de endpoint-uri sunt documentate și active astăzi

1

Autentificarea are nevoie de un singur antet de cerere

v1

Fiecare cale începe cu prefixul v1

25+

Locațiile din Germania pot face recoltarea de sânge

Patru cereri construiesc o integrare funcțională

Patru cereri duc de la programare la rezultatele de laborator

Fiecare cerere returnează ID-ul de care are nevoie următoarea, așa că o integrare de bază înseamnă patru cereri înainte să adaugi paneluri, reprogramări sau curieri.

Pasul 01 · GET /locations

Listezi locațiile pe care cheia ta le poate programa

Răspunsul îți oferă fiecare adresă, programul și fusul orar, așa că un client vede doar intervalele care există.

Teste
Pasul 02 · POST /profiles

Creezi un profil pentru client

Un profil are nevoie de un nume, un cod de sex, o dată de naștere și parametrul tău profile_group, care acceptă un UUID sau propriul tău slug.

Teste
Pasul 03 · POST /appointments

Faci programarea în intervalul ales

Programarea necesită ID-ul profilului, ID-ul locației și o dată și oră în format ISO 8601 cu decalajul aferent sau sufixul Z.

Teste
Pasul 04 · POST /appointments/{id}/confirm

Confirmi recoltarea de sânge cu codul de bare al kitului

Această cerere inițiază comanda de laborator și blochează programarea, așa că modifică fiecare panel înainte de a o trimite.

Teste
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"
  }'
Capacitate

Fiecare grup de resurse este o colecție REST

Poți comanda o recoltare de sânge la o clinică sau un kit de testare la domiciliu prin poștă. Ambele revin în același format, așa că scrii o singură dată codul care citește rezultatele.

Profiluri · 4 endpoint-uri

Un profil este persoana pe care o testezi

Cauți un profil după e-mail, îl creezi în grupul tău de profiluri și actualizezi datele demografice ulterior.

Teste
GET /profiles
PATCH /profiles/{id}
Programări · 15 endpointuri

O programare include panelurile și recoltarea de sânge

Cincisprezece endpoint-uri acoperă programarea și orice modificare ulterioară a acesteia, inclusiv panelurile, previzualizările recipientelor și confirmarea.

Teste
POST /appointments
GET /appointments/{id}/results
Comenzi de kituri de testare la domiciliu · 10 endpoint-uri

Comenzile de kit de testare la domiciliu sunt varianta prin poștă

Zece endpoint-uri solicită un kit DIY pentru un profil, îi modifică panelurile și returnează aceeași structură a rezultatelor.

Teste
Creează o comandă de kit
Primește rezultatele
Locații · 2 endpoint-uri

Locațiile îți arată unde are loc recoltarea de sânge

Citești locațiile pe care le poate programa cheia ta, apoi soliciți de la una dintre ele orele de începere ale intervalelor disponibile.

Teste
GET /locations
GET /locations/{id}/availability
Documente · 1 endpoint

Rezultatele vin sub formă de rânduri clinice și genetice

Fiecare tip de comandă are propriul apel pentru rezultate, iar raportul PDF este o descărcare separată după ID-ul fișierului.

Teste
GET /appointments/{id}/results
GET /documents/{id}
Expedieri · 8 endpoint-uri

Un curier duce proba la laborator

Creezi o comandă de curierat cu un interval de ridicare în timpul săptămânii, apoi atașezi programările și vezi actualizările de status.

Teste
POST /shipments
Atașează programări
Cataloage · 4 endpoint-uri

Cataloagele enumeră biomarkerii pe care îi poți comanda

Cataloagele de biomarkeri, paneluri și unități sunt paginate și poți filtra biomarkerii după locația de testare.

Teste
GET /biomarkers
GET /panels
Sănătate · 1 endpoint

Un endpoint de disponibilitate nu necesită cheie API

Verificarea de disponibilitate nu are nevoie de cheie API, așa că monitorul tău de uptime o poate apela după un program.

Teste
Verificare publică de disponibilitate
Munca ta se încheie la confirmarea codului de bare

Fluxul de laborator începe când confirmi recoltarea de sânge

Ne trimiți codul de bare al kitului, iar acesta este ultimul lucru de care avem nevoie de la tine. Apoi organizăm recipientele, curierul și laboratorul, astfel încât codul tău apelează doar două endpoint-uri până când raportul este gata.

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
Un punct plin este ruta pe care o dorești.Un inel este o stare pe care încă o gestionezi.Liniile portocalii reprezintă comanda confirmată.
Un singur parser citește o recoltare de sânge din clinică și un kit de testare la domiciliu

Fiecare rezultat are două intervale de referință și patru statusuri

Fiecare rând clinic conține intervalul raportat de laborator și intervalul Aniva cu fereastra sa optimă, astfel încât le poți afișa pe ambele fără să menții propriul tabel de corespondență.

Un rând apare ca planificat înainte ca laboratorul să îl analizeze.
Un rând apare ca primit imediat ce sosesc o valoare și o unitate.
Un rând afișează fault atunci când laboratorul a anulat cererea, iar status_reason explică motivul.
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-ul folosește trei formate de timp

Valorile de dată și oră au nevoie de un fus orar, altfel cererea eșuează

O valoare datetime fără fus orar este respinsă cu 400, greșeala pe care o fac cel mai des primele integrări.

Marcajele temporale sunt returnate întotdeauna în UTC, folosind ISO 8601 cu sufixul Z.
Datele de intrare trebuie să includă un decalaj explicit, astfel încât o programare acceptă 2026-05-15T12:30:00+02:00.
Actualizările privind expedierea păstrează decalajul raportat de furnizorul de logistică.
Câmpurile calendaristice folosesc doar timpul local, cum ar fi data nașterii.
Aniva emite și rotește fiecare cheie de partener

Fiecare cerere necesită cheia ta API de partener

Autentificarea folosește antetul x-api-key la fiecare apel, iar o cheie lipsă sau rotită returnează 403 cu o scurtă eroare JSON.

Cheia ta decide ce locații, programări și expedieri poți vedea.
Nu expune niciodată cheia API în codul client-side sau în repository-uri publice.
O verificare publică nu are nevoie de cheie API

Poți urmări fiecare serviciu pe pagina de status

Pagina de stare arată starea curentă și 90 de zile de istoric pentru fiecare serviciu, iar aceleași date sunt disponibile ca JSON pentru propriul tău sistem de monitorizare.

Cheile de partener sunt emise de echipa noastră

Cere-ne astăzi o cheie de partener

Spune-ne pe ce piețe vinzi și de ce paneluri ai nevoie, iar noi îți vom trimite o cheie cu permisiunile potrivite.

Poți descărca și fișierul OpenAPI

Această pagină este o machetă de design. Fiecare endpoint și payload de pe pagină provine de pe docs.anivahealth.com, iar diagrama de pipeline este ilustrativă.

Copiile citibile automat ale documentației se află la docs.anivahealth.com/llms.txt și docs.anivahealth.com/llms-full.txt.