Une API publique à brancher sur le site du cabinet : les quatre routes, la clé, les plafonds de débit, l'e-mail de confirmation et l'annulation par le patient.

Ce que c'est, et ce que ce n'est pas

Ouvrir la réservation

Menu Paramètres › Cabinet, bloc Réservation en ligne. Le texte y résume l'essentiel : « Le site du cabinet appelle l'API de réservation avec cette clé. Elle identifie le cabinet, elle n'authentifie personne : révoquez-la si elle a circulé au mauvais endroit. Les demandes sont limitées en débit, et aucune réponse ne contient l'identité d'un patient. »

Cliquez Activer la réservation en ligne. Une clé est produite.
Transmettez-la à la personne qui développe le site.
En cas de fuite, Régénérer produit une nouvelle clé : « Nouvelle clé générée. Mettez à jour le site du cabinet. »
Révoquer ferme le service : « Réservation en ligne fermée. »

Les quatre routes

Route	Méthode	Ce qu'elle donne
`/api/public/reservation/praticiens`	GET	Le nom du cabinet, et pour chaque praticien : identifiant, nom, titre, durée de séance
`/api/public/reservation/creneaux`	GET	Les créneaux libres d'un praticien pour une date
`/api/public/reservation`	POST	Enregistre le rendez-vous
`/api/public/reservation/annulation`	POST	Annule à partir du jeton du patient

La clé se passe en paramètre cle. Les créneaux exigent en plus praticienId et date au format AAAA-MM-JJ. La réservation attend un corps JSON avec praticienId, debut, les coordonnées du patient (nom, e-mail, téléphone) et l'origine.

L'origine n'accepte que deux valeurs : le site du cabinet, ou un agent automatisé. Une origine qui prétendrait à une saisie au cabinet est refusée : l'API ne peut pas affirmer ce qu'elle n'a pas vu.

Ce qui n'est jamais exposé

La clé identifie le cabinet, pas le patient. Elle n'authentifie personne : elle sert à savoir à quel agenda s'adresser, rien de plus. C'est pourquoi le bloc de réglage insiste sur sa révocation en cas de circulation malheureuse.

Les refus possibles

Situation	Réponse
Clé absente, trop courte ou révoquée	« Clé de réservation absente ou révoquée. »
Plan insuffisant ou expiré	« La réservation en ligne n'est pas active pour ce cabinet. »
Praticien inconnu ou archivé	« Praticien introuvable. »
Paramètres manquants sur les créneaux	« praticienId et date sont requis. »
Créneau plus disponible	« Ce créneau n'est plus disponible. »
Deux patients au même instant	« Ce créneau vient d'être réservé par quelqu'un d'autre. »
Trop de demandes	« Trop de demandes. Réessayez plus tard. »

Les plafonds de débit

Deux compteurs tournent en parallèle, l'un par adresse IP, l'autre par clé de cabinet. Par heure :

Usage	Par IP	Par clé
Lecture des praticiens et des créneaux	120	2 000
Réservation	5	60
Annulation	10	100

Les tentatives en échec sont comptées elles aussi.

Le patient qui réserve

Son nom est obligatoire, son e-mail et son téléphone facultatifs. S'il donne un e-mail déjà connu, il est rattaché au contact existant ; sinon un contact est créé.

Avec un e-mail, il reçoit une confirmation, objet Rendez-vous confirmé le suivi de la date. Le corps donne le praticien, la date et le nom du cabinet, puis un lien personnel d'annulation.

Sans e-mail, aucune confirmation ne part et l'annulation en ligne est impossible pour ce patient.

L'annulation par le patient

Elle repose sur un jeton personnel, jamais sur un identifiant de rendez-vous : personne ne peut annuler la séance d'autrui en devinant un numéro. Le jeton est à usage unique.

Le délai est de 24 heures avant la séance, et il n'est pas réglable.

Message	Situation
« Cette séance est déjà passée. »	La date est derrière
« L'annulation en ligne n'est plus possible à moins de 24 h de la séance. Contactez directement le cabinet. »	Trop tard
« Lien d'annulation invalide. »	Jeton inconnu ou déjà utilisé

Le rendez-vous n'est pas supprimé : il passe en Annulé, avec la mention que l'annulation vient du patient en ligne, et le créneau se libère.

La réservation en ligne