Une clé API te donne accès à 45 endpoints, de la réservation aux résultats de laboratoire
L'Aniva Partner API réserve une prise de sang dans plus de 25 sites en Allemagne, ajoute des panels à ce rendez-vous et renvoie les résultats cliniques et génétiques en JSON. Chaque requête nécessite un seul en-tête et l'URL de base est la même dans chaque environnement.
Quand utiliser Aniva
45 endpoints sont documentés et actifs aujourd'hui
L'authentification ne nécessite qu'un seul en-tête de requête
Chaque chemin commence par le préfixe v1
Les sites en Allemagne peuvent réaliser la prise de sang
Quatre requêtes mènent de la réservation aux résultats de laboratoire
Chaque requête renvoie l'identifiant dont la suivante a besoin, donc une intégration de base représente quatre requêtes avant d'ajouter les panels, les reports ou les coursiers.
Tu listes les sites que ta clé peut réserver
La réponse te renvoie chaque adresse, les horaires d'ouverture et le fuseau horaire, afin qu'un client ne voie que des créneaux qui existent.
Tu crées un profil pour le client
Un profil nécessite un nom, un code de sexe, une date de naissance et ton profile_group, qui accepte un UUID ou ton propre slug.
Tu réserves le rendez-vous sur le créneau de ton choix
La réservation nécessite l'ID de profil, l'ID de lieu et une date-heure ISO 8601 avec son décalage horaire ou le suffixe Z.
Tu confirmes la prise de sang avec le code-barres du kit
Cette requête lance la commande au laboratoire et verrouille le rendez-vous, alors modifie chaque panel avant de l'envoyer.
Chaque groupe de ressources est une collection REST
Tu peux commander une prise de sang en clinique ou un kit à domicile par courrier. Les deux reviennent au même format, donc tu n'écris qu'une seule fois le code qui lit les résultats.
Un profil correspond à la personne que tu testes
Tu recherches un profil par e-mail, le crées dans ton groupe de profils et mets à jour les données démographiques plus tard.
Un rendez-vous comprend les panels et la prise de sang
Quinze points d'accès couvrent la réservation et chaque modification ultérieure, y compris les panels, les aperçus des contenants et la confirmation.
Les commandes de kit à domicile sont la version par courrier
Dix endpoints demandent un kit à domicile pour un profil, modifient ses panels et renvoient la même structure de résultats.
Les lieux t'indiquent où se déroule la prise de sang
Tu lis les lieux que ta clé peut réserver, puis tu demandes à l'un d'eux les débuts de créneaux réservables.
Les résultats reviennent sous forme de lignes cliniques et génétiques
Chaque type de commande a son propre appel de résultats, et le rapport PDF est un téléchargement distinct par ID de fichier.
Un coursier apporte l'échantillon au laboratoire
Tu crées une commande de coursier avec un créneau de collecte en semaine, puis tu y associes des rendez-vous et tu suis les mises à jour de statut.
Les catalogues listent les biomarqueurs que tu peux commander
Les catalogues de biomarqueurs, de panels et d’unités sont paginés, et tu peux filtrer les biomarqueurs par lieu de test.
Un endpoint de disponibilité ne nécessite pas de clé API
La sonde de disponibilité n'a pas besoin de clé API, ton outil de monitoring peut donc l'appeler à intervalles réguliers.
Le processus de laboratoire démarre quand tu confirmes la prise de sang
Tu nous envoies le code-barres du kit, et c’est tout ce dont nous avons besoin de ta part. Nous organisons ensuite les contenants, le coursier et le laboratoire, de sorte que ton code n’appelle que deux endpoints jusqu’à ce que le compte rendu soit prêt.
Chaque résultat a deux intervalles de référence et quatre statuts
Chaque ligne clinique contient l'intervalle transmis par le laboratoire et l'intervalle Aniva avec sa fenêtre optimale, afin que tu puisses afficher les deux sans maintenir ta propre table de correspondance.
Les dates et heures doivent inclure un fuseau horaire, sinon la requête échoue
Un datetime naïf est rejeté avec le code 400, ce qui est l'erreur que font la plupart des premières intégrations.
Chaque requête nécessite ta clé API partenaire
L'authentification utilise l'en-tête x-api-key à chaque appel, et une clé manquante ou remplacée renvoie 403 avec une courte erreur JSON.
Tu peux suivre chaque service sur la page de statut
La page de statut affiche l'état actuel et 90 jours d'historique pour chaque service, et ces mêmes données sont disponibles au format JSON pour ton propre outil de monitoring.
Nous demander une clé partenaire dès aujourd'hui
Dis-nous sur quels marchés tu vends et de quels panels tu as besoin, et nous t'enverrons une clé avec les bonnes autorisations.
Cette page est une maquette. Chaque endpoint et chaque payload qui y figure provient de docs.anivahealth.com, et le schéma du pipeline est illustratif.
Des copies de la documentation lisibles par machine sont disponibles sur docs.anivahealth.com/llms.txt et docs.anivahealth.com/llms-full.txt.