Skip to main content
L’API partenaire donne à une intégration côté serveur accès à un restaurant par clé API. Elle permet de lire le catalogue, consulter les disponibilités, gérer les réservations et signaler des appels manqués. Les webhooks transmettent certains événements de réservation à votre serveur.

URL et spécification

Le document OpenAPI fournit les schémas des endpoints affichés dans cette référence. Les métadonnées à la racine et le document OpenAPI sont publics ; les routes métier demandent un jeton Bearer. Le champ docs_ready des métadonnées ne vérifie pas la disponibilité de cette doc. Les descriptions des endpoints générés depuis OpenAPI sont en anglais.

Démarrer une intégration

  1. Créez une clé avec les permissions nécessaires.
  2. Lisez authentification et scopes, puis appelez GET /me pour vérifier le restaurant et les droits.
  3. Suivez le parcours de réservation : disponibilités, création, modification et annulation.
  4. Gérez les erreurs et limites de débit.
  5. Configurez un récepteur avec la référence webhooks.
Les requêtes et le testeur interactif ciblent le restaurant associé à votre clé. Une écriture peut créer une vraie réservation, envoyer des notifications ou relancer un client sur WhatsApp. Les exemples ne sont pas un environnement de test.
Les réponses métier réussies placent le résultat dans data. Les listes de réservations incluent aussi la pagination ; consultez le schéma de chaque endpoint. Un 201 indique un traitement effectué, pas nécessairement une réservation confirmée ou un WhatsApp envoyé : lisez le statut ou data.outcome. Les manipulations destinées aux équipes du restaurant restent dans les guides Clés API et Webhooks.