Passer au contenu principal
POST
Planifie un rendez-vous de prise de sang pour un profil patient dans un lieu de test précis. Une fois créé, le rendez-vous passe au statut confirmed par défaut (certains lieux peuvent utiliser pending par défaut — c’est un paramètre propre à chaque lieu). Utilise Ajouter des panels pour associer des panels de bilan sanguin avant de confirmer la prise de sang.
Un profil peut détenir au maximum un rendez-vous par lieu et par horaire. Créer un rendez-vous sur un créneau que le profil occupe déjà renvoie 409 avec l’appointment_id existant au lieu d’un second rendez-vous — une requête relancée ou répétée par erreur ne peut donc jamais créer de doublon. Voir Rendez-vous en double.
Envoie un en-tête facultatif Idempotency-Key pour pouvoir relancer cette création sans risque — répéter la même clé renvoie la réponse d’origine au lieu d’en créer un second. Voir Idempotence. Nécessite le scope appointments_schedule.

Requête

Paramètres du corps

string
requis
UUID du profil patient pour lequel créer le rendez-vous.
string
requis
UUID du lieu de test où se déroulera la prise de sang. Utilise Lister les lieux pour trouver les identifiants des lieux disponibles.
string
requis
Date et heure du rendez-vous au format ISO 8601 (par ex. 2026-05-15T10:30:00Z ou 2026-05-15T12:30:00+02:00). Doit inclure un indicateur de fuseau horaire — soit Z, soit un décalage explicite comme +02:00 ; les dates/heures sans fuseau sont rejetées. Doit être dans le futur.Doit correspondre exactement au début d’un créneau sur la grille du lieu, et le créneau doit encore avoir de la disponibilité — consulte d’abord Récupérer les disponibilités. Les horaires hors grille renvoient 400 ; un créneau complet renvoie 409. Dans les lieux gérés par Aniva, il doit aussi se situer au moins 12 heures à l’avance — voir Délai minimum.
string[]
Jusqu’à 5 adresses qui reçoivent chacune un e-mail dès que tous les résultats de laboratoire sont définitifs. L’e-mail renvoie vers la page des résultats dans le panneau d’administration Aniva. Ta clé doit disposer de l’accès results_view pour le patient, sinon 403. Omets ce champ pour utiliser les adresses par défaut définies pour le groupe du patient. Une liste vide désactive les e-mails. Voir E-mails de résultats prêts.
string
Méthode de prise de sang : capillary ou venous. Omets ce champ pour utiliser le default_draw_method du lieu. Le lieu doit inclure cette méthode dans ses draw_methods, sinon 400.

Réponse

En cas de succès, l’API renvoie 201 Created avec le nouveau rendez-vous.
string
requis
Identifiant unique du rendez-vous (UUID).
string
requis
UUID du profil auquel ce rendez-vous appartient.
string
UUID du lieu de test où la prise de sang a lieu.
string
Date et heure prévues du rendez-vous en UTC (ISO 8601 avec suffixe Z, par ex. 2026-05-15T10:30:00Z). Peut être null.
string
requis
Statut actuel du rendez-vous. Prend l’une des valeurs pending, confirmed, blood_drawn ou cancelled. Le détail d’avancement des résultats de laboratoire s’obtient via Récupérer les résultats ; la progression fine des envois via chaque entrée du tableau shipments intégré (voir ci-dessous), puis Récupérer un envoi.
string
Motif en texte libre saisi lors de l’annulation du rendez-vous (par ex. absence, annulation tardive, « Échec. À refaire »). null sauf si status vaut cancelled.
string[]
requis
Adresses en minuscules qui reçoivent chacune un e-mail une fois tous les résultats de laboratoire définitifs. Vide si désactivé. Voir E-mails de résultats prêts.
string
requis
Méthode de prise de sang : capillary (au bout du doigt ou sur le haut du bras, dans des microtubes) ou venous (dans la veine, dans des tubes). C’est la méthode définie par le rendez-vous, sinon le default_draw_method de son lieu. Après la prise de sang, c’est la méthode qui a été utilisée.
object
requis
Le profil patient associé à ce rendez-vous.
AppointmentPanel[]
requis
Panels actuellement associés à ce rendez-vous. Vide pour les rendez-vous nouvellement créés — associe-les via Ajouter des panels. Consulte le détail des panels (nom, biomarqueurs) via Lister les panels.
AppointmentIndividualBiomarker[]
requis
Biomarqueurs à la carte associés à ce rendez-vous en dehors de tout panel. Vide pour les rendez-vous nouvellement créés — associe-les via Ajouter des biomarqueurs individuels. Croise chaque biomarker_id avec Lister les biomarqueurs pour obtenir les données d’affichage.
AppointmentShipmentLink[]
requis
Envois liés à ce rendez-vous, du lien le plus ancien au plus récent. Vide pour les rendez-vous nouvellement créés — lie-les via Créer un envoi (avec appointment_id) ou Associer des rendez-vous à un envoi.
string[]
requis
Codes laboratoire (codes-barres des tubes) enregistrés pour ce rendez-vous, dans l’ordre de scan. Vide jusqu’à la confirmation de la prise de sang. Une prise de sang veineuse porte un seul code imprimé sur chaque tube ; une prise de sang capillaire porte un code par microtube. Les résultats et documents dans Obtenir les résultats référencent ces codes via lab_code.

Délai minimum

Les rendez-vous dans les lieux gérés par Aniva doivent être réservés au moins 12 heures à l’avance ; toute réservation dans ce délai renvoie 400. Récupérer les disponibilités masque déjà ces créneaux, donc tout ce qui apparaît sur cette grille est réservable. Les lieux que tu gères toi-même n’ont aucun délai minimum — la réservation le jour même et sans rendez-vous reste inchangée.

Rendez-vous en double

Un profil peut détenir au maximum un rendez-vous non annulé par lieu et par horaire — une personne ne peut pas faire deux prises de sang au même endroit au même moment, quel que soit le nombre de fauteuils du lieu. Créer un rendez-vous sur un créneau que le profil occupe déjà renvoie 409 avec un appointment_id indiquant le rendez-vous qui existe déjà :
Gère ce cas en considérant la requête comme déjà appliquée : récupère le rendez-vous avec Récupérer un rendez-vous, déplace-le avec Mettre à jour un rendez-vous ou supprime-le avec Annuler un rendez-vous. Ne relance pas la création — elle continuera de renvoyer 409. Cela rend les créations répétées sans risque : une requête que tu renvoies après un délai d’expiration, ou un formulaire soumis deux fois, ne peut pas produire deux rendez-vous pour le même patient au même moment.
appointment_id n’est présent que sur le 409 de doublon. Le 409 de capacité — le créneau est complet parce que d’autres patients l’occupent — renvoie error seul, et la bonne démarche consiste alors à choisir un autre créneau dans Récupérer les disponibilités.

Réponses d’erreur