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
- Créez une clé avec les permissions nécessaires.
- Lisez authentification et scopes, puis
appelez
GET /me pour vérifier le restaurant et les droits.
- Suivez le parcours de réservation :
disponibilités, création, modification et annulation.
- Gérez les erreurs et limites de débit.
- 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.