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
45 punktów końcowych jest dziś udokumentowanych i aktywnych
Uwierzytelnianie wymaga tylko jednego nagłówka żądania
Każda ścieżka zaczyna się od prefiksu v1
Placówki w Niemczech mogą wykonać pobranie krwi
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.
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.
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.
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.
Potwierdzasz pobranie krwi kodem kreskowym zestawu
To żądanie uruchamia zlecenie laboratoryjne i blokuje wizytę, więc zmień każdy panel, zanim je wyślesz.
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.
Profil to osoba, którą badasz
Wyszukujesz profil po adresie e-mail, tworzysz go w swojej grupie profili, a dane demograficzne aktualizujesz później.
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.
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.
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.
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.
Kurier zawozi próbkę do laboratorium
Tworzysz zlecenie kurierskie z oknem odbioru w dzień roboczy, a potem przypisujesz wizyty i sprawdzasz aktualizacje jego statusu.
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.
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.
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.
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.
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.
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.
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.
Poproś nas o klucz partnerski już dziś
Powiedz nam, na jakich rynkach sprzedajesz i jakich paneli potrzebujesz, a wyślemy klucz z odpowiednimi uprawnieniami.
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.