Én API-nøkkel gir deg 45 endepunkter, fra bestilling til labresultater
Aniva Partner API bestiller en blodprøvetaking på over 25 lokasjoner i Tyskland, legger til paneler på den timen og returnerer kliniske og genetiske resultater som JSON. Hver forespørsel trenger én header, og basis-URL-en er den samme i alle miljøer.
Når du bør bruke Aniva
45 endepunkter er dokumentert og i drift i dag
Autentisering krever bare én forespørselsheader
Hver sti starter med prefikset v1
Lokasjoner i Tyskland kan utføre blodprøvetakingen
Fire forespørsler går fra bestilling til laboratorieresultater
Hver forespørsel returnerer ID-en som den neste trenger, så en grunnleggende integrasjon består av fire forespørsler før du legger til paneler, timeendringer eller bud.
Du lister opp stedene nøkkelen din kan bestille hos
Svaret gir deg hver adresse, åpningstidene og tidssonen, slik at en kunde bare ser tider som finnes.
Du oppretter en profil for kunden
En profil trenger et navn, en kjønnskode, en fødselsdato og din profile_group, som godtar en UUID eller din egen slug.
Du bestiller timen på et valgt tidspunkt
Bestillingen trenger profil-ID, lokasjons-ID og dato og klokkeslett i ISO 8601-format med tidssoneforskyvning eller Z-suffikset.
Du bekrefter blodprøvetakingen med strekkoden på prøvesettet
Denne forespørselen starter laboratoriebestillingen og låser timen, så endre alle paneler før du sender den.
Hver ressursgruppe er én REST-samling
Du kan bestille blodprøvetaking på en klinikk eller et hjemmetestsett i posten. Begge kommer tilbake i samme format, så du skriver koden som leser resultater bare én gang.
En profil er personen du tester
Du slår opp en profil på e-post, oppretter den under profilgruppen din og oppdaterer demografidata senere.
En time inneholder panelene og blodprøvetakingen
Femten endepunkter dekker bestillingen og alle senere endringer i den, inkludert paneler, forhåndsvisninger av prøvebeholdere og bekreftelsen.
Bestillinger av hjemmetestsett er postversjonen
Ti endepunkter bestiller et hjemmetestsett for en profil, endrer panelene og returnerer samme resultatstruktur.
Steder viser deg hvor en blodprøvetaking skjer
Du leser stedene nøkkelen din kan bestille på, og ber deretter ett av dem om bestillbare starttidspunkter.
Resultatene kommer tilbake som kliniske og genetiske rader
Hver bestillingstype har sitt eget resultatkall, og PDF-rapporten er én separat nedlasting via fil-ID.
Et bud tar prøven til laboratoriet
Du oppretter en budbestilling med et hentevindu på hverdager, legger deretter til timer og leser statusoppdateringene.
Kataloger lister opp biomarkørene du kan bestille
Katalogene for biomarkører, paneler og enheter er paginerte, og du kan filtrere biomarkører etter teststed.
Ett readiness-endepunkt trenger ingen API-nøkkel
Readiness-proben trenger ingen API-nøkkel, så oppetidsovervåkingen din kan kalle den etter en tidsplan.
Labprosessen starter når du bekrefter blodprøvetakingen
Du sender oss strekkoden på settet, og det er det siste vi trenger fra deg. Deretter ordner vi beholderne, budet og laboratoriet, så koden din kaller bare to endepunkter til rapporten er klar.
Hvert resultat har to referanseområder og fire statuser
Hver klinisk rad har området laboratoriet rapporterte og Aniva-området med det optimale vinduet, slik at du kan vise begge uten å vedlikeholde din egen oppslagstabell.
Dato og klokkeslett må ha en tidssone, ellers feiler forespørselen
En naiv datetime avvises med 400, som er den ene feilen de fleste førstegangsintegrasjoner gjør.
Hver forespørsel trenger partner-API-nøkkelen din
Autentisering bruker headeren x-api-key i hvert kall, og en manglende eller rotert nøkkel returnerer 403 med en kort JSON-feil.
Du kan følge med på hver tjeneste på statussiden
Statussiden viser gjeldende status og 90 dagers historikk for hver tjeneste, og de samme dataene er tilgjengelige som JSON for din egen overvåking.
Be oss om en partnernøkkel i dag
Fortell oss hvilke markeder du selger i og hvilke paneler du trenger, så sender vi en nøkkel med riktige tilganger.
Denne siden er en designskisse. Hvert endepunkt og hver payload på den er hentet fra docs.anivahealth.com, og pipeline-diagrammet er illustrativt.
Maskinlesbare kopier av dokumentasjonen finnes på docs.anivahealth.com/llms.txt og docs.anivahealth.com/llms-full.txt.