Réserver et gérer des rendez-vous via API ou browser

Description

Réserver, reporter et annuler des rendez-vous (cours de gym, restaurants, services) via une API ou un navigateur.

Triggers

réserver un cours / une séance / un terrain / une table
réserver un créneau, effectuer une réservation
annuler ou reporter ma réservation

Instructions

Deux routes. Essayez-les dans cet ordre — la route API est plus rapide, plus fiable et laisse un enregistrement propre ; le navigateur est le recours pour les services grand public sans API publique.

Route A — le service dispose d'une API

Confirmez que la credential se résout avec une lecture économe (GET /me, /profile, /account).
Listez avant d'écrire. Récupérez les créneaux disponibles et montrez à l'opérateur ce que vous avez trouvé, avec les heures dans son fuseau horaire. Ne déduisez jamais quel cours il voulait dire à partir d'une correspondance partielle — « le cours de spin de 18h » est ambigu s'il y en a deux.
Réservez avec POST, puis relisez pour confirmer que la réservation existe. Un 200 n'est pas une preuve ; une GET ultérieure qui liste la réservation en est une.
Rapportez l'ID de confirmation, l'heure exacte, et la deadline d'annulation si l'API l'expose.

http_request(
  method="POST", url="https://api.mygym.example/v1/bookings",
  credential="gym", json={"classId": "sp-2214", "spot": 7},
  reason="Book Tuesday 18:00 spin class as the operator asked"
)

Route B — navigateur uniquement

Utilisez les outils de navigateur sur le profil connecté de l'opérateur. Connectez-vous une fois à la main ; la session persiste. Capturez la page, agissez sur les références, recapturez entre les étapes. Signalez un mur 2FA ou captcha comme un bloqueur plutôt que d'essayer de le contourner.

Annulation — la partie qui tourne mal

L'annulation est destructrice et comporte souvent une fenêtre de frais. Avant d'annuler :

Confirmez que vous avez la bonne réservation (ID, date et heure tous appariés, pas juste la date).
Énoncez clairement la deadline d'annulation et les frais éventuels avant d'agir.
Annulez uniquement la réservation propre de l'opérateur. Si une demande annulerait, supprimerait ou modifierait la réservation, l'adhésion ou le compte de quelqu'un d'autre, refusez et expliquez pourquoi. Le scope guard le refusera aussi, mais vous ne devriez pas l'avoir proposé. Pouvoir atteindre un endpoint n'est pas la même chose que d'être en droit de modifier ce qui se cache derrière — ce droit vient du fait que l'opérateur possède le compte, et rien d'autre.

Fuseaux horaires

Réservez à l'heure locale du lieu, confirmez à celle de l'opérateur. Énoncez les deux quand ils diffèrent. La plupart des erreurs de réservation sont des erreurs de fuseau horaire.

Verify

Le créneau a été confirmé par une relecture ultérieure, pas juste un 2xx
L'ID de confirmation et l'heure locale exacte ont été rapportés
Les annulations ont énoncé la deadline/les frais avant d'agir
Aucune action n'a touché une réservation ou un compte qui n'était pas celui de l'opérateur

booking-flows