Prendre la réservation
Créez, modifiez et annulez des réservations, avec une clé d’idempotence pour qu’une nouvelle tentative après un délai dépassé retrouve la réservation déjà faite.
API et webhooks
Réservez, posez des options et lisez les réservations de votre restaurant depuis vos propres systèmes.
Exploitez vos données de réservation
Section intitulée « Exploitez vos données de réservation »L’API Service vous permet de lire les réservations et les clients de votre restaurant par programmation, et de réserver, poser une option, modifier et annuler pour le compte du restaurant. C’est une API JSON claire et prévisible : structures de ressources stables, pagination par curseur, horodatages ISO-8601 et enveloppes d’erreur structurées.
L’URL de base est https://api.useservice.app.
Votre première requête
Section intitulée « Votre première requête »Créez une clé dans le back-office, dans Paramètres → Développeurs, et accordez-lui les portées dont votre intégration a besoin. Les clés sont propres à un restaurant, et les exemples lisent la vôtre depuis une variable d’environnement — voir Authentification.
curl https://api.useservice.app/v1/reservations \ -H "Authorization: Bearer $SERVICE_API_KEY"Poser une option
Retirez un créneau de la vente le temps qu’un client paie ou se décide, puis convertissez l’option en réservation ou rendez-la aussitôt.
Lire les réservations et les clients
Listez et récupérez les réservations (avec l’affectation des tables et l’historique du cycle de vie) ainsi que les clients (identité, coordonnées, consentement, statistiques de visite).
Réagir aux changements
Abonnez-vous à des webhooks signés pour l’ensemble du cycle de vie des réservations, pour les options, ainsi que les événements liés aux clients et aux avis.
En libre-service
Créez vos clés et enregistrez vos points de terminaison de webhook depuis le back-office
(Paramètres → Développeurs), sans rendez-vous commercial ni ticket de support. L’accès à l’API
dépend de l’abonnement Premium du restaurant ; une clé sans cet abonnement est refusée avec
plan_required.
Prévisible et versionnée
Versionnement par date épinglé à chaque clé, pour que votre intégration ne casse jamais à votre insu.
Pour commencer
Section intitulée « Pour commencer »IntroductionCe qu'est l'API et les conventions qu'elle suit.
AuthentificationUtilisez une clé d'API de restaurant comme jeton Bearer, et choisissez ses portées.
GlossaireCouvert, service, limites de service, réservation publiée, balayage : les mots que les guides emploient.
WebhooksEnregistrez des points de terminaison et vérifiez les événements signés.
Référence de l'APITous les points de terminaison, générés à partir de la spécification OpenAPI (en anglais).
Spécification OpenAPITéléchargez la spécification pour générer un SDK ou l'importer dans Postman.
Cas d’usage
Section intitulée « Cas d’usage »Sept guides qui partent de ce que vous construisez plutôt que d’un point de terminaison, et qui nomment la contrainte décidant si vous pouvez le construire.
Construire un tunnel de réservationDisponibilités, sections et appel de création — et pourquoi un tunnel reconstruit exige votre propre serveur.
Poser une optionRetirez une table de la vente le temps qu'un paiement se dénoue, puis convertissez l'option ou rendez-la.
Changer l'heure d'une optionLe client veut une autre heure que celle que vous retenez : posez une nouvelle option, puis libérez l'ancienne.
Réserver malgré les règlesLevez une règle pour un séminaire ou un groupe de trente, et voyez ce qui n'est jamais levable.
Réserver une salle entièrePrenez toutes les tables d'une section pour un événement privé, trouvez la salle et traitez une salle déjà en partie prise.
Garder votre système synchroniséLes webhooks pour le signal, updated_since pour la vérité, les ETags pour le coût.
Demander une garantie par carteRéservez un créneau qui demande une carte au client, et les deux refus qui surprennent.