Section 8 sur 12

Intégrations & API

Intégrez Buqq à votre caisse ou à vos outils personnalisés via l'API REST externe.

La section Intégrations fournit une API REST externe pour créer des intégrations personnalisées avec votre caisse ou d'autres outils. Accédez-y depuis Tableau de bord → Intégrations.

La référence API complète — schémas des endpoints, détails d'authentification et exemples — est disponible sur buqq.online/api-docs.
Les alertes de réservation Telegram se configurent dans Paramètres → Notifications. Consultez la section Paramètres de ce guide pour les étapes de configuration.

Identifiant marchand#

Votre identifiant marchand est un identifiant unique pour votre compte sur la plateforme Buqq. Il est affiché sur la page Intégrations et est requis lorsque vous contactez le support ou utilisez certains endpoints API.

Clés API#

L'API externe Buqq vous permet de lire la disponibilité, de créer des réservations et de mettre à jour les statuts de réservation depuis vos propres systèmes. L'accès à l'API nécessite une clé API associée à votre compte marchand.

Générer une clé

  1. Dans Tableau de bord → Intégrations, faites défiler jusqu'à "Clés API".
  2. Cliquez sur "Générer une clé API".
  3. Copiez la clé et stockez-la dans vos variables d'environnement ou votre gestionnaire de secrets.
Traitez votre clé API comme un mot de passe — ne la partagez pas et ne la committez pas dans le contrôle de version. Si vous pensez qu'une clé a été compromise, révoquez-la immédiatement et générez-en une nouvelle.

Afficher la clé actuelle

Si vous devez récupérer votre clé existante, cliquez sur Afficher — la clé complète s'affiche pour que vous puissiez la copier à nouveau.

Renouveler une clé

Le renouvellement remplace votre clé actuelle par une nouvelle. L'ancienne clé est immédiatement invalidée. Mettez à jour toutes les intégrations utilisant l'ancienne clé avant de renouveler.

Révoquer une clé

La révocation supprime la clé actuelle sans en émettre de nouvelle. Les appels API échoueront jusqu'à ce que vous génériez une nouvelle clé. Utilisez la révocation si vous pensez qu'une clé a été compromise.

Exemples cURL#

La page Intégrations affiche des exemples cURL prêts à l'emploi pour les opérations API les plus courantes. Remplacez YOUR_API_KEY par votre clé réelle pour tester immédiatement.

EXEMPLE — Vérifier la disponibilité

curl https://buqq.online/api/external/v1/availability \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G -d "date=2025-08-15" -d "party_size=2"

Notes POS#

Si vous connectez Buqq à un système de point de vente, l'API externe prend en charge la lecture des réservations confirmées du jour et la mise à jour des statuts (ex. marquer une réservation comme enregistrée ou annulée) depuis votre POS. Consultez la documentation de votre fournisseur POS pour les étapes d'intégration spécifiques, et référez-vous à la documentation API pour les détails des endpoints.

GET /api/external/v1/availability
Retourne les créneaux disponibles pour une date et une taille de groupe données.
GET /api/external/v1/bookings
Liste les réservations de votre restaurant. Filtrez par date.
POST /api/external/v1/bookings
Crée une nouvelle réservation par programmation.
PATCH /api/external/v1/bookings/{id}/status
Met à jour le statut d'une réservation (confirmed, checked_in, cancelled, no_show).