API
Routes HTTP d'administration et publiques de @lrvo/module-booking, et sous-entrée serveur.
Toutes les routes sont servies sous /lrvo/api/booking/. Le contrôle d'accès est déclaré sur la route, jamais vérifié à la main : le routeur du core applique la session, le rate limit, la vérification d'origine et la permission avant d'atteindre le handler.
Administration
auth: 'admin'. Toute lecture est sous booking.view. L'écriture se partage en deux :
| Permission | Écritures |
|---|---|
booking.manage | appointments et ses transitions. |
booking.options | services, staff, hours, exceptions, links, et jobs/:name/run. |
| Chemin | Méthodes |
|---|---|
/booking/admin/config | GET |
/booking/admin/agenda | GET |
/booking/admin/calendar | GET |
/booking/admin/stats | GET |
/booking/admin/availability | GET |
/booking/admin/appointments | GET, POST |
/booking/admin/appointments/:id | GET, PUT, DELETE |
/booking/admin/appointments/:id/confirm | POST |
/booking/admin/appointments/:id/cancel | POST |
/booking/admin/appointments/:id/reschedule | POST |
/booking/admin/appointments/:id/complete | POST |
/booking/admin/appointments/:id/no-show | POST |
/booking/admin/appointments/:id/ics | GET |
/booking/admin/services | GET, POST |
/booking/admin/services/:id | GET, PUT, DELETE |
/booking/admin/staff | GET, POST |
/booking/admin/staff/:id | GET, PUT, DELETE |
/booking/admin/staff/:id/hours | GET, PUT |
/booking/admin/hours | GET, PUT |
/booking/admin/exceptions | GET, POST |
/booking/admin/exceptions/:id | DELETE |
/booking/admin/links | GET, POST |
/booking/admin/links/:id | GET, PUT, DELETE |
/booking/admin/jobs | GET |
/booking/admin/jobs/:name/run | POST |
GET /booking/admin/availability prend service, staff, from et to, et renvoie exactement ce qu'un visiteur verrait : l'admin et le public lisent la même fonction, ce qui rend impossible un désaccord entre les deux.
Un horaire s'écrit en entier, jamais ligne par ligne : PUT /booking/admin/hours remplace les plages du niveau visé. Une écriture partielle laisserait une plage orpheline dès que l'interface en perd une.
Public
auth: 'public'. Toutes refusent en bloc quand la prise de rendez-vous en ligne est fermée.
| Chemin | Méthode | Rôle |
|---|---|---|
/booking/public/embed.js | GET | Le script d'intégration en iframe. |
/booking/public/link/:slug | GET | La définition de l'assistant. |
/booking/public/link/:slug/availability | GET | Les créneaux libres. |
/booking/public/link/:slug/book | POST | Créer le rendez-vous. |
/booking/public/appointment/:token | GET | Le rendez-vous du client. |
/booking/public/appointment/:token/availability | GET | Les créneaux d'un déplacement. |
/booking/public/appointment/:token/cancel | POST | Annuler. |
/booking/public/appointment/:token/reschedule | POST | Déplacer. |
/booking/public/appointment/:token/ics | GET | Le fichier calendrier. |
Trois règles tiennent cette surface :
- Le jeton est vérifié avant la base. Un jeton absent ou malformé n'atteint jamais le
SELECT. - Rien d'interne ne sort. Chaque réponse passe par une projection explicite : pas d'identifiant numérique de rendez-vous, pas de note interne, pas de courriel d'un autre client, et jamais qui occupe une place.
- La fenêtre est plafonnée à 62 jours par appel, sinon un seul appel peut demander cinq ans de créneaux.
Les identifiants d'intervenant ne sont pas renvoyés par la disponibilité publique : qui recevra le visiteur se décide au moment de réserver, et publier la correspondance ferait de l'endpoint une copie lisible de l'agenda de chacun.
Ordre de déclaration
matchRoute retient le premier motif qui correspond à profondeur et méthode égales, donc un :param masque un littéral de même profondeur. public/embed.js est déclaré avant public/link/:slug, et c'est le seul endroit où se tromper serait silencieux : le navigateur recevrait du HTML là où il attend un script.
Sous-entrée serveur
@lrvo/module-booking/server expose ce qu'un projet hôte peut lire directement, depuis un composant serveur, sans passer par HTTP :
import { getPublicLink, getPublicAvailability, listUpcoming } from '@lrvo/module-booking/server';listUpcoming(limite) rend les prochains rendez-vous, les annulés mis à part, du plus proche au plus lointain. Sa fenêtre s'ouvre sur la fin et non sur le début : un rendez-vous commencé y reste jusqu'à son heure de fin, comme dans l'agenda.
Volontairement en lecture seule et volontairement étroite. Réserver est une écriture, et une écriture appartient à l'API publique, où le rate limit, les pièges anti-robots et le verrou sont tous en place.