En ključ API ti omogoča 45 končnih točk, od rezervacije do laboratorijskih rezultatov
Aniva Partner API rezervira odvzem krvi na več kot 25 lokacijah v Nemčiji, temu terminu doda panele ter vrne klinične in genetske rezultate v obliki JSON. Vsak zahtevek potrebuje eno glavo, osnovni URL pa je v vsakem okolju enak.
Kdaj uporabiti Anivo
Danes je dokumentiranih in aktivnih 45 končnih točk
Avtentikacija potrebuje le eno glavo zahtevka
Vsaka pot se začne s predpono v1
Nemške lokacije lahko opravijo odvzem krvi
Štirje zahtevki vodijo od rezervacije do laboratorijskih rezultatov
Vsak zahtevek vrne ID, ki ga potrebuje naslednji, zato osnovna integracija obsega štiri zahtevke, še preden dodaš panele, prestavitve terminov ali kurirje.
Navedeš lokacije, ki jih lahko tvoj ključ rezervira
Odgovor ti vrne vsak naslov, delovni čas in časovni pas, zato stranka vidi le termine, ki dejansko obstajajo.
Ustvariš profil za stranko
Profil potrebuje ime, kodo spola, datum rojstva in tvoj profile_group, ki sprejme UUID ali tvoj lastni slug.
Termin rezerviraš ob izbrani uri
Rezervacija potrebuje ID profila, ID lokacije ter datum in čas v formatu ISO 8601 z odmikom ali pripono Z.
Odvzem krvi potrdiš s črtno kodo kompleta
Ta zahteva sproži laboratorijsko naročilo in zaklene termin, zato spremeni vse panele, preden jo pošlješ.
Vsaka skupina virov je ena zbirka REST
Naročiš lahko odvzem krvi v ambulanti ali domači testni komplet po pošti. Oba se vrneta v isti obliki, zato kodo za branje rezultatov napišeš le enkrat.
Profil je oseba, ki jo testiraš
Profil poiščeš po e-pošti, ga ustvariš v svoji skupini profilov in pozneje dopolniš demografske podatke.
Termin vključuje panele in odvzem krvi
Petnajst končnih točk pokriva rezervacijo in vsako poznejšo spremembo, vključno s paneli, predogledi vsebnikov in potrditvijo.
Naročila domačih testnih kompletov so poštna različica
Deset končnih točk zahteva komplet za domačo uporabo za profil, spremeni njegove panele in vrne enako obliko rezultatov.
Lokacije ti povedo, kje poteka odvzem krvi
Prebereš lokacije, ki jih tvoj ključ lahko rezervira, nato pa pri eni od njih zaprosiš za začetke razpoložljivih terminov.
Rezultati prispejo kot klinične in genetske vrstice
Vsaka vrsta naročila ima svoj klic za rezultate, poročilo PDF pa je ločen prenos po ID-ju datoteke.
Kurir odnese vzorec v laboratorij
Ustvariš kurirsko naročilo s časovnim oknom prevzema med tednom, nato dodaš termine in spremljaš posodobitve statusa.
Katalogi navajajo biomarkerje, ki jih lahko naročiš
Katalogi biomarkerjev, panelov in enot so razdeljeni na strani, biomarkerje pa lahko filtriraš po lokaciji testiranja.
Ena končna točka pripravljenosti ne potrebuje ključa API
Preverjanje pripravljenosti ne potrebuje ključa API, zato ga tvoj sistem za spremljanje delovanja lahko kliče po urniku.
Laboratorijski postopek se začne, ko potrdiš odvzem krvi
Pošlješ nam črtno kodo kompleta in to je zadnja stvar, ki jo potrebujemo od tebe. Nato uredimo posodice, kurirja in laboratorij, tako da tvoja koda pokliče le dve končni točki, dokler ni izvid pripravljen.
Vsak rezultat ima dve referenčni območji in štiri statuse
Vsaka klinična vrstica vsebuje območje, ki ga je sporočil laboratorij, in območje Aniva z optimalnim razponom, tako da lahko prikažeš obe brez vzdrževanja lastne referenčne tabele.
Datumi in časi potrebujejo časovni pas, sicer zahteva ne uspe
Naiven zapis datuma in časa se zavrne s 400, kar je glavna napaka, ki jo naredi večina prvih integracij.
Vsak zahtevek potrebuje tvoj partnerski ključ API
Avtentikacija pri vsakem klicu uporablja glavo x-api-key, manjkajoči ali zamenjani ključ pa vrne 403 s kratko napako JSON.
Vsako storitev lahko spremljaš na statusni strani
Stran s stanjem prikazuje trenutno stanje in 90 dni zgodovine za vsako storitev, isti podatki pa so na voljo kot JSON za tvoj lastni nadzor.
Zaprosi nas za partnerski ključ še danes
Povej nam, na katerih trgih prodajaš in katere panele potrebuješ, in poslali ti bomo ključ s pravimi dovoljenji.
Ta stran je oblikovni osnutek. Vsaka končna točka in podatkovna vsebina na njej je povzeta iz docs.anivahealth.com, diagram poteka pa je ilustrativen.
Strojno berljivi kopiji dokumentacije sta na docs.anivahealth.com/llms.txt in docs.anivahealth.com/llms-full.txt.