Pereiti prie turinio
Partner API su kūrėjų portalu

Tavo sistemos skaito ir rašo tiesiogiai STRYK.

Tavo paties rezervacijų puslapis, pajamų valdymo įrankis ar tavo agentūros Housekeeping programėlė: Partner API juos sujungia su tavo viešbučio rezervacijomis, kainomis, prieinamumu ir kambarių būsena. Tu nusprendi, ką kiekvienas API raktas gali daryti. Dokumentaciją, vadovus ir kodo pavyzdžius viešai skelbiame kūrėjų portale, kad tavo kūrėjai galėtų pradėti iš karto.

Partnerių API nuorodos, leidimai ir webhook'ai: Į kūrėjų portalą

Skaityti ir rašyti

Rezervacijos, dienos kainos, prieinamumas, valymo būsena ir pavedimai.

Pasirašyti webhook

STRYK praneša apie rezervacijų, svečių, kainų, mokėjimų ir kambarių pakeitimus.

Raktai su scopes

Kiekvienas raktas priklauso vienam viešbučiui, su teisėmis, galiojimo laiku ir IP allowlist.

Atvira dokumentacija

Quickstart, vadovai ir OpenAPI dokumentacija vokiečių ir anglų kalbomis.

Skaityti ir rezervuoti

Rezervacijų puslapis, skaičiuojantis su tikromis tavo viešbučio kainomis.

Partner API teikia viešbutį, kambarių kategorijas, vienetus, prieinamumą ir dienos kainas. Kiekvienam užklausimui STRYK apskaičiuoja pasiūlymą pagal tas pačias taisykles kaip Booking Engine, įskaitant turizmo mokestį ir privalomas papildomas paslaugas. Rezervaciją sukuri su Idempotency-Key, o jei nori, STRYK svečiui išsiunčia įprastą patvirtinimo el. laišką.

  • Pasiūlymas su serveryje apskaičiuota kaina
  • Kurti, keisti ir atšaukti rezervacijas
  • Skaityti svečius, mokėjimo būseną ir išrašytas sąskaitas faktūras
  • Atšaukimas pagal viešbučio sąlygas
Kainos ir prieinamumas

Tavo pajamų valdymo įrankis nustato dienos kainas tiesiai kainų kalendoriuje.

Su rates:write įrankis įrašo dienos kainas pagal kambario kategoriją, iki 366 dienų per kvietimą. Kategorijų mažiausios ir didžiausios kainos ir toliau galioja, o tuščia kaina grąžina dieną į tavo kainų taisykles. Su availability:write jis sukuria uždarymus, kontingentus ir atvykimo bei išvykimo apribojimus, ir gali ištrinti tik tuos įrašus, kuriuos pats sukūrė. Tavo komandos blokavimai lieka tavo rankose.

  • rates:write dienos kainoms pagal kambario kategoriją
  • availability:write blokavimams ir kontingentams
  • Kambario kategorijų ribos lieka galioti
  • Kiekvienas kainos pakeitimas įrašomas su rakto nuoroda
STRYK Preise: Die Rezeption legt eine Preisregel an, die das Panorama Studio freitags und samstags um 10 % erhöht. Nach dem Speichern zeigt der Preiskalender sofort die neuen Wochenendpreise.
Kambariai ir mokėjimai

Kambarių būsena iš Housekeeping programėlės, pavedimai iš apskaitos.

Su property:write programėlė nustato vieneto valymo būseną, pavyzdžiui iš nešvaraus į patikrintą. If-Match apsaugo nuo pasenusių būsenų, o užimtumas, blokavimai ir pagrindiniai duomenys lieka STRYK sistemoje. Su payments:write sistema įrašo gautą pavedimą į išrašytą sąskaitą faktūrą, ne daugiau nei atviras likutis.

  • Valymo būsena su versijos patikra
  • Pavedimas į išrašytą sąskaitą faktūrą
  • Sąskaitos faktūros lieka dokumentais STRYK sistemoje
  • Pakartotinius kvietimus apsaugo idempotentiškumas
STRYK Housekeeping: Ewa Nowak öffnet Zimmer 105, startet die Reinigung, hakt die vier Punkte der Checkliste ab und schließt sie ab. Das Zimmer steht erledigt für die Anreise bereit.STRYK Housekeeping: Eine Reinigungskraft öffnet Zimmer 105, hakt die Aufgaben ab und schließt das Zimmer ab. Es steht fertig für die Anreise bereit.
Raktai ir webhook

Tu nusprendi, kas gali naudotis. STRYK praneša, kas pasikeičia.

Administratorius skiltyje Kanalai → API sukuria API raktą su scopes pagal sritį, galiojimo data ir, jei reikia, IP allowlist. Keičiant raktą, senasis dar 24 valandas galioja arba baigia galioti iš karto. Webhook įvykius, pavyzdžiui booking.created, rate.changed arba unit.updated, STRYK pasirašo su HMAC-SHA256, kartoja juos klaidų atveju ir rodo pristatymo žurnale.

  • Rašymo teisė apima skaitymo teisę
  • Pagal nutylėjimą 120 užklausų per minutę
  • Pristatymo žurnalas su „Siųsti iš naujo“
  • Raktus galima bet kada atšaukti
Pastato technika

Durų spynos, telefonas, TV ir WLAN veikia su STRYK.

Be partnerių API, STRYK jungia tavo viešbučio techniką. Registracija, kambario keitimas ir išregistravimas veikia raktus, telefonų sistemą, Hotel-TV ir WLAN prieigą, o registratūrai nereikia nieko vesti du kartus.

Nuo idėjos iki veikiančios integracijos.

Kaip dirbti kartu su kūrėjais.

  1. 01

    Sukurti raktą

    Administratorius pasirenka tik tas scopes, kurių reikia integracijai. STRYK raktą parodo vieną kartą.

  2. 02

    Kurti pagal dokumentaciją

    Tavo kūrėjai pradeda nuo Quickstart ir kodo pavyzdžių JavaScript ar Python kalbomis.

  3. 03

    Pradėk nuo skaitymo teisės

    Pirmiausia skaityk, tada tik su suderintais testiniais duomenimis tikrink rašančius kvietimus.

  4. 04

    Prijunk webhook

    Pasirašyti įvykiai palaiko prijungtą sistemą sinchronizuotą su STRYK.

Kas su tuo dirba.

Kūrėjai ir agentūros

Kuria rezervacijų puslapius, sinchronizavimo paslaugas ir įrankius pagal dokumentuotą OpenAPI dokumentaciją.

Vadovai ir administratoriai

Išduodi raktus tik su reikalingomis teisėmis ir atšauki juos, kai bendradarbiavimas baigiasi.

Pajamų valdymas ir Housekeeping

Dirba savo įprastu įrankiu, o kainos ir kambarių būsena iš karto patenka į STRYK.

Dažniausi klausimai: API ir integracijos

Kur rasti techninę dokumentaciją?

STRYK kūrėjų portale adresu /developers rasi: pradžią, autentifikavimą, teises, galutinius taškus, webhook'us, klaidas ir užklausų dažnio ribojimą. POS sąsajos OpenAPI nuoroda ten pateikiama YAML ir JSON formatais.

Ką gali Partnerių API?

Skaityti viešbučio, kategorijų, vienetų, tarifų, prieinamumo ir dienos kainų duomenis, skaičiuoti pasiūlymus, skaityti, kurti ir atšaukti rezervacijas bei keisti kontaktus ir pastabas. Skaityti svečius ir keisti jų kontaktinius duomenis, skaityti mokėjimo būseną ir išrašytas sąskaitas faktūras. Su rašymo teisėmis dar nustatoma vienetų valymo būsena, prieinamumo blokavimai ir dienos kainos bei įregistruojami gauti pavedimai už sąskaitas faktūras.

Kaip gauti raktą?

Viešbučio administratorius raktą sukuria STRYK skiltyje Kanalai → API ir pasirenka teises, pavyzdžiui, tik prieinamumo ir tarifų skaitymą. Kiekvienas raktas priklauso tik vienam viešbučiui.

Kiek kainuoja sąsajų naudojimas?

Dokumentacija kūrėjams nemokama. Partnerių API viešbutis naudoja be papildomo modulio pagal pagrindinę STRYK kainą. Kasų prijungimas yra papildomo modulio STRYK POS dalis.

Kokie yra webhook'ai?

booking.created, booking.updated, booking.cancelled, guest.updated, availability.changed, rate.changed, payment.updated, unit.updated ir webhook.test. Kiekvienas pristatymas pasirašomas HMAC ir klaidos atveju automatiškai kartojamas.

Kaip apsaugota prieiga?

Kiekvienas raktas priklauso tik vienam viešbučiui, turi savo teises, galiojimo pabaigą ir pageidavimu IP leidžiamųjų sąrašą. Webhook pranešimai pasirašomi HMAC, užklausų kiekis ribojamas, o viešbutis bet kada gali atšaukti raktą.

Rodyti daugiau klausimų
Kaip vyksta mokėjimai rezervacijoms per API?

Mokėjimus viešbutis surenka per STRYK Payments ir jo nustatytus mokėjimo būdus; kortelių duomenys lieka ten pat. Naujos rezervacijos per API pradedamos su atviru likučiu, kurį viešbutis surenka per mokėjimo nuorodą, internetu ar kortelių terminale. Mokėjimo būseną skaitai per API, o su rašymo teise ji įregistruoja gautus pavedimus už sąskaitą faktūrą.

Kurios kasos tinka STRYK?

Ne. Nevadiname jokios sistemos „sertifikuota“ ir jokios markės „palaikoma“, kol neįrodytas baigtas ryšys. Paklausk mūsų apie savo sistemos būseną.

Pasakyk mums, ką nori prijungti.

Išbandyk STRYK 14 dienų su savo viešbučiu arba pasikalbėk su mumis demonstracijoje apie savo integraciją. Dokumentacija visada pasiekiama kūrėjų portale.

Kontaktas