Kalo te përmbajtja
Partner API me portalin e zhvilluesve

Sistemet e tua lexojnë dhe shkruajnë direkt në STRYK.

Një faqe e veçantë rezervimi, një mjet për të ardhurat ose aplikacioni Housekeeping i agjencisë sate: Partner API i lidh me rezervimet, çmimet, disponueshmërinë dhe statusin e dhomave të hotelit tënd. Ti vendos çfarë mund të bëjë secili çelës API. Dokumentacionin, udhëzuesit dhe shembujt e kodit i publikojmë hapur në portalin e zhvilluesve, që zhvilluesit e tu të nisen pa vonesë.

Referenca, të drejtat dhe webhook-et e Partner API: Te portali i zhvilluesve

Lexim dhe shkrim

Rezervime, çmime ditore, disponueshmëri, statusi i pastrimit dhe transferime bankare.

Webhook-e të nënshkruara

STRYK njofton për ndryshimet te rezervimet, mysafirët, çmimet, pagesat dhe dhomat.

Çelësa me scope-e

Çdo çelës i përket një hoteli, me të drejta, skadim dhe listë IP të lejuara.

Dokumentacion i hapur

Quickstart, udhëzuesit dhe referenca OpenAPI në gjermanisht dhe anglisht.

Lexo dhe rezervo

Një faqe rezervimi që llogarit me çmimet reale të hotelit tënd.

Partner API ofron hotelin, kategoritë e dhomave, njësitë, disponueshmërinë dhe çmimet ditore. Për çdo kërkesë STRYK llogarit një ofertë sipas të njëjtave rregulla si Booking Engine, me taksën turistike dhe shërbimet shtesë të detyrueshme. Rezervimin e krijon me Idempotency-Key, dhe nëse dëshiron, STRYK i dërgon mysafirit emailin e zakonshëm të konfirmimit.

  • Oferta me çmim të llogaritur në server
  • Krijo, ndrysho dhe anulo rezervimet
  • Lexo mysafirët, statusin e pagesës dhe faturat e lëshuara
  • Anulimi sipas kushteve të hotelit
Çmimet dhe disponueshmëria

Mjeti yt për menaxhimin e të ardhurave vendos çmimet ditore direkt në kalendarin e tarifave.

Me rates:write një mjet shkruan çmimet ditore sipas kategorisë së dhomës, deri në 366 ditë për çdo thirrje. Çmimet minimale dhe maksimale të kategorive të tua vazhdojnë të zbatohen, dhe një çmim bosh e kthen ditën te rregullat e tua të çmimeve. Me availability:write mjeti krijon mbylljet, allotment-et dhe kufizimet për mbërritje e largim, fshin në mënyrë të synuar vetëm hyrjet e veta, ndërsa bllokimet e ekipit tënd mbeten në dorën tënde.

  • rates:write për çmimet ditore sipas kategorisë
  • availability:write për bllokimet dhe allotment-et
  • Kufijtë e kategorisë mbeten në fuqi
  • Çdo ndryshim çmimi regjistrohet me identifikuesin e çelësit
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.
Dhomat dhe pagesat

Statusi i dhomave nga aplikacioni Housekeeping, transferimet bankare nga kontabiliteti.

Me property:write një aplikacion e vendos statusin e pastrimit të një njësie, për shembull nga i papastër në i kontrolluar. If-Match mbron nga gjendjet e vjetruara, ndërsa okupimi, bllokimet dhe të dhënat kryesore mbeten në STRYK. Me payments:write një sistem regjistron një transferim bankar të pranuar mbi një faturë të lëshuar, deri në shumën e hapur.

  • Statusi i pastrimit me kontroll versioni
  • Transferim bankar për faturën e lëshuar
  • Faturat mbeten dokumente në STRYK
  • Thirrjet e përsëritura mbrohen me idempotencë
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.
Çelësat dhe webhook-et

Ti vendos kush ka qasje. STRYK të njofton për ndryshimet.

Një administrator krijon një çelës API te Kanalet → API, me qasje sipas fushës, datë skadimi dhe, nëse dëshiron, listë IP të lejuara. Kur rrotullon çelësin, i vjetri vlen edhe 24 orë ose skadon menjëherë. STRYK nënshkruan webhook-et si booking.created, rate.changed ose unit.updated me HMAC-SHA256, i ripërsërit kur ka gabime dhe i regjistron në regjistrin e dërgimit.

  • E drejta e shkrimit përfshin të drejtën e leximit
  • Si parazgjedhje 120 kërkesa në minutë
  • Regjistri i dërgimit me „Dërgo përsëri“
  • Çelësat mund të tërhiqen në çdo kohë
Teknika e shtëpisë

Brava, telefoni, TV dhe WiFi punojnë me STRYK.

Përveç Partner API-t, STRYK e lidh teknikën e shtëpisë tënde. Check-in, ndërrimi i dhomës dhe check-out veprojnë mbi çelësat, central telefonik, televizorin e hotelit dhe qasjen në WiFi, pa që recepsioni të shkruajë dy herë.

Nga ideja te një lidhje që punon.

Kështu punon me zhvilluesit e tu.

  1. 01

    Krijo çelësin

    Administratori zgjedh vetëm qasjet që i duhen lidhjes. STRYK e shfaq çelësin vetëm një herë.

  2. 02

    Ndërto sipas referencës

    Zhvilluesit e tu nisen me Quickstart dhe shembuj kodi në JavaScript ose Python.

  3. 03

    Fillo me qasje leximi

    Fillimisht lexo, pastaj kontrollo thirrjet e shkrimit me të dhëna testi të përafruara.

  4. 04

    Lidh webhook-et

    Ngjarjet e nënshkruara e mbajnë sistemin e lidhur të përditësuar me STRYK.

Kush punon me të.

Zhvilluesit dhe agjencitë

Ndërtojnë faqe rezervimi, shërbime sinkronizimi dhe mjete mbi një referencë OpenAPI të dokumentuar.

Menaxhmenti dhe administratori

Jep çelësa vetëm me të drejtat e nevojshme dhe tërhiqi ato kur një bashkëpunim përfundon.

Të ardhurat dhe Housekeeping

Punojnë më tej me mjetin e zakonshëm, ndërsa çmimet dhe statusi i dhomave arrijnë direkt në STRYK.

Pyetjet e shpeshta: API dhe integrimet

Ku e gjej dokumentacionin teknik?

Në portalin e zhvilluesve të STRYK nën /developers: fillimi, autentikimi, autorizimet, pikat e fundit, webhook-et, gabimet dhe kufizimi i kërkesave. Referenca OpenAPI e ndërfaqes së arkës gjendet atje si YAML dhe JSON.

Çfarë mund të bëjë Partner API?

Lexon hotelin, kategoritë, njësitë, tarifat, disponueshmërinë dhe çmimet ditore, llogarit oferta, lexon, krijon dhe anulon rezervime dhe ndryshon kontaktin dhe shënimet. Lexon edhe mysafirët dhe ndryshon të dhënat e tyre të kontaktit, lexon statusin e pagesës dhe faturat e lëshuara. Me të drejta shkrimi cakton gjithashtu statusin e pastrimit të njësive, bllokimet e disponueshmërisë dhe çmimet ditore, dhe regjistron transferimet bankare të pranuara te faturat.

Si marr një çelës?

Një administrator i hotelit e krijon në STRYK te Kanalet → API dhe zgjedh autorizimet, për shembull vetëm leximin e disponueshmërisë dhe tarifave. Çdo çelës i përket saktësisht një hoteli.

Sa kushton përdorimi i ndërfaqeve?

Dokumentacioni është falas për zhvilluesit. Hoteli e përdor Partner API pa modul shtesë, brenda çmimit bazë të STRYK. Lidhja e arkave është pjesë e modulit shtesë STRYK POS.

Cilat webhook-e ekzistojnë?

booking.created, booking.updated, booking.cancelled, guest.updated, availability.changed, rate.changed, payment.updated, unit.updated dhe webhook.test. Çdo dërgesë nënshkruhet me HMAC dhe riprovohet automatikisht në rast gabimi.

Si mbrohet qasja?

Çdo çelës i përket saktësisht një hoteli, ka autorizimet e veta, një datë skadimi dhe, sipas dëshirës, një listë IP të lejuara. Webhook-et nënshkruhen me HMAC, kërkesat kufizohen në sasi, dhe hoteli mund ta revokojë një çelës në çdo kohë.

Shfaq më shumë pyetje
Si funksionojnë pagesat për rezervimet përmes API?

Pagesat i mbledh hoteli përmes STRYK Payments dhe rrugëve të tij të konfiguruara të pagesës; të dhënat e kartës mbeten edhe atje. Rezervimet e reja përmes API fillojnë me një saldo të hapur, që hoteli e mbledh me lidhje pagese, online ose në terminalin e kartave. Statusin e pagesës e lexon nëpërmjet API, dhe me të drejtë shkrimi ajo regjistron transferimet bankare të pranuara te një faturë.

Cilat arka i përshtaten STRYK?

Jo. Nuk e quajmë asnjë kanal „certifikuar“ dhe asnjë markë „e mbështetur“ derisa një lidhje e plotë të jetë provuar. Na pyet për statusin e sistemit tënd.

Na trego çfarë dëshiron të lidhësh.

Provo STRYK 14 ditë me hotelin tënd, ose fol me ne në një demo për lidhjen tënde. Dokumentacioni është gjithmonë në portalin e zhvilluesve.

Kontakti