Réservations / Bookings

Le parcours de réservation

Sur un site connecté à Okkre, le joueur consulte les disponibilités, choisit un terrain et un horaire, puis fournit ses coordonnées. La réservation confirmée apparaît dans le planning du club.

Pour connecter ce parcours avec l’API publique :

1. Consultez GET /availability pour afficher les créneaux avec leur prix et leur durée. Une recherche couvre au maximum 31 jours.
2. Conservez les heures de début et de fin renvoyées pour réserver le créneau au tarif affiché.
3. Depuis votre serveur, envoyez POST /reservations avec une clé book, un external_id stable et les coordonnées du joueur. Un email ou un téléphone est nécessaire.
4. Affichez la confirmation après la réponse de l’API. Si elle renvoie 409 slot_unavailable, actualisez les disponibilités et proposez un autre créneau.

Consulter ou annuler

GET /reservations/{externalId} permet de retrouver une réservation créée par l’API. Pour l’annuler, utilisez DELETE /reservations/{externalId} ou POST /reservations/{externalId}/cancel avec une clé book.

L’annulation conserve la réservation dans l’historique avec le statut cancelled. Réutiliser le même external_id lors d’une nouvelle tentative de création évite les doublons ; n’utilisez pas cet identifiant pour une autre réservation.

Découvrir les réservations · Référence API

The booking journey

On a website connected to Okkre, the player checks availability, selects a court and time, then provides contact details. The confirmed booking appears in the club schedule.

To connect this journey through the public API:

1. Call GET /availability to display slots with their price and duration. Searches cover up to 31 days.
2. Keep the returned start and end times unchanged to book at the displayed price.
3. From your server, send POST /reservations with a book key, a stable external_id and player details. An email or phone number is required.
4. Show confirmation after the API responds. For 409 slot_unavailable, refresh availability and offer another slot.

Read or cancel

Use GET /reservations/{externalId} to retrieve an API-created booking. Cancel it with DELETE /reservations/{externalId} or POST /reservations/{externalId}/cancel, using a book key.

Cancellation keeps the booking in the history with a cancelled status. Reuse the same external_id when retrying a creation request to avoid duplicates; do not reuse it for a different booking.

Explore bookings · AI integration guide