Mine sisu juurde
Partner API koos arendajaportaaliga

Sinu süsteemid loevad ja kirjutavad otse STRYKisse.

Sinu oma broneerimisleht, tulujuhtimise tööriist või agentuuri Housekeeping-rakendus: Partner API ühendab need hotelli broneeringute, hindade, saadavuse ja toa olekuga. Sina otsustad, mida iga API võti tohib. Viidet, juhendeid ja koodinäiteid avaldame avalikult arendajaportaalis, et sinu arendajad saaksid kohe alustada.

Partner API viide, õigused ja webhookid: Ava arendajaportaal

Lugemine ja kirjutamine

Broneeringud, päevahinnad, saadavus, koristuse olek ja ülekanded.

Allkirjastatud webhookid

STRYK teatab muutustest broneeringutes, külalistes, hindades, maksetes ja tubades.

Võtmed scope'idega

Iga võti kuulub ühele hotellile, koos õiguste, aegumise ja IP-lubade loendiga.

Avatud dokumentatsioon

Quickstart, juhendid ja OpenAPI-viide saksa ja inglise keeles.

Lugemine ja broneerimine

Broneerimisleht, mis arvutab sinu hotelli tegelike hindadega.

Partner API annab hotelli, toatüübid, üksused, saadavuse ja päevahinnad. Iga päringu puhul arvutab STRYK pakkumise samade reeglite järgi nagu Booking Engine, koos turismimaksu ja kohustuslike lisateenustega. Broneeringu loob sa Idempotency-Key abil, ja soovi korral saadab STRYK külalisele tavapärase kinnituskirja.

  • Pakkumine serveris arvutatud hinnaga
  • Broneeringute loomine, muutmine ja tühistamine
  • Külaliste, makse oleku ja väljastatud arvete lugemine
  • Tühistamine hotelli tingimuste järgi
Hinnad ja saadavus

Sinu tulujuhtimise tööriist seab päevahinnad otse hinnakalendrisse.

rates:write abil kirjutab tööriist päevahindu toatüübi kaupa, kuni 366 päeva ühe päringuga. Sinu toatüüpide miinimum- ja maksimumhinnad kehtivad edasi, tühi hind lähtestab päeva sinu hinnareeglitele. availability:write abil loob see sulgemised, kontingendid ning saabumis- ja lahkumispiirangud ning kustutab sihipäraselt ainult enda loodud kirjed, ja sinu meeskonna blokeeringud jäävad sinu kätte.

  • rates:write päevahindade jaoks toatüübi kaupa
  • availability:write blokeeringute ja kontingentide jaoks
  • Toatüüpide piirangud jäävad jõusse
  • Iga hinnamuudatus logitakse koos võtme viitega
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.
Toad ja maksed

Toa olek Housekeeping-rakendusest, ülekanded raamatupidamisest.

property:write abil seab rakendus üksuse koristusoleku, näiteks mustast kontrollituks. If-Match kaitseb aegunud oleku eest, hõivatus, blokeeringud ja põhiandmed jäävad STRYKi. payments:write abil kannab süsteem laekunud ülekande väljastatud arvele, kuni avatud summani.

  • Koristuse olek koos versioonikontrolliga
  • Ülekanne väljastatud arvele
  • Arved jäävad STRYKis püsivateks dokumentideks
  • Korduvad päringud on idempotentsusega kaitstud
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.
Võtmed ja webhookid

Sina otsustad, kes ligi pääseb. STRYK teatab, mis muutub.

Administraator loob API-võtme jaotises Kanalid → API, valides iga valdkonna õigused, aegumiskuupäeva ja soovi korral IP-lubade loendi. Võtme vahetamisel kehtib vana võti veel 24 tundi või lõpeb kohe. STRYK allkirjastab webhookid, nagu booking.created, rate.changed või unit.updated, HMAC-SHA256 abil, proovib need vigade korral uuesti ja loetleb need edastuslogis.

  • Kirjutusõigus hõlmab lugemisõigust
  • Vaikimisi 120 päringut minutis
  • Edastuslogi nupuga „Saada uuesti“
  • Võtmed on igal ajal tühistatavad
Hoonetehnika

Uksed, telefon, teler ja WLAN töötavad koos süsteemiga STRYK.

Partner API kõrval seob STRYK su maja tehnika külge. Check-in, toavahetus ja check-out mõjutavad võtmeid, telefonisüsteemi, hotelli telerit ja WLAN-ligipääsu, ilma et vastuvõtt midagi kaks korda sisestaks.

Ideest töötava liidestuseni.

Nii toimid koos oma arendajatega.

  1. 01

    Võtme loomine

    Administraator valib just need scope'id, mida liidestus vajab. STRYK näitab võtit ühe korra.

  2. 02

    Ehita viite vastu

    Sinu arendajad alustavad kiirstardi ja JavaScripti või Pythoni koodinäidetega.

  3. 03

    Alusta lugemisõigusega

    Alusta lugemisega, seejärel testi kirjutavaid päringuid hotelliga kokku lepitud testandmetega.

  4. 04

    Ühenda webhookid

    Signeeritud sündmused hoiavad ühendatud süsteemi STRYKiga samas seisus.

Kes sellega töötab.

Arendajad ja agentuurid

Ehitavad broneerimisleheküljed, sünkroonimisteenused ja tööriistad dokumenteeritud OpenAPI viite järgi.

Juhid ja administraatorid

Väljastavad võtmed täpselt vajalike õigustega ja tühistavad need, kui koostöö lõpeb.

Tulujuhtimine ja Housekeeping

Töötavad edasi oma tavapärase tööriistaga, samal ajal kui hinnad ja toa olek jõuavad otse STRYKisse.

Korduma kippuvad küsimused: API ja integratsioonid

Kust leian tehnilise dokumentatsiooni?

STRYK arendajaportaalis aadressil /developers leiad alustamise, autentimise, õigused, lõpp-punktid, webhookid, vead ja päringute piirangud. Kassaliidese OpenAPI viide on seal saadaval YAML- ja JSON-vormingus.

Mida suudab Partner API teha?

Partner API loeb hotelli, kategooriaid, üksusi, hindu, saadavust ja päevahindu, arvutab pakkumisi, loeb, loob ja tühistab broneeringuid ning muudab kontakti ja märkmeid. Lisaks loeb ta külalisi ja muudab nende kontaktandmeid, loeb makseseisu ja väljastatud arveid. Kirjutamisõigusega määrab ta ka üksuste koristusseisu, saadavuse blokeeringud ja päevahinnad ning salvestab arvetele laekunud ülekanded.

Kuidas saan võtme?

Hotelli administraator loob võtme STRYKis menüüs Kanalid → API ja valib õigused, näiteks ainult saadavuse ja hindade lugemise. Iga võti kuulub täpselt ühele hotellile.

Mis maksab liideste kasutamine?

Dokumentatsioon on arendajatele tasuta. Hotell kasutab Partner API ilma lisamoduliteta STRYK põhihinna sees. Kassade ühendus kuulub lisamooduli STRYK POS hulka.

Millised webhookid on saadaval?

booking.created, booking.updated, booking.cancelled, guest.updated, availability.changed, rate.changed, payment.updated, unit.updated ja webhook.test. Iga edastus on HMAC-allkirjaga ning vigade korral saadetakse automaatselt uuesti.

Kuidas on juurdepääs kaitstud?

Iga võti kuulub täpselt ühele hotellile, sellel on oma õigused, aegumiskuupäev ja soovi korral IP-lubade loend. Webhookid on HMAC-allkirjaga, päringute arv on piiratud ning hotell saab võtme igal ajal tühistada.

Näita rohkem küsimusi
Kuidas käivad maksed API kaudu tehtud broneeringutega?

Makseid võtab hotell vastu STRYK Payments kaudu ja selle seadistatud makseviisidega, kaardiandmed jäävad samuti sinna. API kaudu loodud uued broneeringud algavad avatud saldoga, mille hotell saab koguda makselingi, veebi või kaarditerminali kaudu. Makseseisu loed API kaudu ja kirjutamisõigusega salvestab ta arvele laekunud ülekanded.

Millised kassad sobivad STRYK süsteemiga?

Ei. Me ei nimeta ühtegi süsteemi „sertifitseerituks“ ega ühtegi kaubamärki „toetatuks“, enne kui ühendus on lõpule viidud ja tõestatud. Küsi oma süsteemi staatuse kohta.

Näita meile, mida soovid ühendada.

Proovi STRYKi 14 päeva oma majutusasutusega või räägi meiega demos oma liidestusest. Viide on alati arendajaportaalis.

Kontakt