Entwickler
STRYK Partner API
Die Partner API verbindet deine Software mit einem Hotel in STRYK. Du liest Zimmerkategorien, Verfügbarkeit und Preise, legst Buchungen an und stornierst sie, hältst Gastkontaktdaten aktuell und erhältst einen signierten Webhook, sobald sich etwas ändert.
Was du damit baust
- Eigene BuchungswebsiteZimmerkategorien zeigen, Verfügbarkeit prüfen, einen Aufenthalt kalkulieren und die Buchung direkt in STRYK anlegen.
- Abgleich mit anderer SoftwareBuchungen, Gäste und Rechnungen in CRM, Data Warehouse oder Schließsystem spiegeln, mit Deltas und Webhooks.
- Auf Änderungen reagieren
booking.updated,availability.changedund weitere Ereignisse kommen Sekunden nach der Änderung an.
Die API arbeitet in beide Richtungen. Lesend erreichst du Hoteldaten, Verfügbarkeit, Preise, Buchungen, Gäste, Zahlungsstatus und finalisierte Rechnungen. Schreibend legst du Buchungen an, änderst und stornierst sie, aktualisierst Gastkontaktdaten, setzt Tagespreise, Verfügbarkeitsbeschränkungen und Zimmerstatus und buchst Überweisungen auf Rechnungen. Ausgehende Webhooks melden deinem System, was sich geändert hat, du musst nicht pollen.
Grundlagen
| Thema | Konvention |
|---|---|
| Basis-URL | https://app.staystryk.com/api/partner/v1 |
| Authentifizierung | Authorization: Bearer stryk_live_…, ein Schlüssel je Integration und Hotel, siehe Authentifizierung |
| Format | JSON über HTTPS, Felder in camelCase, Fehler als RFC 9457 application/problem+json, siehe Fehler |
| Zeit | Zeitpunkte in RFC 3339 UTC (2026-11-04T08:15:00.000Z); Aufenthaltsdaten als YYYY-MM-DD in Hotel-Ortszeit; die IANA-Zeitzone des Hotels liefert GET /hotel |
| Geld | {"amount": "123.45", "currency": "EUR"}, Dezimal-String mit genau zwei Nachkommastellen und ISO-4217-Code |
| Listen | Cursor-Pagination mit limit (1-200) und cursor, Deltas mit updated_since, siehe Pagination |
| Grenzen | Standardmäßig 120 Anfragen je 60 Sekunden und Schlüssel, Request-Bodys bis 64 KiB, siehe Rate-Limits |
| Versionierung | Hauptversion im Pfad (v1); additive Änderungen ohne neue Version, siehe Versionierung |
Jede Antwort enthält den Header X-Request-Id und Cache-Control: no-store. Nenne die Request-ID, wenn du das Hotel oder den STRYK-Support zu einem bestimmten Aufruf kontaktierst.
Ressourcen
Die API-Referenz beschreibt jeden Endpunkt mit Parametern, Schemas, Beispielen und Code. Diese Übersicht entsteht aus derselben OpenAPI-Spezifikation.
Was die API nicht tut
- Keine Kartendaten, keine Zahlungen. API v1 nimmt keine Zahlungen entgegen. Eine per API angelegte Buchung hat einen offenen Saldo, den das Hotel über seine bestehenden STRYK-Zahlungswege oder an der Rezeption begleicht.
GET /bookings/{id}/paymentszeigt den Stand. - Keine eigene Preislogik. Preise kommen immer aus STRYK. Deine Buchungsanfrage kann den Preis mitschicken, den der Gast gesehen hat (
expectedTotal); hat er sich geändert, lehnt STRYK die Buchung mit409 conflictab. - Ein Hotel je Schlüssel. Ein Schlüssel gehört zu genau einem Hotel. Gruppen verwenden einen Schlüssel je Betrieb.
- Nur Server zu Server. Schlüssel gehören nie in Browser- oder App-Code. Rufe die API aus deinem Backend auf.