Passer au contenu principal
Utilise ce guide pour trouver un lieu de prélèvement, créer un rendez-vous pour un profil patient et associer les panels d’analyse à effectuer. Termine ces étapes avant l’arrivée du patient pour sa prise de sang.
1

Parcourir les lieux disponibles

Récupère la liste des lieux de prélèvement disponibles sur ton compte en envoyant une requête GET à /api/v1/locations.
La réponse est un tableau d’objets lieu :
Utilise le champ timezone de l’objet lieu lorsque tu construis ton horodatage scheduled_at. Convertir l’heure du rendez-vous dans le fuseau horaire local du lieu t’évite de planifier en dehors des horaires d’ouverture.
Ne déduis pas les créneaux réservables uniquement à partir de open_hours. Appelle Obtenir les disponibilités et réserve un début de créneau qu’il renvoie — cette grille tient aussi compte des réservations existantes, des exceptions par date et du délai minimal.
2

Créer le rendez-vous

Envoie une requête POST à /api/v1/appointments avec l’ID du profil, l’ID du lieu et l’heure de rendez-vous souhaitée. L’heure doit correspondre à un début de créneau renvoyé par Obtenir les disponibilités.
scheduled_at doit être une date et heure future au format ISO 8601, par exemple 2026-05-12T07:30:00Z. Les horodatages dans le passé sont rejetés avec une erreur 400, tout comme les horaires compris dans le délai minimal de 12 heures pour les lieux gérés par Aniva.
Répéter cette requête est sans risque. Un profil ne peut avoir qu’un seul rendez-vous par lieu et par horaire, donc une création renvoyée ou soumise en double retourne 409 avec l’appointment_id existant au lieu de réserver deux fois pour le patient.
Une requête réussie renvoie 201 Created avec l’objet rendez-vous :
Conserve l’id du rendez-vous — tu en auras besoin pour ajouter des panels et confirmer la prise de sang.
3

Ajouter des panels d'analyse

Associe les panels d’analyse à effectuer sur l’échantillon de sang en envoyant une requête POST à /api/v1/appointments/{id}/panels.Les ID de panel sont des UUID. Appelle Lister les panels pour obtenir les panels que ta clé API peut commander.
Il est impossible d’ajouter des panels une fois la prise de sang confirmée. Ajoute tous les panels requis avant la confirmation — consulte Confirmer la prise de sang pour en savoir plus.
Une requête réussie renvoie 200 OK pour confirmer que les panels ont été ajoutés :

Replanifier ou annuler

Après avoir créé un rendez-vous, tu peux encore le modifier avant que la prise de sang ne soit confirmée :
  • Replanifier ou changer de lieu — Envoie une requête PATCH à /api/v1/appointments/{id} avec les champs à mettre à jour. Consulte Mettre à jour un rendez-vous.
  • Annuler — Envoie une requête DELETE à /api/v1/appointments/{id}. Consulte Annuler un rendez-vous.
Les deux opérations ne sont disponibles qu’avant la prise de sang — c’est-à-dire tant que le rendez-vous a le statut pending ou confirmed. Une fois que le rendez-vous passe au statut blood_drawn, aucune modification n’est plus possible.

Gestion des erreurs