O singură cheie API îți oferă 45 de endpoint-uri, de la programare până la rezultatele de laborator
Aniva Partner API programează o recoltare de sânge în peste 25 de locații din Germania, adaugă paneluri la acea programare și returnează rezultate clinice și genetice în format JSON. Fiecare cerere are nevoie de un singur header, iar URL-ul de bază este același în orice mediu.
Când să folosești Aniva
45 de endpoint-uri sunt documentate și active astăzi
Autentificarea are nevoie de un singur antet de cerere
Fiecare cale începe cu prefixul v1
Locațiile din Germania pot face recoltarea de sânge
Patru cereri duc de la programare la rezultatele de laborator
Fiecare cerere returnează ID-ul de care are nevoie următoarea, așa că o integrare de bază înseamnă patru cereri înainte să adaugi paneluri, reprogramări sau curieri.
Listezi locațiile pe care cheia ta le poate programa
Răspunsul îți oferă fiecare adresă, programul și fusul orar, așa că un client vede doar intervalele care există.
Creezi un profil pentru client
Un profil are nevoie de un nume, un cod de sex, o dată de naștere și parametrul tău profile_group, care acceptă un UUID sau propriul tău slug.
Faci programarea în intervalul ales
Programarea necesită ID-ul profilului, ID-ul locației și o dată și oră în format ISO 8601 cu decalajul aferent sau sufixul Z.
Confirmi recoltarea de sânge cu codul de bare al kitului
Această cerere inițiază comanda de laborator și blochează programarea, așa că modifică fiecare panel înainte de a o trimite.
Fiecare grup de resurse este o colecție REST
Poți comanda o recoltare de sânge la o clinică sau un kit de testare la domiciliu prin poștă. Ambele revin în același format, așa că scrii o singură dată codul care citește rezultatele.
Un profil este persoana pe care o testezi
Cauți un profil după e-mail, îl creezi în grupul tău de profiluri și actualizezi datele demografice ulterior.
O programare include panelurile și recoltarea de sânge
Cincisprezece endpoint-uri acoperă programarea și orice modificare ulterioară a acesteia, inclusiv panelurile, previzualizările recipientelor și confirmarea.
Comenzile de kit de testare la domiciliu sunt varianta prin poștă
Zece endpoint-uri solicită un kit DIY pentru un profil, îi modifică panelurile și returnează aceeași structură a rezultatelor.
Locațiile îți arată unde are loc recoltarea de sânge
Citești locațiile pe care le poate programa cheia ta, apoi soliciți de la una dintre ele orele de începere ale intervalelor disponibile.
Rezultatele vin sub formă de rânduri clinice și genetice
Fiecare tip de comandă are propriul apel pentru rezultate, iar raportul PDF este o descărcare separată după ID-ul fișierului.
Un curier duce proba la laborator
Creezi o comandă de curierat cu un interval de ridicare în timpul săptămânii, apoi atașezi programările și vezi actualizările de status.
Cataloagele enumeră biomarkerii pe care îi poți comanda
Cataloagele de biomarkeri, paneluri și unități sunt paginate și poți filtra biomarkerii după locația de testare.
Un endpoint de disponibilitate nu necesită cheie API
Verificarea de disponibilitate nu are nevoie de cheie API, așa că monitorul tău de uptime o poate apela după un program.
Fluxul de laborator începe când confirmi recoltarea de sânge
Ne trimiți codul de bare al kitului, iar acesta este ultimul lucru de care avem nevoie de la tine. Apoi organizăm recipientele, curierul și laboratorul, astfel încât codul tău apelează doar două endpoint-uri până când raportul este gata.
Fiecare rezultat are două intervale de referință și patru statusuri
Fiecare rând clinic conține intervalul raportat de laborator și intervalul Aniva cu fereastra sa optimă, astfel încât le poți afișa pe ambele fără să menții propriul tabel de corespondență.
Valorile de dată și oră au nevoie de un fus orar, altfel cererea eșuează
O valoare datetime fără fus orar este respinsă cu 400, greșeala pe care o fac cel mai des primele integrări.
Fiecare cerere necesită cheia ta API de partener
Autentificarea folosește antetul x-api-key la fiecare apel, iar o cheie lipsă sau rotită returnează 403 cu o scurtă eroare JSON.
Poți urmări fiecare serviciu pe pagina de status
Pagina de stare arată starea curentă și 90 de zile de istoric pentru fiecare serviciu, iar aceleași date sunt disponibile ca JSON pentru propriul tău sistem de monitorizare.
Cere-ne astăzi o cheie de partener
Spune-ne pe ce piețe vinzi și de ce paneluri ai nevoie, iar noi îți vom trimite o cheie cu permisiunile potrivite.
Această pagină este o machetă de design. Fiecare endpoint și payload de pe pagină provine de pe docs.anivahealth.com, iar diagrama de pipeline este ilustrativă.
Copiile citibile automat ale documentației se află la docs.anivahealth.com/llms.txt și docs.anivahealth.com/llms-full.txt.