Τεκμηρίωση για developers
Πώς συνδέετε το StayParity με τα δικά σας συστήματα. Υπογεγραμμένα webhook για κάθε νέα απόκλιση και το σήμα απευθείας κράτησης για το site.
Το StayParity σας δίνει δύο σημεία για να χτίσετε. Τα webhook ειδοποιούν τον server σας όταν μια OTA πουλά φθηνότερα από ένα ξενοδοχείο. Το σήμα δείχνει στους επισκέπτες, στο site του ίδιου του ξενοδοχείου, ότι τους συμφέρει να κλείσουν απευθείας.
Webhook
Όταν ένας έλεγχος δείξει ότι μια OTA πουλά ένα δωμάτιο φθηνότερα από την απευθείας τιμή του ξενοδοχείου, το StayParity στέλνει την απόκλιση στο URL σας, ως υπογεγραμμένο JSON. Με αυτό ανοίγετε ένα ticket, στέλνετε μήνυμα σε έναν revenue manager ή τροφοδοτείτε τις δικές σας αναφορές.
Οι αποστολές ακολουθούν το Standard Webhooks, οπότε μια έτοιμη βιβλιοθήκη τις επαληθεύει σε λίγες γραμμές. Το συμβάν, τις υπογραφές, τις επαναλήψεις και τις δοκιμές θα τα βρείτε στη σελίδα Webhook.
Σήμα για το site
Ένα tag <script> στη σελίδα κρατήσεων του ξενοδοχείου δείχνει στους επισκέπτες την απευθείας τιμή δίπλα σε όσα χρεώνουν οι OTA, όταν το ξενοδοχείο έχει τη χαμηλότερη ή την ίδια τιμή. Όταν μια OTA είναι φθηνότερη, δείχνει μόνο την τιμή του ίδιου του ξενοδοχείου. Το snippet, τις επιλογές του και τι δείχνει θα τα βρείτε στη σελίδα Σήμα για το site.
Κλειδιά
Κάθε λειτουργία έχει το δικό της κλειδί, και τα δύο κλειδιά δουλεύουν διαφορετικά:
| Κλειδί | Μορφή | Πού | Μυστικό; |
|---|---|---|---|
| Κλειδί υπογραφής (signing key) | whsec_… | Settings → Webhooks, ένα ανά λογαριασμό | Ναι. Κρατήστε το στον server σας. |
| Κλειδί ενσωμάτωσης (embed key) | wk_… | Settings → Website badge, ένα ανά ξενοδοχείο | Όχι. Βρίσκεται στο δημόσιο HTML του ξενοδοχείου. |
Το κλειδί υπογραφής αποδεικνύει ότι ένα webhook ήρθε από το StayParity. Εμφανίζεται μόνο μία φορά, και μόνο οι διαχειριστές του λογαριασμού μπορούν να το δημιουργήσουν ή να το αντικαταστήσουν.
Το κλειδί ενσωμάτωσης επιτρέπει σε μια σελίδα μόνο να δείχνει το σήμα του συγκεκριμένου ξενοδοχείου. Αυτό δείχνει ό,τι θα έβλεπε ούτως ή άλλως κάθε επισκέπτης. Οποιοσδήποτε μπορεί να αντιγράψει το κλειδί από τον κώδικα της σελίδας. Αν αυτό σας απασχολεί, αντικαταστήστε το snippet στο portal και το παλιό κλειδί σταματά να δουλεύει.
Δημόσιο API για να διαβάζετε ή να αλλάζετε δεδομένα του λογαριασμού δεν υπάρχει ακόμη. Τα webhooks στέλνουν δεδομένα στον server σας, ενώ το σήμα ζητά τη δημόσια σύγκριση τιμών που εμφανίζει. Καμία λειτουργία δεν χρειάζεται API token.
Για εργαλεία και agents
- Η προδιαγραφή του webhook σε OpenAPI 3.1, με το συμβάν κάτω από το
webhooks. - Η τεκμηρίωση σε απλό κείμενο για γλωσσικά μοντέλα: το llms.txt απαριθμεί τις σελίδες και το llms-full.txt τις έχει όλες σε ένα αρχείο.
- Κάθε σελίδα και σε Markdown: προσθέστε
.mdστη διεύθυνσή της, όπως στο /el/developers/webhooks.md. Η επισκόπηση είναι στο /el/developers/index.md.