Jedan API ključ ti daje 45 krajnjih tačaka, od zakazivanja do laboratorijskih rezultata
Aniva Partner API zakazuje vađenje krvi na više od 25 lokacija u Nemačkoj, dodaje panele u taj termin i vraća kliničke i genetske rezultate u JSON formatu. Svakom zahtevu je potrebno jedno zaglavlje, a osnovni URL je isti u svakom okruženju.
Kada koristiti Aniva
45 krajnjih tačaka je dokumentovano i aktivno danas
Za autentifikaciju je potrebno samo jedno zaglavlje zahteva
Svaka putanja počinje prefiksom v1
Lokacije u Nemačkoj mogu da urade vađenje krvi
Četiri zahteva vode od zakazivanja do laboratorijskih rezultata
Svaki zahtev vraća ID koji je potreban sledećem, pa osnovna integracija ima četiri zahteva pre nego što dodaš panele, promene termina ili kurire.
Navodiš lokacije za koje tvoj ključ može da zakazuje
Odgovor ti daje svaku adresu, radno vreme i vremensku zonu, tako da klijent vidi samo termine koji postoje.
Kreiraš profil za klijenta
Profilu su potrebni ime, oznaka pola, datum rođenja i tvoj profile_group, koji prihvata UUID ili tvoj sopstveni slug.
Zakažeš termin za vreme koje izabereš
Za zakazivanje su potrebni ID profila, ID lokacije i datum i vreme u ISO 8601 formatu sa vremenskim pomerajem ili sufiksom Z.
Potvrđuješ vađenje krvi barkodom kompleta
Ovaj zahtev pokreće laboratorijski nalog i zaključava termin, pa izmeni sve panele pre nego što ga pošalješ.
Svaka grupa resursa je jedna REST kolekcija
Možeš da naručiš vađenje krvi u klinici ili komplet za kućno testiranje poštom. Oba se vraćaju u istom formatu, tako da kod za čitanje rezultata pišeš samo jednom.
Profil je osoba koju testiraš
Pronađeš profil po imejlu, kreiraš ga u okviru svoje grupe profila i kasnije dopuniš demografske podatke.
Termin obuhvata panele i vađenje krvi
Petnaest krajnjih tačaka pokriva zakazivanje i svaku kasniju izmenu, uključujući panele, pregled posuda za uzorke i potvrdu.
Porudžbine kompleta za kućno testiranje su poštanska verzija
Deset krajnjih tačaka traži DIY komplet za profil, menja njegove panele i vraća istu strukturu rezultata.
Lokacije ti pokazuju gde se obavlja vađenje krvi
Prvo učitaš lokacije na kojima tvoj ključ može da zakazuje, a zatim od jedne od njih zatražiš početke dostupnih termina.
Rezultati stižu kao klinički i genetski redovi
Svaki tip porudžbine ima sopstveni poziv za rezultate, a PDF izveštaj se preuzima zasebno pomoću ID-a fajla.
Kurir nosi uzorak u laboratoriju
Kreiraš nalog za kurira sa vremenskim okvirom za preuzimanje radnim danom, zatim pridružiš termine i pratiš promene njegovog statusa.
Katalozi navode biomarkere koje možeš da naručiš
Katalozi biomarkera, panela i jedinica podeljeni su na stranice, a biomarkere možeš filtrirati prema lokaciji testiranja.
Jedan endpoint za proveru spremnosti ne zahteva API ključ
Provera spremnosti ne zahteva API ključ, pa tvoj monitor dostupnosti može da je poziva po rasporedu.
Laboratorijski proces počinje kada potvrdiš vađenje krvi
Pošalješ nam bar-kod kompleta i to je poslednje što nam treba od tebe. Mi zatim organizujemo posude, kurira i laboratoriju, tako da tvoj kod poziva samo dva endpointa dok izveštaj ne bude spreman.
Svaki rezultat ima dva referentna opsega i četiri statusa
Svaki klinički red sadrži opseg koji je laboratorija navela i Aniva opseg sa njegovim optimalnim rasponom, tako da možeš da prikažeš oba bez vođenja sopstvene referentne tabele.
Datumi i vremena moraju imati vremensku zonu, inače zahtev ne uspeva
Datetime bez vremenske zone odbija se sa 400, što je jedina greška koju pravi većina prvih integracija.
Za svaki zahtev potreban je tvoj partnerski API ključ
Autentifikacija koristi zaglavlje x-api-key pri svakom pozivu, a nedostajući ili rotirani ključ vraća 403 sa kratkom JSON greškom.
Svaku uslugu možeš da pratiš na stranici statusa
Stranica statusa prikazuje trenutno stanje i istoriju za 90 dana za svaku uslugu, a isti podaci su dostupni u JSON formatu za tvoj sopstveni nadzor.
Zatraži od nas partnerski ključ danas
Reci nam na kojim tržištima prodaješ i koji su ti paneli potrebni, i poslaćemo ti ključ sa odgovarajućim dozvolama.
Ova stranica je dizajnerski prototip. Svaki endpoint i payload na njoj preuzet je sa docs.anivahealth.com, a dijagram toka je ilustrativan.
Mašinski čitljive kopije dokumentacije nalaze se na docs.anivahealth.com/llms.txt i docs.anivahealth.com/llms-full.txt.