Entwicklerdoku
So verbinden Sie StayParity mit Ihren eigenen Systemen: signierte Webhooks, vor dem Start dokumentiert, und das Direktbuchungs-Badge für die Hotel-Website.
StayParity bietet zwei Bausteine, auf denen Sie aufbauen können: Webhooks, die Ihrem Server melden werden, wenn eine OTA ein Hotel unterbietet, und ein Badge, das Gästen auf der eigenen Website des Hotels zeigt, dass sich die Direktbuchung lohnt.
Webhooks
Webhooks sind noch nicht in Betrieb. Wir dokumentieren sie vor dem Start, und heute erhält sie kein Hotel. Sobald sie in Betrieb sind, wird StayParity jede bestätigte Preisabweichung als signiertes JSON an Ihre URL senden: eine OTA, deren eigene Seite das Zimmer des Hotels unter dessen Direktpreis verkauft. Damit können Sie ein Ticket anlegen, das Revenue Management des Hotels benachrichtigen oder Ihr eigenes Reporting speisen.
Die Zustellungen werden Standard Webhooks folgen, sodass eine fertige Bibliothek sie in wenigen Zeilen prüft. Unter Webhooks finden Sie das Ereignis, die Signaturen, die erneuten Versuche und das Testen.
Website-Badge
Ein einziges <script>-Tag auf der Buchungsseite des Hotels zeigt Gästen den Direktpreis neben den Preisen der OTAs, wenn das Hotel am günstigsten oder gleichauf ist. Ist eine OTA günstiger, zeigt es nur den eigenen Preis des Hotels. Unter Website-Badge finden Sie das Snippet, seine Optionen und was es zeigt.
Schlüssel
Beide haben ihren eigenen Schlüssel, und die beiden funktionieren unterschiedlich:
| Schlüssel | Format | Wo | Geheim? |
|---|---|---|---|
| Signatur | whsec_… | Settings → Webhooks, einer pro Konto | Ja. Lassen Sie ihn auf Ihrem Server. |
| Einbettung | wk_… | Settings → Website badge, einer pro Hotel | Nein. Jeder sieht ihn im HTML des Hotels. |
Der Signaturschlüssel beweist, dass ein Webhook von StayParity stammt. Er wird nur einmal angezeigt, und nur Kontoadmins können ihn erstellen oder ersetzen.
Der Einbettungsschlüssel erlaubt einer Seite nur, das Badge dieses Hotels anzuzeigen, und das Badge zeigt nur, was jeder Gast ohnehin sehen könnte. Jeder kann ihn aus dem Quelltext der Seite kopieren. Wenn Ihnen das wichtig ist, ersetzen Sie das Snippet im Portal, und der alte Schlüssel funktioniert nicht mehr. Der Browser eines Gastes zeigt eine Karte, die er in den letzten fünf Minuten geladen hat, möglicherweise weiter an.
Eine öffentliche API zum Lesen oder Ändern von Kontodaten gibt es noch nicht. Webhooks werden an Ihren Server senden, und das Badge ruft den öffentlichen Vergleich ab, den es anzeigt. Keines von beiden braucht ein API-Token.
Für Tools und Agenten
- Die Spezifikation des Webhooks als OpenAPI 3.1, mit dem Ereignis unter
webhooks. - Diese Doku als reiner Text für Sprachmodelle: llms.txt listet die Seiten auf, llms-full.txt enthält sie alle in einer Datei.
- Jede Seite als Markdown: Hängen Sie
.mdan ihre Adresse an, wie bei /de/developers/webhooks.md. Die Übersicht liegt unter /de/developers/index.md.