Jeden API klíč ti dá 45 endpointů, od rezervace až po laboratorní výsledky
Aniva Partner API rezervuje odběr krve na více než 25 místech v Německu, přidá k tomuto termínu panely a vrátí klinické i genetické výsledky ve formátu JSON. Každý požadavek vyžaduje jednu hlavičku a základní URL je v každém prostředí stejná.
Kdy využít Aniva
45 endpointů je dnes zdokumentováno a v provozu
Autentizace potřebuje jen jednu hlavičku požadavku
Každá cesta začíná předponou v1
Pobočky v Německu mohou provést odběr krve
Od rezervace k výsledkům z laboratoře vedou čtyři požadavky
Každý požadavek vrátí ID, které potřebuje ten další, takže základní integrace jsou čtyři požadavky, než přidáš panely, přeplánování nebo kurýry.
Uvedeš místa, která může tvůj klíč rezervovat
Odpověď ti vrátí každou adresu, otevírací dobu i časové pásmo, takže zákazník vidí jen termíny, které skutečně existují.
Vytvoříš pro zákazníka profil
Profil potřebuje jméno, kód pohlaví, datum narození a tvoje profile_group, které přijímá UUID nebo tvůj vlastní slug.
Rezervuješ si termín ve zvoleném čase
Rezervace potřebuje ID profilu, ID místa a datum s časem ve formátu ISO 8601 včetně časového posunu nebo přípony Z.
Odběr krve potvrdíš čárovým kódem ze sady
Tento požadavek zahájí laboratorní objednávku a uzamkne termín, proto každý panel uprav před odesláním.
Každá skupina zdrojů je jedna kolekce REST
Můžeš objednat odběr krve na klinice nebo domácí testovací sadu poštou. Obojí se vrátí ve stejném formátu, takže kód pro čtení výsledků napíšeš jen jednou.
Profil je osoba, kterou testuješ
Vyhledáš profil podle e-mailu, vytvoříš ho ve své skupině profilů a demografické údaje aktualizuješ později.
Termín zahrnuje panely i odběr krve
Patnáct endpointů pokrývá rezervaci i každou její pozdější změnu, včetně panelů, náhledů odběrových nádobek a potvrzení.
Objednávky domácích testovacích sad jsou poštovní verzí
Deset endpointů vyžádá pro profil domácí sadu, změní jeho panely a vrátí stejnou strukturu výsledku.
Lokality ti ukážou, kde probíhá odběr krve
Načteš místa, která tvůj klíč může rezervovat, a pak si u jednoho z nich vyžádáš začátky dostupných termínů.
Výsledky přicházejí jako klinické a genetické řádky
Každý typ objednávky má vlastní volání pro výsledky a PDF zpráva se stahuje zvlášť podle ID souboru.
Kurýr odveze vzorek do laboratoře
Vytvoříš objednávku kurýra s časovým oknem pro vyzvednutí v pracovní den, pak připojíš termíny a sleduješ aktualizace stavu.
Katalogy uvádějí biomarkery, které si můžeš objednat
Katalogy biomarkerů, panelů a jednotek jsou stránkované a biomarkery můžeš filtrovat podle místa testování.
Jeden readiness endpoint nepotřebuje API klíč
Sonda připravenosti nepotřebuje API klíč, takže ji tvůj monitor dostupnosti může volat podle plánu.
Laboratorní proces se spustí, jakmile potvrdíš odběr krve
Pošleš nám čárový kód sady a to je to poslední, co od tebe potřebujeme. Pak zařídíme obaly, kurýra i laboratoř, takže tvůj kód zavolá jen dva endpointy, než bude zpráva hotová.
Každý výsledek má dvě referenční rozmezí a čtyři stavy
Každý klinický řádek obsahuje rozmezí z laboratoře i rozmezí Anivy s jejím optimálním oknem, takže můžeš vykreslit obojí bez nutnosti udržovat vlastní vyhledávací tabulku.
Datum a čas musí obsahovat časové pásmo, jinak požadavek selže
Naivní datetime je odmítnut s kódem 400, což je jediná chyba, kterou dělá většina prvních integrací.
Každý požadavek vyžaduje tvůj partnerský API klíč
Autentizace používá u každého volání hlavičku x-api-key a chybějící nebo obměněný klíč vrátí 403 s krátkou chybou JSON.
Každou službu můžeš sledovat na stavové stránce
Stavová stránka zobrazuje aktuální stav a 90 dní historie pro každou službu a stejná data jsou dostupná jako JSON pro tvůj vlastní monitoring.
Požádat nás o partnerský klíč ještě dnes
Řekni nám, na kterých trzích prodáváš a jaké panely potřebuješ, a pošleme ti klíč se správnými oprávněními.
Tato stránka je ukázka designu. Každý endpoint a payload na ní pochází z docs.anivahealth.com a schéma pipeline je ilustrativní.
Strojově čitelné kopie dokumentace najdeš na docs.anivahealth.com/llms.txt a docs.anivahealth.com/llms-full.txt.