Rezerwuj badania krwi prosto ze swojego produktu

Jeden klucz API daje ci 45 endpointów, od rezerwacji po wyniki laboratoryjne

Aniva Partner API rezerwuje pobranie krwi w ponad 25 lokalizacjach w Niemczech, dodaje panele do tej wizyty i zwraca wyniki kliniczne oraz genetyczne jako JSON. Każde żądanie wymaga jednego nagłówka, a bazowy URL jest taki sam w każdym środowisku.

Kiedy korzystać z Aniva

Korzystaj z Aniva, gdy twoi klienci potrzebują rezerwacji badania krwi
Użyj endpointów wizyt do pobrania krwi w klinice, a endpointów domowego zestawu testowego do zestawu wysyłanego pocztą.
Użyj endpointów wyników dla wierszy klinicznych, wierszy genetycznych i raportu PDF.
Użyj endpointów katalogu, aby odczytać biomarkery, panele i jednostki, które sprzedaje Aniva.
Używaj udokumentowanych ścieżek pod adresem https://anivahealth.com/api/v1/ i nie wymyślaj endpointów.
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"
  }'
Podstawowy przepływ to cztery zapytania
GET /locations POST /profiles POST /appointments POST /appointments/{id}/confirm
45

45 punktów końcowych jest dziś udokumentowanych i aktywnych

1

Uwierzytelnianie wymaga tylko jednego nagłówka żądania

v1

Każda ścieżka zaczyna się od prefiksu v1

25+

Placówki w Niemczech mogą wykonać pobranie krwi

Cztery zapytania tworzą działającą integrację

Cztery żądania prowadzą od rezerwacji do wyników z laboratorium

Każde żądanie zwraca ID potrzebne kolejnemu, więc podstawowa integracja to cztery żądania, zanim dodasz panele, zmiany terminu lub kurierów.

Krok 01 · GET /locations

Podajesz lokalizacje, w których twój klucz może rezerwować terminy

W odpowiedzi otrzymujesz każdy adres, godziny otwarcia i strefę czasową, dzięki czemu klient widzi tylko istniejące terminy.

Badania
Krok 02 · POST /profiles

Tworzysz profil klienta

Profil wymaga imienia i nazwiska, kodu płci, daty urodzenia oraz twojego profile_group, które przyjmuje UUID lub własny slug.

Badania
Krok 03 · POST /appointments

Rezerwujesz wizytę w wybranym terminie

Rezerwacja wymaga ID profilu, ID lokalizacji oraz daty i godziny w formacie ISO 8601 z przesunięciem strefy czasowej lub sufiksem Z.

Badania
Krok 04 · POST /appointments/{id}/confirm

Potwierdzasz pobranie krwi kodem kreskowym zestawu

To żądanie uruchamia zlecenie laboratoryjne i blokuje wizytę, więc zmień każdy panel, zanim je wyślesz.

Badania
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"
  }'
Możliwość

Każda grupa zasobów to jedna kolekcja REST

Możesz zamówić pobranie krwi w klinice lub domowy zestaw testowy pocztą. Oba wracają w tym samym formacie, więc kod do odczytywania wyników piszesz tylko raz.

Profile · 4 endpointy

Profil to osoba, którą badasz

Wyszukujesz profil po adresie e-mail, tworzysz go w swojej grupie profili, a dane demograficzne aktualizujesz później.

Badania
GET /profiles
PATCH /profiles/{id}
Wizyty · 15 endpointów

Wizyta obejmuje panele i pobranie krwi

Piętnaście endpointów obejmuje rezerwację i każdą późniejszą zmianę, w tym panele, podgląd pojemników i potwierdzenie.

Badania
POST /appointments
GET /appointments/{id}/results
Zamówienia domowych zestawów testowych · 10 endpointów

Zamówienia domowych zestawów testowych to wersja wysyłkowa

Dziesięć endpointów zamawia zestaw DIY dla profilu, zmienia jego panele i zwraca taką samą strukturę wyników.

Badania
Utwórz zamówienie na zestaw
Odbierz wyniki
Lokalizacje · 2 endpointy

Lokalizacje pokazują, gdzie odbywa się pobranie krwi

Odczytujesz lokalizacje, które twój klucz może rezerwować, a następnie pytasz jedną z nich o dostępne godziny rozpoczęcia terminów.

Badania
GET /locations
GET /locations/{id}/availability
Dokumenty · 1 endpoint

Wyniki wracają jako wiersze kliniczne i genetyczne

Każdy typ zlecenia ma własne zapytanie o wyniki, a raport PDF to osobne pobranie po ID pliku.

Badania
GET /appointments/{id}/results
GET /documents/{id}
Przesyłki · 8 punktów końcowych

Kurier zawozi próbkę do laboratorium

Tworzysz zlecenie kurierskie z oknem odbioru w dzień roboczy, a potem przypisujesz wizyty i sprawdzasz aktualizacje jego statusu.

Badania
POST /shipments
Dołącz wizyty
Katalogi · 4 punkty końcowe

Katalogi zawierają listę biomarkerów, które możesz zamówić

Katalogi biomarkerów, paneli i jednostek są podzielone na strony, a biomarkery możesz filtrować według lokalizacji badania.

Badania
GET /biomarkers
GET /panels
Zdrowie · 1 endpoint

Jeden endpoint gotowości nie wymaga klucza API

Sonda gotowości nie wymaga klucza API, więc twój monitor dostępności może ją wywoływać według harmonogramu.

Badania
Publiczna sonda gotowości
Twoja praca kończy się na potwierdzeniu kodu kreskowego

Proces laboratoryjny rusza, gdy potwierdzisz pobranie krwi

Wysyłasz nam kod kreskowy zestawu i to ostatnia rzecz, jakiej od ciebie potrzebujemy. Następnie organizujemy pojemniki, kuriera i laboratorium, więc twój kod wywołuje tylko dwa endpointy, aż raport będzie gotowy.

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
Pełna kropka to pożądana ścieżka.Okrąg to stan, który nadal obsługujesz.Pomarańczowe linie to potwierdzone zamówienie.
Jeden parser obsługuje pobranie krwi w klinice i domowy zestaw testowy

Każdy wynik ma dwa zakresy referencyjne i cztery statusy

Każdy wiersz kliniczny zawiera zakres podany przez laboratorium oraz zakres Aniva z optymalnym przedziałem, dzięki czemu możesz wyświetlić oba bez utrzymywania własnej tabeli wyszukiwania.

Wiersz wyświetla status zaplanowane, zanim laboratorium go przeanalizuje.
Wiersz pokazuje status odebrano, gdy tylko wpłyną wartość i jednostka.
W wierszu pojawia się fault, gdy laboratorium anulowało zlecenie, a status_reason to wyjaśnia.
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 korzysta z trzech formatów czasu

Daty z godziną wymagają strefy czasowej, inaczej zapytanie zakończy się błędem

Data i godzina bez strefy czasowej są odrzucane z kodem 400, co jest najczęstszym błędem w większości pierwszych integracji.

Znaczniki czasu są zawsze zwracane w UTC, w formacie ISO 8601 z sufiksem Z.
Dane wejściowe muszą zawierać jawne przesunięcie czasowe, więc rezerwacja akceptuje 2026-05-15T12:30:00+02:00.
Aktualizacje przesyłki zachowują przesunięcie czasowe przekazane przez operatora logistycznego.
Pola kalendarzowe używają wyłącznie czasu lokalnego, na przykład data urodzenia.
Aniva wydaje i rotuje każdy klucz partnerski

Każde żądanie wymaga twojego partnerskiego klucza API

Uwierzytelnianie korzysta z nagłówka x-api-key w każdym zapytaniu, a brakujący lub zrotowany klucz zwraca 403 z krótkim błędem JSON.

Twój klucz decyduje, które lokalizacje, wizyty i przesyłki możesz zobaczyć.
Nigdy nie ujawniaj swojego klucza API w kodzie po stronie klienta ani w publicznych repozytoriach.
Publiczna sonda nie wymaga klucza API

Możesz śledzić każdą usługę na stronie statusu

Strona statusu pokazuje bieżący stan i 90 dni historii dla każdej usługi, a te same dane są dostępne w formacie JSON dla twojego własnego monitoringu.

Klucze partnerskie wydaje nasz zespół

Poproś nas o klucz partnerski już dziś

Powiedz nam, na jakich rynkach sprzedajesz i jakich paneli potrzebujesz, a wyślemy klucz z odpowiednimi uprawnieniami.

Możesz też pobrać plik OpenAPI

Ta strona to makieta projektu. Każdy endpoint i payload na tej stronie pochodzi z docs.anivahealth.com, a schemat przepływu ma charakter poglądowy.

Wersje dokumentacji do odczytu maszynowego znajdziesz pod adresami docs.anivahealth.com/llms.txt i docs.anivahealth.com/llms-full.txt.