Bestill blodprøver fra ditt eget produkt

Én API-nøkkel gir deg 45 endepunkter, fra bestilling til labresultater

Aniva Partner API bestiller en blodprøvetaking på over 25 lokasjoner i Tyskland, legger til paneler på den timen og returnerer kliniske og genetiske resultater som JSON. Hver forespørsel trenger én header, og basis-URL-en er den samme i alle miljøer.

Når du bør bruke Aniva

Bruk Aniva når kundene dine trenger å få bestilt en blodprøve
Bruk endepunktene for time til blodprøvetaking på klinikk, og endepunktene for hjemmetestsett til et sett i posten.
Bruk endepunktene for resultater til kliniske rader, genetiske rader og PDF-rapporten.
Bruk katalogendepunktene for å lese biomarkørene, panelene og enhetene Aniva selger.
Bruk de dokumenterte stiene under https://anivahealth.com/api/v1/ og ikke finn på egne endepunkter.
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"
  }'
Grunnflyten består av fire forespørsler
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 endepunkter er dokumentert og i drift i dag

1

Autentisering krever bare én forespørselsheader

v1

Hver sti starter med prefikset v1

25+

Lokasjoner i Tyskland kan utføre blodprøvetakingen

Fire forespørsler gir en fungerende integrasjon

Fire forespørsler går fra bestilling til laboratorieresultater

Hver forespørsel returnerer ID-en som den neste trenger, så en grunnleggende integrasjon består av fire forespørsler før du legger til paneler, timeendringer eller bud.

Steg 01 · GET /locations

Du lister opp stedene nøkkelen din kan bestille hos

Svaret gir deg hver adresse, åpningstidene og tidssonen, slik at en kunde bare ser tider som finnes.

Tester
Steg 02 · POST /profiles

Du oppretter en profil for kunden

En profil trenger et navn, en kjønnskode, en fødselsdato og din profile_group, som godtar en UUID eller din egen slug.

Tester
Steg 03 · POST /appointments

Du bestiller timen på et valgt tidspunkt

Bestillingen trenger profil-ID, lokasjons-ID og dato og klokkeslett i ISO 8601-format med tidssoneforskyvning eller Z-suffikset.

Tester
Steg 04 · POST /appointments/{id}/confirm

Du bekrefter blodprøvetakingen med strekkoden på prøvesettet

Denne forespørselen starter laboratoriebestillingen og låser timen, så endre alle paneler før du sender den.

Tester
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"
  }'
Funksjonalitet

Hver ressursgruppe er én REST-samling

Du kan bestille blodprøvetaking på en klinikk eller et hjemmetestsett i posten. Begge kommer tilbake i samme format, så du skriver koden som leser resultater bare én gang.

Profiler · 4 endepunkter

En profil er personen du tester

Du slår opp en profil på e-post, oppretter den under profilgruppen din og oppdaterer demografidata senere.

Tester
GET /profiles
PATCH /profiles/{id}
Timer · 15 endepunkter

En time inneholder panelene og blodprøvetakingen

Femten endepunkter dekker bestillingen og alle senere endringer i den, inkludert paneler, forhåndsvisninger av prøvebeholdere og bekreftelsen.

Tester
POST /appointments
GET /appointments/{id}/results
Bestillinger av hjemmetestsett · 10 endepunkter

Bestillinger av hjemmetestsett er postversjonen

Ti endepunkter bestiller et hjemmetestsett for en profil, endrer panelene og returnerer samme resultatstruktur.

Tester
Opprett en bestilling av prøvesett
Få resultater
Steder · 2 endepunkter

Steder viser deg hvor en blodprøvetaking skjer

Du leser stedene nøkkelen din kan bestille på, og ber deretter ett av dem om bestillbare starttidspunkter.

Tester
GET /locations
GET /locations/{id}/availability
Dokumenter · 1 endepunkt

Resultatene kommer tilbake som kliniske og genetiske rader

Hver bestillingstype har sitt eget resultatkall, og PDF-rapporten er én separat nedlasting via fil-ID.

Tester
GET /appointments/{id}/results
GET /documents/{id}
Forsendelser · 8 endepunkter

Et bud tar prøven til laboratoriet

Du oppretter en budbestilling med et hentevindu på hverdager, legger deretter til timer og leser statusoppdateringene.

Tester
POST /shipments
Knytt til timer
Kataloger · 4 endepunkter

Kataloger lister opp biomarkørene du kan bestille

Katalogene for biomarkører, paneler og enheter er paginerte, og du kan filtrere biomarkører etter teststed.

Tester
GET /biomarkers
GET /panels
Helse · 1 endepunkt

Ett readiness-endepunkt trenger ingen API-nøkkel

Readiness-proben trenger ingen API-nøkkel, så oppetidsovervåkingen din kan kalle den etter en tidsplan.

Tester
Offentlig beredskapsprobe
Arbeidet ditt slutter ved strekkodebekreftelsen

Labprosessen starter når du bekrefter blodprøvetakingen

Du sender oss strekkoden på settet, og det er det siste vi trenger fra deg. Deretter ordner vi beholderne, budet og laboratoriet, så koden din kaller bare to endepunkter til rapporten er klar.

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
En fylt prikk er ruten du vil ha.En ring er en tilstand du fortsatt håndterer.Oransje linjer er den bekreftede bestillingen.
Én parser leser blodprøvetaking på klinikk og hjemmetestsett

Hvert resultat har to referanseområder og fire statuser

Hver klinisk rad har området laboratoriet rapporterte og Aniva-området med det optimale vinduet, slik at du kan vise begge uten å vedlikeholde din egen oppslagstabell.

En rad viser planlagt før laboratoriet analyserer den.
En rad viser mottatt så snart en verdi og en enhet kommer tilbake.
En rad viser fault når laboratoriet kansellerte bestillingen, og status_reason forklarer det.
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-et bruker tre tidsformater

Dato og klokkeslett må ha en tidssone, ellers feiler forespørselen

En naiv datetime avvises med 400, som er den ene feilen de fleste førstegangsintegrasjoner gjør.

Tidsstempler kommer alltid tilbake som UTC, med ISO 8601 og Z-suffikset.
Inndata må inneholde en eksplisitt tidssoneforskyvning, så en bestilling godtar 2026-05-15T12:30:00+02:00.
Forsendelsesoppdateringer beholder forskyvningen som logistikkleverandøren rapporterte.
Kalenderfelt bruker kun lokal klokketid, som en fødselsdato.
Aniva utsteder og roterer alle partnernøkler

Hver forespørsel trenger partner-API-nøkkelen din

Autentisering bruker headeren x-api-key i hvert kall, og en manglende eller rotert nøkkel returnerer 403 med en kort JSON-feil.

Nøkkelen din avgjør hvilke steder, timer og forsendelser du kan se.
Eksponer aldri API-nøkkelen din i klientsidekode eller offentlige repositorier.
En offentlig probe trenger ingen API-nøkkel

Du kan følge med på hver tjeneste på statussiden

Statussiden viser gjeldende status og 90 dagers historikk for hver tjeneste, og de samme dataene er tilgjengelige som JSON for din egen overvåking.

Partnernøkler utstedes av teamet vårt

Be oss om en partnernøkkel i dag

Fortell oss hvilke markeder du selger i og hvilke paneler du trenger, så sender vi en nøkkel med riktige tilganger.

Du kan også laste ned OpenAPI-filen

Denne siden er en designskisse. Hvert endepunkt og hver payload på den er hentet fra docs.anivahealth.com, og pipeline-diagrammet er illustrativt.

Maskinlesbare kopier av dokumentasjonen finnes på docs.anivahealth.com/llms.txt og docs.anivahealth.com/llms-full.txt.