Siirry sisältöön
Partner API ja kehittäjäportaali

Järjestelmäsi lukevat ja kirjoittavat suoraan STRYK-järjestelmään.

Oma varaussivu, revenue-työkalu tai agenturisi Housekeeping-sovellus: Partner API yhdistää ne hotellisi varauksiin, hintoihin, saatavuuteen ja huoneiden tilaan. Sinä päätät, mitä kukin API-avain saa tehdä. Viitteen, oppaat ja koodiesimerkit julkaisemme avoimesti kehittäjäportaalissa, jotta kehittäjäsi pääsevät alkuun ilman kiertoteitä.

Partner API:n viite, oikeudet ja webhookit: Siirry kehittäjäportaaliin

Lukeminen ja kirjoittaminen

Varaukset, päivähinnat, saatavuus, siivoustila ja tilisiirrot.

Allekirjoitetut webhookit

STRYK ilmoittaa muutokset varauksissa, vieraissa, hinnoissa, maksuissa ja huoneissa.

Avaimet ja oikeusalueet

Jokainen avain kuuluu yhdelle hotellille, ja siihen liittyvät oikeudet, voimassaolo ja IP-sallittujen lista.

Avoin dokumentaatio

Quickstart, oppaat ja OpenAPI-viite saksaksi ja englanniksi.

Lukeminen ja varaaminen

Varaussivu, joka laskee hotellisi todellisilla hinnoilla.

Partner API tarjoaa hotellin, huonetyypit, yksiköt, saatavuuden ja päivähinnat. Jokaista tiedustelua kohden STRYK laskee tarjouksen samoin säännöin kuin Booking Engine, mukaan lukien paikallinen majoitusvero ja pakolliset lisäpalvelut. Varauksen luot Idempotency-Keyllä, ja halutessasi STRYK lähettää vieraalle tutun vahvistussähköpostin.

  • Tarjous, jonka hinnan palvelin laskee
  • Varausten luominen, muuttaminen ja peruuttaminen
  • Vieraiden, maksutilanteen ja laadittujen laskujen lukeminen
  • Peruutus hotellin omien ehtojen mukaan
Hinnat ja saatavuus

Revenue-työkalusi asettaa päivähinnat suoraan hintakalenteriin.

rates:write-oikeudella työkalu kirjoittaa päivähintoja huonetyypeittäin, enintään 366 päivää kerrallaan. Huonetyyppiesi vähimmäis- ja enimmäishinnat pysyvät voimassa, ja tyhjä hinta palauttaa päivän hinnoittelusääntöihisi. availability:write-oikeudella työkalu luo sulkemiset, kiintiöt sekä saapumis- ja lähtösulut ja poistaa vain omat merkintänsä. Tiimisi sulut pysyvät sinun hallinnassasi.

  • rates:write päivähinnoille huonetyypeittäin
  • availability:write sulkuihin ja kiintiöihin
  • Huonetyyppien rajat pysyvät voimassa
  • Jokainen hinnanmuutos kirjataan avaimen tunnuksella
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.
Huoneet ja maksut

Huoneen tila Housekeeping-sovelluksesta, tilisiirrot kirjanpidosta.

property:write-oikeudella sovellus asettaa yksikön siivoustilan, esimerkiksi likaisesta tarkistetuksi. If-Match suojaa vanhentuneilta tiloilta, ja varaukset, sulut sekä perustiedot säilyvät STRYK-järjestelmässä. payments:write-oikeudella järjestelmä kirjaa saadun tilisiirron laaditulle laskulle, enintään avoimen summan verran.

  • Siivoustila versiotarkistuksella
  • Tilisiirto laaditulle laskulle
  • Laskut säilyvät tositteina: STRYK säilyttää ne
  • Toistuvat kutsut on suojattu idempotenssilla
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.
Avaimet ja webhookit

Sinä päätät, kuka pääsee käsiksi. STRYK kertoo, mikä muuttuu.

Ylläpitäjä luo API-avaimen kohdassa Kanavat → API, ja hän voi rajata oikeudet alueittain, asettaa vanhenemispäivän ja halutessaan IP-sallittujen listan. Avainta vaihdettaessa vanha avain on voimassa vielä 24 tuntia tai päättyy heti. STRYK allekirjoittaa webhookit, kuten booking.created, rate.changed tai unit.updated, HMAC-SHA256-menetelmällä, yrittää ne uudelleen virheen sattuessa ja näyttää ne toimitusloissa.

  • Kirjoitusoikeus sisältää lukuoikeuden
  • Oletuksena 120 pyyntöä minuutissa
  • Toimitusloki, jossa on ”Lähetä uudelleen”
  • Avaimet voi peruuttaa milloin tahansa
Kiinteistötekniikka

Ovilukko, puhelin, TV ja WLAN toimivat STRYK-järjestelmän kanssa.

Partner API:n rinnalla STRYK liittää talosi tekniikan. Check-in, huoneenvaihto ja check-out vaikuttavat avaimiin, puhelinjärjestelmään, hotellin TV:hen ja WLAN-yhteyteen, ilman että vastaanoton tarvitsee kirjoittaa mitään kahteen kertaan.

Ideasta toimivaan liitäntään.

Näin etenet yhdessä kehittäjiesi kanssa.

  1. 01

    Luo avain

    Ylläpitäjä valitsee juuri ne oikeusalueet, joita liitäntä tarvitsee. STRYK näyttää avaimen kerran.

  2. 02

    Rakenna viitettä vasten

    Kehittäjäsi aloittavat Quickstartista ja JavaScriptillä tai Pythonilla kirjoitetuista koodiesimerkeistä.

  3. 03

    Aloita lukuoikeudella

    Ensin lukeminen, sitten kirjoittavien kutsujen tarkistus sovituilla testidatalla.

  4. 04

    Yhdistä webhookit

    Allekirjoitetut tapahtumat pitävät liitetyn järjestelmän STRYK-tietojen tasalla.

Kuka tätä käyttää.

Kehittäjät ja agentuurit

Varaussivuja, synkronointipalveluja ja työkaluja rakennetaan dokumentoitua OpenAPI-viitettä vastaan.

Johto ja ylläpitäjät

Myönnä avaimet juuri tarvittavilla oikeuksilla ja peruuta ne, kun yhteistyö päättyy.

Revenue ja Housekeeping

Jatkavat työskentelyä tutussa työkalussaan, kun hinnat ja huoneiden tila saapuvat suoraan STRYK-järjestelmään.

Usein kysytyt: API ja integraatiot

Mistä löydän tekniset dokumentit?

STRYK-kehittäjäportaalissa osoitteessa /developers: aloitus, todennus, oikeudet, päätepisteet, webhookit, virheet ja pyyntömäärärajoitukset. Kassaliittymän OpenAPI-viite on siellä saatavilla YAML- ja JSON-muodossa.

Mitä Partner API osaa?

Lukea hotellin, huonetyyppien, yksiköiden, hintojen, saatavuuden ja päivähintojen tiedot, laskea tarjouksia, lukea, luoda ja peruuttaa varauksia sekä muuttaa yhteystietoja ja muistiinpanoja. Lisäksi lukea vieraita ja muuttaa heidän yhteystietojaan sekä lukea maksutilanteen ja laaditut laskut. Kirjoitusoikeuksilla se asettaa lisäksi yksiköiden siivoustilan ja saatavuuden estot sekä päivähinnat ja kirjaa saapuneet tilisiirrot laskuille.

Miten saan avaimen?

Hotellin ylläpitäjä luo avaimen STRYKissä kohdassa Kanavat → API ja valitsee oikeudet, esimerkiksi vain saatavuuden ja hintojen lukemisen. Jokainen avain kuuluu täsmälleen yhdelle hotellille.

Mitä liittymien käyttö maksaa?

Dokumentaatio on kehittäjille ilmainen. Partner API kuuluu hotellin STRYK-perushintaan ilman lisämoduulia. Kassojen liittäminen kuuluu STRYK POS -lisämoduuliin.

Mitä webhookeja on?

booking.created, booking.updated, booking.cancelled, guest.updated, availability.changed, rate.changed, payment.updated, unit.updated ja webhook.test. Jokainen toimitus on allekirjoitettu HMAC:lla, ja se yritetään automaattisesti uudelleen virheen sattuessa.

Miten pääsy on suojattu?

Jokainen avain kuuluu täsmälleen yhdelle hotellille, sillä on omat oikeudet, voimassaolo ja halutessa IP-sallittulista. Webhookit on allekirjoitettu HMAC:lla, pyynnöt on rajattu määrällisesti, ja hotelli voi peruuttaa avaimen milloin tahansa.

Näytä lisää kysymyksiä
Miten maksut toimivat API:n kautta tehdyissä varauksissa?

Maksut kerää hotelli STRYK Paymentsin ja sen määritettyjen maksutapojen kautta; korttitiedot säilyvät siellä. Uusissa API:n kautta luoduissa varauksissa on alussa avoin saldo, jonka hotelli perii maksulinkillä, verkossa tai kortinlukijalla. Maksutilanteen luet API:sta, ja kirjoitusoikeudella se kirjaa saapuneet tilisiirrot laskulle.

Mitkä kassat sopivat STRYKiin?

Ei. Emme nimitä yhtään yhteyttä ”sertifioiduksi” emmekä yhtään brändiä ”tuetuksi”, ennen kuin valmis yhteys on todistettu. Kysy meiltä järjestelmäsi tilanne.

Kerro meille, mitä haluat liittää.

Kokeile STRYK-järjestelmää 14 päivää omassa hotellissasi tai keskustele kanssamme demossa liitännästäsi. Viiteasiakirjat ovat aina saatavilla kehittäjäportaalissa.

Yhteystiedot