Μετάβαση στο περιεχόμενο
Partner API με πύλη προγραμματιστών

Τα συστήματά σου διαβάζουν και γράφουν απευθείας στη STRYK.

Μια δική σου σελίδα κρατήσεων, ένα εργαλείο revenue ή η εφαρμογή Housekeeping της εταιρείας σου: το Partner API τα συνδέει με τις κρατήσεις, τις τιμές, τη διαθεσιμότητα και την κατάσταση δωματίων του ξενοδοχείου σου. Αποφασίζεις τι επιτρέπεται να κάνει κάθε κλειδί API. Την τεκμηρίωση, τους οδηγούς και τα παραδείγματα κώδικα τα δημοσιεύουμε ανοιχτά στην πύλη προγραμματιστών, ώστε οι προγραμματιστές σου να ξεκινούν χωρίς καθυστέρηση.

Τεκμηρίωση, δικαιώματα και webhooks του Partner API: Στο portal προγραμματιστών

Ανάγνωση και εγγραφή

Κρατήσεις, ημερήσιες τιμές, διαθεσιμότητα, κατάσταση καθαρισμού και τραπεζικές μεταφορές.

Υπογεγραμμένα webhooks

Η STRYK αναφέρει αλλαγές σε κρατήσεις, επισκέπτες, τιμές, πληρωμές και δωμάτια.

Κλειδιά με scopes

Κάθε κλειδί ανήκει σε ένα ξενοδοχείο, με δικαιώματα, λήξη και λίστα επιτρεπόμενων IP.

Ανοιχτή τεκμηρίωση

Quickstart, οδηγοί και αναφορά OpenAPI στα γερμανικά και στα αγγλικά.

Ανάγνωση και κράτηση

Μια σελίδα κρατήσεων που υπολογίζει με τις πραγματικές τιμές του ξενοδοχείου σου.

Το Partner API παρέχει το ξενοδοχείο, τις κατηγορίες δωματίων, τις μονάδες, τη διαθεσιμότητα και τις ημερήσιες τιμές. Για κάθε αίτημα η STRYK υπολογίζει προσφορά με τους ίδιους κανόνες όπως η Booking Engine, με τέλος διαμονής και υποχρεωτικά extras. Την κράτηση τη δημιουργείς με Idempotency-Key, και αν θέλεις, η STRYK στέλνει στον επισκέπτη το συνηθισμένο email επιβεβαίωσης.

  • Προσφορά με τιμή που υπολογίζεται στον διακομιστή
  • Δημιουργία, αλλαγή και ακύρωση κρατήσεων
  • Ανάγνωση επισκεπτών, κατάστασης πληρωμών και εκδοθέντων τιμολογίων
  • Ακύρωση σύμφωνα με τους όρους του ξενοδοχείου
Τιμές και διαθεσιμότητα

Το εργαλείο revenue σου ορίζει τις ημερήσιες τιμές απευθείας στο ημερολόγιο τιμών.

Με το rates:write ένα εργαλείο γράφει ημερήσιες τιμές ανά κατηγορία δωματίου, έως 366 ημέρες ανά κλήση. Τα ελάχιστα και τα μέγιστα όρια τιμής των κατηγοριών σου ισχύουν κανονικά, και μια κενή τιμή επαναφέρει την ημέρα στους κανόνες τιμολόγησής σου. Με το availability:write δημιουργεί κλεισίματα, Allotment και περιορισμούς άφιξης και αναχώρησης, και διαγράφει μόνο τις δικές του εγγραφές, ενώ οι αποκλεισμοί της ομάδας σου μένουν στα χέρια σου.

  • rates:write για ημερήσιες τιμές ανά κατηγορία δωματίου
  • availability:write για κλεισίματα και Allotment
  • Τα όρια κατηγοριών παραμένουν σε ισχύ
  • Κάθε αλλαγή τιμής καταγράφεται με την ένδειξη του κλειδιού
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.
Δωμάτια και πληρωμές

Κατάσταση δωματίων από την εφαρμογή Housekeeping, τραπεζικές μεταφορές από τη λογιστική.

Με το property:write μια εφαρμογή ορίζει την κατάσταση καθαρισμού μιας μονάδας, π.χ. από «βρώμικο» σε «ελεγμένο». Το If-Match προστατεύει από παλιές καταστάσεις, ενώ η πληρότητα, οι αποκλεισμοί και τα βασικά δεδομένα μένουν στη STRYK. Με το payments:write ένα σύστημα καταχωρίζει μια εισερχόμενη τραπεζική μεταφορά σε εκδοθέν τιμολόγιο, το πολύ μέχρι το ανοιχτό ποσό.

  • Κατάσταση καθαρισμού με έλεγχο έκδοσης
  • Τραπεζική μεταφορά σε εκδοθέν τιμολόγιο
  • Τα τιμολόγια παραμένουν παραστατικά στη STRYK
  • Επαναλαμβανόμενες κλήσεις προστατεύονται με idempotency
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.
Κλειδιά και webhooks

Εσύ αποφασίζεις ποιος έχει πρόσβαση. Η STRYK σε ενημερώνει για ό,τι αλλάζει.

Ένας διαχειριστής δημιουργεί κλειδί API στο Κανάλια → API, με δικαιώματα ανά περιοχή, ημερομηνία λήξης και, αν θέλει, λίστα επιτρεπόμενων IP. Όταν αλλάζει κλειδί, το παλιό ισχύει για 24 ακόμη ώρες ή λήγει αμέσως. Τα webhooks όπως booking.created, rate.changed ή unit.updated τα υπογράφει η STRYK με HMAC-SHA256, τα επαναλαμβάνει σε περίπτωση σφάλματος και τα καταγράφει στο αρχείο αποστολής.

  • Το δικαίωμα εγγραφής περιλαμβάνει το δικαίωμα ανάγνωσης
  • Κατά προεπιλογή 120 αιτήματα ανά λεπτό
  • Αρχείο αποστολής με «Αποστολή ξανά»
  • Τα κλειδιά ανακαλούνται οποτεδήποτε
Τεχνική υποδομή

Κλειδαριά, τηλέφωνο, TV και Wi-Fi δουλεύουν με το STRYK.

Εκτός από το Partner API, το STRYK συνδέει την τεχνική υποδομή του ξενοδοχείου σου. Check-in, αλλαγή δωματίου και check-out επηρεάζουν κλειδιά, τηλεφωνικό κέντρο, τηλεόραση και πρόσβαση στο Wi-Fi, χωρίς η ρεσεψιόν να πληκτρολογεί τίποτα δύο φορές.

Από την ιδέα μέχρι τη λειτουργούσα σύνδεση.

Έτσι προχωράς μαζί με τους προγραμματιστές σου.

  1. 01

    Δημιουργία κλειδιού

    Ο διαχειριστής επιλέγει μόνο τα scopes που χρειάζεται η σύνδεση. Η STRYK εμφανίζει το κλειδί μία φορά.

  2. 02

    Ανάπτυξη με βάση την αναφορά

    Οι προγραμματιστές σου ξεκινούν με το Quickstart και τα παραδείγματα κώδικα σε JavaScript ή Python.

  3. 03

    Ξεκίνα με δικαίωμα ανάγνωσης

    Πρώτα ανάγνωση, μετά έλεγχος των εγγραφών με δεδομένα δοκιμής που έχετε συμφωνήσει με το ξενοδοχείο.

  4. 04

    Σύνδεση webhooks

    Τα υπογεγραμμένα γεγονότα κρατούν το συνδεδεμένο σύστημα ενημερωμένο με τη STRYK.

Ποιοι δουλεύουν με αυτήν.

Προγραμματιστές και εταιρείες

Χτίζουν σελίδες κρατήσεων, υπηρεσίες συγχρονισμού και εργαλεία πάνω σε τεκμηριωμένη αναφορά OpenAPI.

Διεύθυνση και διαχειριστές

Δίνουν κλειδιά μόνο με τα δικαιώματα που χρειάζονται και τα ανακαλούν όταν τελειώσει η συνεργασία.

Revenue και Housekeeping

Δουλεύουν με το εργαλείο που συνηθίζουν, ενώ οι τιμές και η κατάσταση δωματίων φτάνουν κατευθείαν στη STRYK.

Συχνές ερωτήσεις: API και ενσωματώσεις

Πού βρίσκω την τεχνική τεκμηρίωση;

Στην πύλη προγραμματιστών του STRYK στο /developers: εισαγωγή, πιστοποίηση, δικαιώματα, endpoints, webhooks, σφάλματα και όρια αιτημάτων. Η αναφορά OpenAPI της διασύνδεσης ταμείου είναι διαθέσιμη εκεί σε YAML και JSON.

Τι μπορεί να κάνει η Partner API;

Η Partner API διαβάζει ξενοδοχείο, κατηγορίες, μονάδες, τιμές, διαθεσιμότητα και ημερήσιες τιμές, υπολογίζει προσφορές, διαβάζει, δημιουργεί και ακυρώνει κρατήσεις και αλλάζει στοιχεία επικοινωνίας και σημειώσεις. Διαβάζει επίσης επισκέπτες και αλλάζει τα στοιχεία τους, καθώς και την κατάσταση πληρωμών και τα εκδοθέντα τιμολόγια. Με δικαιώματα εγγραφής ορίζει επιπλέον την κατάσταση καθαρισμού μονάδων, περιορισμούς διαθεσιμότητας και ημερήσιες τιμές, και καταχωρεί εισερχόμενες τραπεζικές μεταφορές σε τιμολόγια.

Πώς παίρνω ένα κλειδί;

Ένας διαχειριστής του ξενοδοχείου το δημιουργεί στο STRYK κάτω από Κανάλια → API και επιλέγει τα δικαιώματα, για παράδειγμα μόνο ανάγνωση διαθεσιμότητας και τιμών. Κάθε κλειδί ανήκει σε ακριβώς ένα ξενοδοχείο.

Πόσο κοστίζει η χρήση των διασυνδέσεων;

Η τεκμηρίωση είναι δωρεάν για προγραμματιστές. Το ξενοδοχείο χρησιμοποιεί την Partner API χωρίς πρόσθετο module, μέσα στη βασική τιμή του STRYK. Η σύνδεση ταμείων αποτελεί μέρος του πρόσθετου module STRYK POS.

Ποια webhooks υπάρχουν;

booking.created, booking.updated, booking.cancelled, guest.updated, availability.changed, rate.changed, payment.updated, unit.updated και webhook.test. Κάθε αποστολή υπογράφεται με HMAC και επαναλαμβάνεται αυτόματα σε περίπτωση σφάλματος.

Πώς είναι ασφαλισμένη η πρόσβαση;

Κάθε κλειδί ανήκει σε ακριβώς ένα ξενοδοχείο, έχει δικά του δικαιώματα, ημερομηνία λήξης και κατ' επιλογή λίστα επιτρεπόμενων IP. Τα webhooks υπογράφονται με HMAC, τα αιτήματα έχουν όριο ρυθμού και το ξενοδοχείο μπορεί να ανακαλέσει ένα κλειδί οποτεδήποτε.

Εμφάνισε περισσότερες ερωτήσεις
Πώς γίνονται πληρωμές για κρατήσεις μέσω API;

Τις πληρωμές εισπράττει το ξενοδοχείο μέσω STRYK Payments και των ρυθμισμένων τρόπων πληρωμής του, και εκεί παραμένουν και τα στοιχεία καρτών. Νέες κρατήσεις μέσω API ξεκινούν με ανοιχτό υπόλοιπο, το οποίο το ξενοδοχείο συγκεντρώνει μέσω συνδέσμου πληρωμής, online ή στο τερματικό καρτών. Την κατάσταση πληρωμής τη διαβάζεις μέσω API, και με δικαίωμα εγγραφής καταχωρεί εισερχόμενες τραπεζικές μεταφορές σε ένα τιμολόγιο.

Ποια ταμεία ταιριάζουν στο STRYK;

Όχι. Δεν χαρακτηρίζουμε κανένα σύστημα «πιστοποιημένο» ή κάποια μάρκα «υποστηριζόμενη» πριν αποδειχθεί ολοκληρωμένη σύνδεση. Ρώτα μας για την κατάσταση του δικού σου συστήματος.

Πες μας τι θέλεις να συνδέσεις.

Δοκίμασε τη STRYK 14 ημέρες με το δικό σου ξενοδοχείο ή μίλησέ μας σε μια επίδειξη για τη σύνδεσή σου. Η τεκμηρίωση είναι πάντα διαθέσιμη στην πύλη προγραμματιστών.

Επικοινωνία