API Referenz

REST API

Alle Endpunkte, mit denen Sie eigene Integrationen, POS-Anbindungen und Automatisierungen bauen.

Base URL

https://platzeo.de/api

Authentifizierung per Authorization: Bearer <token> Header. API-Keys erstellen Sie im Admin Dashboard.

Authentifizierung

Alle Anfragen werden mit einem API-Key autorisiert, der im Admin-Dashboard erstellt wird.

POST

/api/auth/token

Kurzlebiges Access-Token tauschen

Restaurants

Restaurants verwalten (nur bei Organisation-Accounts).

GET

/api/restaurants

Alle Restaurants des Accounts auflisten

GET

/api/restaurants/{slug}

Details zu einem Restaurant

PATCH

/api/restaurants/{slug}

Restaurant-Einstellungen aktualisieren

Verfügbarkeit

Freie Slots abfragen - das Kernstück jeder Integration.

GET

/api/booking/{slug}

Öffentliche Buchungsdaten und Konfiguration

GET

/api/booking/{slug}/availability

Verfügbare Zeitslots für Datum und Gästezahl

Reservierungen

Reservierungen anlegen und verwalten.

POST

/api/booking/{slug}/reservations

Neue Reservierung anlegen

GET

/api/reservations

Reservierungen auflisten und filtern

GET

/api/reservations/{id}

Einzelne Reservierung abrufen

PATCH

/api/reservations/{id}

Status oder Tischzuweisung ändern

DELETE

/api/reservations/{id}

Reservierung stornieren

Gäste

Gästeprofile und Besuchshistorie.

GET

/api/guests

Gäste auflisten und suchen

GET

/api/guests/{id}

Gastprofil mit Besuchshistorie

PATCH

/api/guests/{id}

Notizen und Präferenzen speichern

Treueprogramm

Stempel buchen, Pässe ausstellen, Einlösungen verwalten.

POST

/api/loyalty/{slug}/stamp

Stempel für einen Gast buchen

POST

/api/loyalty/{slug}/redeem

Belohnung einlösen

GET

/api/loyalty/{slug}/pass/{id}.pkpass

Apple Wallet Pass abrufen

Webhooks

Abonnieren Sie Events und erhalten Sie POST-Requests bei Änderungen. Alle Payloads sind HMAC-signiert.

GET

/api/webhooks

Registrierte Webhooks auflisten

POST

/api/webhooks

Neuen Webhook registrieren

DELETE

/api/webhooks/{id}

Webhook entfernen

OpenAPI-Spezifikation

Wir bieten eine vollständige OpenAPI 3.1 Spezifikation als Grundlage für Client-Generatoren und eigene Tools.

OpenAPI-Spec anfordern