Pāriet uz saturu
Partner API ar izstrādātāju portālu

Tavas sistēmas lasa un raksta tieši STRYK.

Tava pašu rezervēšanas lapa, ieņēmumu rīks vai tavas aģentūras Housekeeping lietotne: Partner API savieno tos ar tavas viesnīcas rezervācijām, cenām, pieejamību un numuru statusu. Tu nosaki, ko katra API atslēga drīkst. Atsauci, ceļvežus un koda piemērus publicējam atklāti izstrādātāju portālā, lai tavi izstrādātāji varētu sākt bez liekiem soļiem.

Partneru API atsauce, atļaujas un webhooks: Uz izstrādātāju portālu

Lasīt un rakstīt

Rezervācijas, dienas cenas, pieejamība, uzkopšanas statuss un pārskaitījumi.

Parakstīti webhook

STRYK ziņo par izmaiņām rezervācijās, viesos, cenās, maksājumos un numuros.

Atslēgas ar tiesībām

Katra atslēga pieder vienai viesnīcai, ar tiesībām, derīguma termiņu un IP atļauju sarakstu.

Atvērta dokumentācija

Ātrais sākums, ceļveži un OpenAPI atsauce vācu un angļu valodā.

Lasīt un rezervēt

Rezervēšanas lapa, kas aprēķina ar tavas viesnīcas īstajām cenām.

Partner API nodrošina viesnīcu, numuru kategorijas, vienības, pieejamību un dienas tarifus. Katram pieprasījumam STRYK aprēķina piedāvājumu pēc tiem pašiem noteikumiem kā Booking Engine, ieskaitot tūrisma nodokli un obligātos papildpakalpojumus. Rezervāciju tu izveido ar Idempotency-Key, un, ja vēlies, STRYK viesim nosūta ierasto apstiprinājuma e-pastu.

  • Piedāvājums ar serverī aprēķinātu cenu
  • Rezervāciju izveide, maiņa un atcelšana
  • Lasīt viesus, maksājumu statusu un izrakstītos rēķinus
  • Atcelšana saskaņā ar viesnīcas nosacījumiem
Cenas un pieejamība

Tavs ieņēmumu rīks ieraksta dienas cenas tieši cenu kalendārā.

Ar rates:write rīks ieraksta dienas tarifus pa numuru kategorijām, līdz 366 dienām vienā izsaukumā. Tavu kategoriju minimālās un maksimālās cenas joprojām ir spēkā, un tukša cena atiestata dienu uz tavu cenu noteikumiem. Ar availability:write rīks izveido slēgumus, allotment ierobežojumus un ierašanās vai izbraukšanas bloķējumus un dzēš tikai savus ierakstus, bet tavas komandas bloķējumi paliek tavās rokās.

  • rates:write dienas cenām pa numuru kategorijām
  • availability:write bloķējumiem un allotment ierobežojumiem
  • Numuru kategoriju ierobežojumi paliek spēkā
  • Katra cenu izmaiņa tiek reģistrēta žurnālā ar atslēgas identifikatoru
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.
Numuri un maksājumi

Numuru statuss no Housekeeping lietotnes, pārskaitījumi no grāmatvedības.

Ar property:write lietotne iestata vienības uzkopšanas statusu, piemēram, no netīra uz pārbaudītu. If-Match pasargā no novecojušiem stāvokļiem, savukārt aizņemtība, bloķējumi un pamatdati paliek STRYK. Ar payments:write sistēma reģistrē saņemtu pārskaitījumu izrakstītam rēķinam, ne vairāk kā atvērtās summas apmērā.

  • Uzkopšanas statuss ar versijas pārbaudi
  • Pārskaitījums izrakstītam rēķinam
  • Rēķini STRYK paliek kā dokumenti
  • Atkārtoti izsaukumi nodrošināti ar idempotenci
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.
Atslēgas un webhook

Tu izlemj, kas piekļūst. STRYK ziņo, kas mainās.

Administrators sadaļā Kanāli → API izveido API atslēgu ar tiesībām pa jomām, derīguma termiņu un pēc izvēles IP atļauju sarakstu. Atslēgas maiņas gadījumā vecā atslēga paliek spēkā vēl 24 stundas vai beidzas uzreiz. STRYK paraksta webhook, piemēram, booking.created, rate.changed vai unit.updated, ar HMAC-SHA256, atkārtoti tos sūta kļūdu gadījumā un ieraksta piegādes žurnālā.

  • Rakstīšanas tiesības ietver lasīšanas tiesības
  • Pēc noklusējuma 120 pieprasījumi minūtē
  • Piegādes žurnāls ar pogu „Sūtīt vēlreiz“
  • Atslēgas jebkurā brīdī var atsaukt
Ēkas tehnika

Durvju slēdzenes, telefons, TV un WLAN strādā ar STRYK.

Papildus partneru API STRYK pieslēdz tavas viesnīcas tehniku. Iereģistrēšanās, numura maiņa un izrakstīšanās ietekmē atslēgas, telefonsistēmu, viesnīcas TV un WLAN piekļuvi, un reģistratūrai nav jāievada nekas divreiz.

No idejas līdz darbojošamies savienojumam.

Kā to darīt kopā ar izstrādātājiem

  1. 01

    Izveidot atslēgu

    Administrators izvēlas tieši tās tiesības, kuras vajadzīgas savienojumam. STRYK atslēgu parāda tikai vienreiz.

  2. 02

    Veidot pret atsauci

    Tavi izstrādātāji sāk ar ātro sākumu un koda piemēriem JavaScript vai Python valodā.

  3. 03

    Sākt ar lasīšanas piekļuvi

    Vispirms lasi, tad pārbaudi rakstošos izsaukumus ar saskaņotiem testa datiem.

  4. 04

    Savienot webhook

    Parakstīti notikumi uztur pieslēgto sistēmu atbilstībā STRYK stāvoklim.

Kas ar to strādā.

Izstrādātāji un aģentūras

Rezervāciju lapas, sinhronizācijas pakalpojumi un rīki tiek veidoti pret dokumentētu OpenAPI atsauci.

Vadība un administratori

Izsniedz atslēgas tikai ar vajadzīgajām tiesībām un atsauc tās, kad sadarbība beidzas.

Ieņēmumi un Housekeeping

Turpina strādāt ar ierasto rīku, kamēr cenas un numuru statuss tieši nonāk STRYK.

Biežākie jautājumi: API un integrācijas

Kur atrast tehnisko dokumentāciju?

STRYK izstrādātāju portālā adresē /developers: sākums, autentifikācija, tiesības, galapunkti, webhooks, kļūdas un pieprasījumu ierobežojums. Kases saskarnes OpenAPI atsauce tur pieejama YAML un JSON formātā.

Ko var Partner API?

Lasīt viesnīcas datus, kategorijas, vienības, tarifus, pieejamību un dienas cenas, aprēķināt piedāvājumus, lasīt, izveidot un atcelt rezervācijas, mainīt kontaktus un piezīmes. Turklāt lasīt viesus un mainīt viņu kontaktdatus, lasīt maksājumu statusu un izrakstītos rēķinus. Ar rakstīšanas tiesībām tā arī iestata vienību uzkopšanas statusu, pieejamības bloķējumus un dienas cenas un reģistrē saņemtos pārskaitījumus pret rēķiniem.

Kā iegūt atslēgu?

Viesnīcas administrators to izveido STRYK sadaļā Kanāli → API un izvēlas tiesības, piemēram, tikai pieejamības un tarifu lasīšanu. Katra atslēga pieder tieši vienai viesnīcai.

Cik maksā saskarņu izmantošana?

Dokumentācija izstrādātājiem ir bez maksas. Partner API viesnīca izmanto bez papildu moduļa STRYK pamatcenā. Kases pieslēgums ir daļa no papildu moduļa STRYK POS.

Kādi webhooks ir pieejami?

booking.created, booking.updated, booking.cancelled, guest.updated, availability.changed, rate.changed, payment.updated, unit.updated un webhook.test. Katrs nosūtījums tiek parakstīts ar HMAC un kļūdu gadījumā automātiski atkārtots.

Kā piekļuve ir nodrošināta?

Katra atslēga pieder tieši vienai viesnīcai, tai ir savas tiesības, derīguma termiņš un pēc vēlēšanās IP atļauto adrešu saraksts. Webhooks tiek parakstīti ar HMAC, pieprasījumi ir ierobežoti pēc apjoma, un viesnīca jebkurā brīdī var atsaukt atslēgu.

Rādīt vairāk jautājumu
Kā notiek maksājumi rezervācijām caur API?

Maksājumus savāc viesnīca caur STRYK Payments un tās iestatītajiem maksājumu veidiem; kartes dati paliek tur. Jaunas rezervācijas caur API sākas ar atvērtu atlikumu, ko viesnīca iekasē ar maksājuma saiti, tiešsaistē vai kartes terminālā. Maksājuma statusu tu nolasi caur API, un ar rakstīšanas tiesībām tā reģistrē saņemtos pārskaitījumus pret rēķinu.

Kuras kases atbilst STRYK?

Nē. Mēs nenosauksim nevienu kasi vai sistēmu par „sertificētu” un nevienu zīmolu par „atbalstītu”, kamēr nav pierādīts pabeigts savienojums. Jautā mums par statusu savai sistēmai.

Parādi mums, ko vēlies savienot.

Izmēģini STRYK 14 dienas ar savu viesnīcu vai pārrunā ar mums savu savienojumu demonstrācijā. Atsauce vienmēr ir pieejama izstrādātāju portālā.

Kontakts