Una clau d'API et dona 45 endpoints, des de la reserva fins als resultats de laboratori
L'Aniva Partner API reserva una extracció de sang en més de 25 ubicacions a Alemanya, afegeix panells a aquesta cita i retorna resultats clínics i genètics en format JSON. Cada sol·licitud necessita una capçalera, i l'URL base és el mateix en tots els entorns.
Quan fer servir Aniva
45 punts finals estan documentats i actius avui
L'autenticació només necessita una capçalera de sol·licitud
Cada ruta comença amb el prefix v1
Els centres d'Alemanya poden fer l'extracció de sang
Quatre sol·licituds van de la reserva als resultats de laboratori
Cada sol·licitud retorna l'ID que necessita la següent, així que una integració bàsica són quatre sol·licituds abans d'afegir-hi panells, canvis de cita o missatgers.
Llistes les ubicacions on pot reservar la teva clau
La resposta et dona cada adreça, l'horari d'obertura i la zona horària, així un client només veu les franges que existeixen.
Crees un perfil per al client
Un perfil necessita un nom, un codi de sexe, una data de naixement i el teu profile_group, que accepta un UUID o el teu propi slug.
Reserves la cita a la franja que triïs
La reserva necessita l'ID del perfil, l'ID de la ubicació i una data i hora ISO 8601 amb el seu desplaçament horari o el sufix Z.
Confirmes l'extracció de sang amb el codi de barres del kit
Aquesta sol·licitud inicia la comanda al laboratori i bloqueja la cita, així que modifica cada panell abans d'enviar-la.
Cada grup de recursos és una col·lecció REST
Pots demanar una extracció de sang en una clínica o un kit de prova a casa per correu postal. Tots dos tornen en el mateix format, així que només escrius una vegada el codi que llegeix els resultats.
Un perfil és la persona a qui fas l'anàlisi
Busques un perfil per correu electrònic, el crees dins del teu grup de perfils i actualitzes les dades demogràfiques més endavant.
Una cita inclou els panells i l'extracció de sang
Quinze punts finals cobreixen la reserva i cada canvi posterior, inclosos els panells, les previsualitzacions dels recipients i la confirmació.
Les comandes de kits de prova a casa són la versió per correu
Deu endpoints sol·liciten un kit DIY per a un perfil, en canvien els panells i retornen la mateixa estructura de resultats.
Les ubicacions t'indiquen on es fa una extracció de sang
Llegeixes les ubicacions que la teva clau pot reservar i després demanes a una d'elles els inicis de franja disponibles.
Els resultats arriben en files clíniques i genètiques
Cada tipus de comanda té la seva pròpia crida de resultats, i l'informe en PDF és una descàrrega separada per ID de fitxer.
Un missatger porta la mostra al laboratori
Crees una ordre de missatgeria amb una franja de recollida entre setmana, hi adjuntes les cites i en consultes les actualitzacions d'estat.
Els catàlegs recullen els biomarcadors que pots demanar
Els catàlegs de biomarcadors, panells i unitats estan paginats, i pots filtrar els biomarcadors per ubicació de la prova.
Un punt final de disponibilitat no necessita clau d'API
La sonda de disponibilitat no necessita cap clau d'API, així que el teu monitor de temps d'activitat pot cridar-la de manera programada.
El procés de laboratori comença quan confirmes l'extracció de sang
Ens envies el codi de barres del kit, i això és l'últim que necessitem de tu. Després organitzem els recipients, la missatgeria i el laboratori, de manera que el teu codi només crida dos endpoints fins que l'informe estigui a punt.
Cada resultat té dos intervals de referència i quatre estats
Cada fila clínica inclou l'interval informat pel laboratori i l'interval d'Aniva amb la seva franja òptima, perquè els puguis mostrar tots dos sense mantenir la teva pròpia taula de consulta.
Les dates i hores necessiten una zona horària o la sol·licitud falla
Una data i hora sense zona horària es rebutja amb un 400, que és l'error més comú en la majoria de les primeres integracions.
Cada sol·licitud necessita la teva clau API de col·laborador
L'autenticació fa servir la capçalera x-api-key a cada crida, i una clau que falta o ha estat rotada retorna un 403 amb un breu error JSON.
Pots seguir cada servei a la pàgina d'estat
La pàgina d'estat mostra l'estat actual i un historial de 90 dies per a cada servei, i les mateixes dades estan disponibles en JSON per al teu propi monitor.
Demana'ns una clau de col·laborador avui
Digue'ns en quins mercats vens i quins panells necessites, i t'enviarem una clau amb els permisos adequats.
Aquesta pàgina és una maqueta de disseny. Cada endpoint i payload que hi apareix s'ha tret de docs.anivahealth.com, i el diagrama del flux és il·lustratiu.
Hi ha còpies de la documentació llegibles per màquines a docs.anivahealth.com/llms.txt i docs.anivahealth.com/llms-full.txt.