Abschnitt 8 von 12

Integrationen & API

Integrieren Sie Buqq über die externe REST-API mit Ihrem POS oder benutzerdefinierten Tools.

Der Bereich Integrationen bietet eine externe REST-API zum Erstellen individueller Integrationen mit Ihrem POS-System oder anderen Tools. Zugang über Dashboard → Integrationen.

Die vollständige API-Referenz — Endpunkt-Schemata, Authentifizierungsdetails und Beispiele — ist verfügbar unter buqq.online/api-docs.
Telegram-Buchungsbenachrichtigungen werden unter Einstellungen → Benachrichtigungen eingerichtet. Siehe den Abschnitt Einstellungendieses Leitfadens für die Einrichtungsschritte.

Händler-ID#

Ihre Händler-ID ist eine eindeutige Kennung für Ihr Konto innerhalb der Buqq-Plattform. Sie wird auf der Integrationsseite angezeigt und ist erforderlich, wenn Sie den Support kontaktieren oder bestimmte API-Endpunkte verwenden.

API-Schlüssel#

Die externe Buqq-API ermöglicht es Ihnen, Verfügbarkeit abzurufen, Buchungen zu erstellen und Buchungsstatus aus Ihren eigenen Systemen zu aktualisieren. Der API-Zugang erfordert einen API-Schlüssel, der mit Ihrem Händlerkonto verknüpft ist.

Einen Schlüssel generieren

  1. Scrollen Sie unter Dashboard → Integrationen zum Abschnitt "API-Schlüssel".
  2. Klicken Sie auf "API-Schlüssel generieren".
  3. Kopieren Sie den Schlüssel und speichern Sie ihn in Ihren Umgebungsvariablen oder Ihrem Secrets-Manager.
Behandeln Sie Ihren API-Schlüssel wie ein Passwort — teilen Sie ihn nicht und committen Sie ihn nicht in die Versionskontrolle. Wenn Sie vermuten, dass ein Schlüssel kompromittiert wurde, widerrufen Sie ihn sofort und generieren Sie einen neuen.

Den aktuellen Schlüssel anzeigen

Wenn Sie Ihren bestehenden Schlüssel abrufen müssen, klicken Sie auf Anzeigen— der vollständige Schlüssel wird angezeigt, sodass Sie ihn erneut kopieren können.

Einen Schlüssel rotieren

Beim Rotieren wird Ihr aktueller Schlüssel durch einen neuen ersetzt. Der alte Schlüssel wird sofort ungültig. Aktualisieren Sie alle Integrationen, die den alten Schlüssel verwenden, bevor Sie rotieren.

Einen Schlüssel widerrufen

Beim Widerrufen wird der aktuelle Schlüssel gelöscht, ohne einen neuen auszustellen. API-Aufrufe schlagen fehl, bis Sie einen neuen Schlüssel generieren. Verwenden Sie den Widerruf, wenn Sie vermuten, dass ein Schlüssel kompromittiert wurde.

cURL-Beispiele#

Die Integrationsseite zeigt einsatzbereite cURL-Beispiele für die gängigsten API-Operationen. Ersetzen Sie YOUR_API_KEYdurch Ihren tatsächlichen Schlüssel, um sofort zu testen.

BEISPIEL — Verfügbarkeit prüfen

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

POS-Hinweise#

Wenn Sie Buqq mit einem Kassensystem verbinden, unterstützt die externe API das Abrufen der heutigen bestätigten Buchungen und das Aktualisieren von Status (z. B. eine Buchung als eingecheckt oder storniert markieren) von Ihrem POS aus. Konsultieren Sie die Dokumentation Ihres POS-Anbieters für die spezifischen Integrationsschritte und die API-Dokumentationfür Endpunktdetails.

GET /api/external/v1/availability
Gibt verfügbare Zeitfenster für ein bestimmtes Datum und eine Gruppengröße zurück.
GET /api/external/v1/bookings
Listet Buchungen für Ihr Restaurant auf. Filterbar nach Datum.
POST /api/external/v1/bookings
Erstellt eine neue Buchung programmatisch.
PATCH /api/external/v1/bookings/{id}/status
Aktualisiert einen Buchungsstatus (confirmed, checked_in, cancelled, no_show).