Disponibilité

La disponibilité dit ce qui était vendable à l’instant où vous l’avez lue. C’est une projection et pas une promesse : POST /v1/reservations et POST /v1/holds revérifient chaque plafond et chaque table sous verrou, si bien qu’un créneau qu’on vous a montré peut encore être refusé.

Les deux points de terminaison demandent la portée reservations:read. Les deux formes sont sur L’objet disponibilité.

Points de terminaison

Point de terminaison	Ce qu’il fait
GET /v1/availability	Créneaux par service pour une date de service et un nombre de couverts, filtrables sur une section.
GET /v1/availability/months	Quels jours valent la peine d’être ouverts, pour tous les nombres de couverts à la fois. Ni couverts ni section.

Deux mailles, deux questions

Le point de terminaison mensuel répond à « quels jours le calendrier doit-il proposer », et son indépendance aux filtres est voulue : une lecture peint un mois entier pour tous les nombres de couverts. Le point de terminaison journalier répond à « quelles heures, pour cette table » et c’est lui qui porte les couverts, les services, les fermetures et les garanties par carte.

Construire un tunnel de réservation utilise les deux dans l’ordre.