Pređi na sadržaj
Partner API sa portalom za programere

Tvoji sistemi čitaju i pišu direktno u STRYK.

Tvoja sopstvena stranica za rezervacije, alat za upravljanje prihodom ili housekeeping aplikacija tvoje agencije: Partner API ih povezuje sa rezervacijama, cenama, raspoloživošću i statusom soba tvog hotela. Ti određuješ šta koji API ključ sme. Referencu, vodiče i primere koda objavljujemo otvoreno u portalu za programere, da tvoji programeri krenu bez zaobilaznih koraka.

Referenca, dozvole i webhook-ovi partner API-ja: Idi na portal za programere

Čitanje i pisanje

Rezervacije, dnevne cene, raspoloživost, status čišćenja i uplate.

Potpisani webhook-ovi

STRYK javlja promene rezervacija, gostiju, cena, plaćanja i soba.

Ključevi sa scopes

Svaki ključ pripada jednom hotelu, sa pravima, rokom važenja i IP allowlistom.

Otvorena dokumentacija

Quickstart, vodiči i OpenAPI referenca na nemačkom i engleskom.

Čitanje i rezervisanje

Stranica za rezervacije koja računa sa stvarnim cenama tvog hotela.

Partner API obezbeđuje hotel, kategorije soba, jedinice, raspoloživost i dnevne cene. Za svaki upit STRYK računa ponudu prema istim pravilima kao Booking Engine, uključujući boravišnu taksu i obavezne dodatne usluge. Rezervaciju kreiraš uz Idempotency-Key, a ako želiš, STRYK gostu šalje uobičajenu potvrdnu e-poruku.

  • Ponuda sa cenom izračunatom na serveru
  • Kreiranje, izmena i storniranje rezervacija
  • Čitanje podataka o gostima, statusu plaćanja i izdatim fakturama
  • Storno prema uslovima hotela
Cene i raspoloživost

Tvoj alat za upravljanje prihodima postavlja dnevne cene direktno u kalendaru cena.

Uz rates:write alat upisuje dnevne cene po kategoriji sobe, do 366 dana po pozivu. Minimalne i maksimalne cene tvojih kategorija i dalje važe, a prazna cena vraća taj dan na tvoja pravila za cene. Uz availability:write alat kreira zatvaranja, allotment kapacitete i ograničenja dolaska i odlaska, i može da briše samo sopstvene unose, dok zatvaranja tvog tima ostaju pod tvojom kontrolom.

  • rates:write za dnevne cene po kategoriji
  • availability:write za zatvaranja i allotment
  • Ograničenja kategorija ostaju na snazi
  • Svaka promena cene beleži se sa oznakom ključa
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.
Sobe i plaćanja

Status sobe iz housekeeping aplikacije, uplate iz knjigovodstva.

Uz property:write aplikacija postavlja status čišćenja jedinice, na primer sa prljavo na pregledano. If-Match štiti od zastarelih stanja, zauzetost, zatvaranja i matični podaci ostaju u STRYK. Uz payments:write sistem knjiži primljenu uplatu na izdatu fakturu, najviše do iznosa koji je još otvoren.

  • Status čišćenja uz proveru verzije
  • Uplata na izdatu fakturu
  • Fakture ostaju knjigovodstveni dokumenti u STRYK
  • Ponovljeni pozivi su zaštićeni idempotentnošću
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.
Ključevi i webhook-ovi

Ti odlučuješ ko pristupa. STRYK javlja šta se menja.

Admin pod Kanali → API kreira API ključ, sa scopes po oblasti, datumom isteka i po želji IP allowlistom. Pri rotaciji stari ključ važi još 24 sata ili prestaje odmah. STRYK potpisuje webhook-ove kao što su booking.created, rate.changed ili unit.updated uz HMAC-SHA256, ponavlja ih pri greškama i beleži ih u protokolu isporuke.

  • Pravo pisanja obuhvata pravo čitanja
  • Podrazumevano 120 zahteva po minuti
  • Protokol isporuke sa „Pošalji ponovo“
  • Ključevi se mogu opozvati u bilo kom trenutku
Tehnika objekta

Brave, telefon, TV i WLAN rade sa STRYK.

Pored Partner API, STRYK povezuje tehniku tvog objekta. Prijava, promena sobe i odjava utiču na ključeve, telefonsku centralu, hotel TV i pristup WLAN-u, bez da recepcija išta unosi dvaput.

Od ideje do funkcionalne integracije.

Kako radiš zajedno sa programerima

  1. 01

    Kreiraj ključ

    Admin bira tačno one scopes koje povezivanje traži. STRYK ključ prikazuje jednom.

  2. 02

    Gradi uz referencu

    Tvoji programeri počinju sa quickstartom i primerima koda u JavaScriptu ili Pythonu.

  3. 03

    Počni sa pravom čitanja

    Prvo čitanje, pa proveri pozive za pisanje uz dogovorene testne podatke.

  4. 04

    Poveži webhook-ove

    Potpisani događaji drže povezani sistem u skladu sa STRYK.

Ko s time radi.

Programeri i agencije

Grade stranice za rezervacije, sync servise i alate uz dokumentovanu OpenAPI referencu.

Vodstvo i admin

Dodeljuj ključeve sa tačno potrebnim pravima i opozovi ih kada saradnja prestane.

Revenue i housekeeping

Nastavljaju da rade u alatu koji već koriste, dok cene i status soba stižu direktno u STRYK.

Česta pitanja: API i integracije

Gde nalazim tehničku dokumentaciju?

Na STRYK portalu za programere na adresi /developers: uvod, autentifikacija, dozvole, krajnje tačke, webhook-ovi, greške i ograničenje broja zahteva. OpenAPI referenca interfejsa kase tamo je dostupna kao YAML i JSON.

Šta Partner API može?

Čitanje hotela, kategorija, jedinica, tarifa, raspoloživosti i dnevnih cena, računanje ponuda, čitanje, kreiranje i otkazivanje rezervacija, kao i menjanje kontakta i beleški. Takođe čitanje gostiju i izmena njihovih kontakt podataka, čitanje statusa plaćanja i izdatih faktura. Uz prava za pisanje, API još postavlja status čišćenja jedinica, blokade raspoloživosti i dnevne cene i evidentira pristigle uplate za fakture.

Kako dobijam ključ?

Administrator hotela ga kreira u STRYK pod Kanali → API i bira dozvole, na primer samo čitanje raspoloživosti i tarifa. Svaki ključ pripada tačno jednom hotelu.

Koliko košta korišćenje interfejsa?

Dokumentacija je za programere besplatna. Partner API hotel koristi bez dodatnog modula, u okviru osnovne STRYK cene. Povezivanje kasa je deo dodatnog modula STRYK POS.

Koji webhook-ovi postoje?

booking.created, booking.updated, booking.cancelled, guest.updated, availability.changed, rate.changed, payment.updated, unit.updated i webhook.test. Svaka isporuka je potpisana HMAC-om i pri greškama se automatski ponavlja.

Kako je pristup obezbeđen?

Svaki ključ pripada tačno jednom hotelu, ima sopstvene dozvole, rok važenja i, po želji, IP listu dozvoljenih adresa. Webhook-ovi su potpisani HMAC-om, zahtevi su ograničeni po broju, a hotel može ključ da opozove u svakom trenutku.

Prikaži još pitanja
Kako teku plaćanja kod rezervacija preko API-ja?

Naplatu hotel vrši preko STRYK Payments i podešenih načina plaćanja; podaci o karticama ostaju tamo. Nove rezervacije preko API-ja počinju sa otvorenim saldom koji hotel naplaćuje preko linka za plaćanje, online ili na terminalu za kartice. Status plaćanja čitaš preko API-ja, a uz pravo upisa on evidentira pristigle uplate za fakturu.

Koje kase odgovaraju STRYK-u?

Ne. Nijedan kanal ne nazivamo „sertifikovanim“, niti neki brend „podržanim“, dok se ne dokaže da je povezivanje završeno. Pitaj nas za status za tvoj sistem.

Pokaži nam šta želiš da povežeš.

Isprobaj STRYK 14 dana u svom hotelu ili u demo prezentaciji razgovaraj s nama o svom povezivanju. Referenca je uvek dostupna u portalu za programere.

Kontakt