Partner API a szálloda adataihoz, a kategóriákhoz, az egységekhez, a díjcsomagokhoz, az elérhetőséghez és a napi árakhoz
Hotelirányítás, API és integrációk
CSV-export helyett dokumentált interfészek: a pénztárak, a foglalási oldalak és az Ön rendszerei ugyanazokkal a foglalásokkal dolgoznak.
Minden szállodának vannak rendszerei, amelyeket meg akar tartani: az éttermi pénztár, a saját foglalási oldal, a riportok. A STRYK dokumentált interfészeken köti össze őket: a Partner API a foglalásokhoz, vendégekhez, díjcsomagokhoz és az elérhetőséghez, a pénztárinterfész a szobára könyvelt tételekhez, mellettük pedig aláírt webhookok. A referencia nyilvánosan elérhető a fejlesztői portálon.
A Partner API referenciája, jogosultságai és webhookjai: Fejlesztői portál
API és integrációk
Foglalások létrehozása, lekérdezése és sztornózása, a kapcsolattartási adatok és a megjegyzések módosítása
Vendégek, fizetési állapot és kiállított számlák lekérdezése
Pénztárinterfész a szobára könyvelt tételekhez, nyilvános OpenAPI-referenciával
Aláírt webhookok foglalásokhoz, vendégekhez, elérhetőséghez, díjcsomagokhoz és fizetésekhez
Szállodánkénti kulcsok jogosultságokkal, lejárattal és IP-engedélyezőlistával
Így működik a hotelben
- 01Partner API
- 02Pénztárinterfész (POS API)
- 03Webhookok
- 04Kulcsok és jogosultságok
- 05Fejlesztői portál
- 06OpenAPI-referencia
Négy konkrét feladat a hotel mindennapjaiban.
Saját foglalási oldal
Az oldal lekérdezi az elérhetőséget, a díjcsomagokat és a napi árakat, a STRYK-kel kiszámíttatja az ajánlatot, és létrehozza a foglalást. A „notifyGuest” beállítással a STRYK elküldi a vendégnek a megszokott foglalási visszaigazolást. A foglalás nyitott egyenleggel indul; a fizetés a szálloda saját fizetési módjain keresztül történik.
Pénztárgyártók
Bejelentkezett vendégek szobáinak lekérdezése, a vendég megkeresése szobaszám alapján, tételek könyvelése egyenként vagy egyszerre legfeljebb 50 darabban, és sztornózásuk, amíg nincsenek elszámolva. Ha a szobaszám nem egyértelmű, a STRYK visszakérdez, nem találgat.
Riportok és saját rendszerek
Az IT-csapata csak olvasási jogú kulccsal tölti le a foglalásokat, a vendégeket, a fizetési állapotot és a kiállított számlákat. A webhookok azonnal jelzik a változásokat, így a rendszerének nem kell néhány percenként rákérdeznie.
Gyakori kérdések: API és integrációk
Hol találom a technikai dokumentációt?+
A STRYK fejlesztői portálján, a /developers címen: első lépések, hitelesítés, jogosultságok, végpontok, webhookok, hibák és kéréskorlátozás. A pénztárinterfész OpenAPI-referenciája ott YAML és JSON formátumban érhető el.
Mire képes a Partner API?+
Lekérdezi a szálloda adatait, a kategóriákat, az egységeket, a díjcsomagokat, az elérhetőséget és a napi árakat, ajánlatot számol, foglalásokat kérdez le, hoz létre és sztornóz, valamint módosítja a kapcsolattartási adatokat és a megjegyzéseket. Emellett lekérdezi a vendégeket és módosítja a kapcsolattartási adataikat, továbbá lekérdezi a fizetési állapotot és a kiállított számlákat.
Hogyan kapok kulcsot?+
A szálloda egyik adminisztrátora hozza létre a STRYK-ben, a Csatornák → API menüpontban, és kiválasztja a jogosultságokat, például csak az elérhetőség és a díjcsomagok olvasását. Minden kulcs pontosan egy szállodához tartozik.
Mennyibe kerül az interfészek használata?+
A dokumentáció a fejlesztők számára ingyenes. A Partner API-t a szálloda kiegészítő modul nélkül, a STRYK alapdíján belül használja: 59 EUR, plusz szobánként és havonta 6 EUR. A pénztárak bekötése a STRYK POS kiegészítő modul része (szobánként 2,50 EUR, apartmanonként vagy nyaralónként 3,75 EUR havonta).
Milyen webhookok vannak?+
booking.created, booking.updated, booking.cancelled, guest.updated, availability.changed, rate.changed, payment.updated és webhook.test. Minden kézbesítés HMAC-aláírással érkezik, hiba esetén pedig automatikusan megismétlődik.
Hogyan védett a hozzáférés?+
Minden kulcs pontosan egy szállodához tartozik, saját jogosultságai, lejárati dátuma és igény szerint IP-engedélyezőlistája van. A webhookok HMAC-aláírással érkeznek, a kérések száma korlátozott, és a szálloda bármikor visszavonhat egy kulcsot.
Fogadhatok fizetést az API-n keresztül?+
Nem. A kártyaadatok és a fizetések nem az API-n keresztül futnak. Az új foglalások nyitott egyenleggel indulnak, amelyet a szálloda a saját fizetési módjain szed be. A fizetési állapotot az API-n keresztül kérdezheti le.
Tanúsított a STRYK bizonyos pénztárakhoz?+
Nem. Egyetlen pénztárat sem nevezünk „tanúsítottnak”, és egyetlen márkát sem „támogatottnak”, amíg nincs igazoltan lezárt bekötés. Kérdezze meg tőlünk, hol tart az Ön rendszere.
Illik a(z) API és integrációk az Ön szállodájához?
14 nap ingyen. Minden STRYK alapalkalmazás az árban. Nincs beállítási díj; az opcionális AI-modulok külön szerepelnek.
