Dokumentace pro vývojáře
Jak propojit StayParity s vašimi systémy: podepsané webhooky, zdokumentované ještě před spuštěním, a widget pro přímé rezervace na web hotelu.
StayParity nabízí dvě věci, na kterých můžete stavět: webhooky, které budou vašemu serveru hlásit, když OTA prodává pokoj hotelu levněji než hotel sám, a widget, který hostům na vlastním webu hotelu ukáže, že se vyplatí rezervovat přímo.
Webhooky
Webhooky zatím nejsou v provozu: dokumentujeme je ještě před spuštěním a dnes je nedostává žádný hotel. Až budou v provozu, StayParity pošle každou potvrzenou cenovou disparitu na vaši URL jako podepsaný JSON: OTA, jejíž vlastní stránka prodává pokoj hotelu levněji, než je jeho přímá cena. Podle ní můžete založit tiket, dát vědět revenue manažerovi nebo ji poslat do vlastních reportů.
Doručení se budou řídit specifikací Standard Webhooks, takže je hotová knihovna ověří na pár řádcích. Událost, podpisy, opakované pokusy a testování popisuje stránka Webhooky.
Widget na web
Jeden tag <script> na rezervační stránce hotelu ukáže hostům přímou cenu vedle cen OTA, když je hotel nejlevnější nebo stejně drahý. Když je některá OTA levnější, ukáže jen cenu hotelu. Kód pro vložení, jeho možnosti a to, co widget ukazuje, popisuje stránka Widget na web.
Klíče
Každá z obou věcí má vlastní klíč a každý funguje jinak:
| Klíč | Vypadá jako | Kde | Tajný? |
|---|---|---|---|
| Podpisový klíč | whsec_… | Settings → Webhooks, jeden na účet | Ano. Nechte ho na svém serveru. |
| Klíč pro vložení | wk_… | Settings → Website badge, jeden na hotel | Ne. Je ve veřejném HTML hotelu. |
Podpisový klíč dokazuje, že webhook přišel od StayParity. Zobrazí se jen jednou a vytvořit nebo nahradit ho mohou jen správci účtu.
Klíč pro vložení dovoluje stránce jen zobrazit widget daného hotelu, a ten ukazuje jen to, co by mohl vidět kterýkoli host. Zkopírovat si ho ze zdrojového kódu stránky může kdokoli. Pokud vám na tom záleží, nahraďte kód pro vložení v portálu a starý klíč přestane fungovat. Prohlížeč hosta může dál ukazovat kartu, kterou načetl během posledních pěti minut.
Veřejné API pro čtení nebo změnu dat účtu zatím neexistuje. Webhooky budou posílat data na váš server a widget si stahuje veřejné porovnání, které zobrazuje. Ani jedno nepotřebuje API token.
Pro nástroje a agenty
- Kontrakt webhooku ve formátu OpenAPI 3.1, s událostí pod klíčem
webhooks. - Tato dokumentace jako prostý text pro jazykové modely: llms.txt obsahuje seznam stránek, llms-full.txt je obsahuje všechny v jednom souboru.
- Každá stránka v Markdownu: přidejte k její adrese
.md, například /cs/developers/webhooks.md. Přehled je na /cs/developers/index.md.