Öffentliche API für KI-Buchungen
Über die öffentliche Kunden-API kannst du Playrooms durchsuchen und Buchungen bis zur Bezahlung anstoßen — auch direkt über KI-Assistenten. Alle Pfade liegen unter /v1/ und sind in Kleinbuchstaben gehalten.
Öffentliche Endpunkte
Zum Suchen und Lesen ist kein API-Schlüssel nötig:
| Methode | Pfad | Beschreibung |
|---|---|---|
GET | /v1/playrooms | Playroom-Katalog durchsuchen (paginiert) |
GET | /v1/playrooms/{urlPath} | Details zu einem Playroom |
GET | /v1/playrooms/{urlPath}/booking-options | Verfügbare Check-in-/Check-out-Zeiten und Preise |
GET | /v1/openapi.json | OpenAPI-Beschreibung der gesamten API |
Buchung mit API-Schlüssel
Zum Anlegen und Bezahlen einer Buchung benötigst du einen API-Schlüssel, den du im X-API-Key-Header mitschickst:
| Methode | Pfad | Beschreibung |
|---|---|---|
POST | /v1/orders | Buchung anlegen (idempotent über den Idempotency-Key-Header) |
GET | /v1/orders/{orderId} | Status und Details einer Buchung |
POST | /v1/orders/{orderId}/payment | Zahlungslink für die Buchung erzeugen |
API-Schlüssel erstellen
Erstelle und verwalte deine API-Schlüssel selbst in deinem Konto unter API-Schlüssel. Der Schlüssel wird nur einmal angezeigt — bewahre ihn sicher auf. Buchungen, die über einen deiner Schlüssel entstehen, werden deinem Konto zugeordnet.
OpenAPI-Spezifikation
Die vollständige, maschinenlesbare Beschreibung aller Endpunkte, Schemas und Fehlerfälle findest du unter /v1/openapi.json.
MCP-Server
KI-Assistenten können dieselben Fähigkeiten auch über den MCP-Server nutzen: /mcp. Er bietet die Tools search_playrooms, get_playroom, get_booking_options, create_booking, get_booking und create_payment_session.
Regeln und Versionierung
- Versionierung erfolgt über den URL-Pfad (
/v1/, später/v2/); alle Pfade sind lowercase. - Idempotenz:
POST /v1/orderserwartet einenIdempotency-Key-Header, damit wiederholte Aufrufe keine Doppelbuchung erzeugen. - Fehler: Antworten im Fehlerfall verwenden RFC-7807-
ProblemDetailsmit einem stabilencode-Feld. - Rate-Limit: Anfragen werden pro API-Schlüssel limitiert; Details dazu stehen in der OpenAPI-Spezifikation.