Öffentliche Endpunkte
Alle Endpunkte verwenden https://api.my-playrooms.de/v1. Der vollständige maschinen-
lesbare Vertrag steht unter /v1/openapi.json.
Katalog
| Methode | Pfad | Authentifizierung | Ergebnis |
|---|---|---|---|
GET | /v1/playrooms | Keine | Array von Playroom-Zusammenfassungen. currentPage wählt eine Seite; derzeit höchstens 20 Einträge ohne Pagination-Metadaten. |
GET | /v1/playrooms/{urlPath} | Keine | Detaillierte Playroom-Informationen. |
GET | /v1/playrooms/{urlPath}/booking-options | Keine | Buchbare Zeiten und Preise. |
Orders
| Methode | Pfad | Authentifizierung | Ergebnis |
|---|---|---|---|
POST | /v1/orders | X-API-Key und Idempotency-Key | Erstellt eine Order und liefert orderId. |
GET | /v1/orders/{orderId} | X-API-Key | Liefert die Order des API-Keys. |
POST | /v1/orders/{orderId}/payment | X-API-Key | Erstellt eine gehostete Zahlungssitzung und liefert paymentUrl. |
Die API erstellt Buchung und Zahlungssitzung, verarbeitet die Kartenzahlung aber nicht innerhalb des API-Requests. Der Gast bezahlt auf der gehosteten Zahlungsseite.
Fehler und Limits
400: Ungültige Anfrage oder fachlicher Validierungsfehler.401: Fehlender oder ungültiger API-Key.404: Ressource oder Order nicht gefunden.429: Rate-Limit überschritten.500: Unerwarteter Serverfehler.
Anwendungsfehler verwenden normalerweise ProblemDetails mit title, status und
detail. Verlasse dich nicht auf ein stabiles code-Feld. Einige unerwartete 500er
verwenden noch ein älteres Fehlerformat; Clients sollten beide Formen verarbeiten.
Die öffentliche API erlaubt 200 Requests pro 60 Sekunden. Mit API-Key wird pro Key, sonst pro Client-IP begrenzt. Ein tägliches Limit ist nicht dokumentiert.
Webhooks
Die öffentliche API bietet derzeit keine ausgehenden Buchungs-Webhooks. Frage den
Status über GET /v1/orders/{orderId} ab. Stripe-Webhook-Endpunkte im Backend sind
interne Zahlungsintegrationen und keine öffentlichen API-Endpunkte.