Τεχνική τεκμηρίωση
Πώς συνδέετε το StayParity με τα δικά σας συστήματα. Υπογεγραμμένα webhook, το widget απευθείας κρατήσεων και το API ελέγχου τιμών για chatbot.
Το StayParity έχει τρία εργαλεία που μπορείτε να συνδέσετε με τα δικά σας συστήματα: webhook που ειδοποιούν τον διακομιστή σας όταν ένα OTA πουλάει φθηνότερα από ένα ξενοδοχείο, ένα widget που δείχνει στους πελάτες, στην ιστοσελίδα του ίδιου του ξενοδοχείου, ότι η απευθείας κράτηση συμφέρει, και το API ελέγχου τιμών, που δίνει σε ένα chatbot ή σε ένα δικό σας widget την ίδια απάντηση με το widget.
Webhooks
Το StayParity στέλνει κάθε νέα απόκλιση τιμής στο URL σας ως υπογεγραμμένο JSON: ένα κανάλι στα αποτελέσματα αναζήτησης ξενοδοχείων πουλάει το ίδιο δωμάτιο με το ξενοδοχείο, με αντιστοίχιση και των δύο σε έναν από τους τύπους δωματίων του ξενοδοχείου, φθηνότερα από την απευθείας τιμή του. Χρησιμοποιήστε το για να ανοίξετε ένα αίτημα υποστήριξης, να στείλετε μήνυμα στον υπεύθυνο εσόδων ή να τροφοδοτήσετε τις δικές σας αναφορές.
Οι παραδόσεις ακολουθούν το Standard Webhooks, οπότε μια έτοιμη βιβλιοθήκη τις επαληθεύει με λίγες γραμμές κώδικα. Η σελίδα Webhooks περιγράφει το συμβάν, τις υπογραφές, τις επαναλήψεις και τις δοκιμές.
Widget κρατήσεων
Μία ετικέτα <script> στη σελίδα κρατήσεων του ξενοδοχείου δείχνει στους πελάτες την απευθείας τιμή δίπλα σε όσα χρεώνουν τα OTA, όταν το ξενοδοχείο είναι φθηνότερο ή στην ίδια τιμή. Όταν ένα OTA είναι φθηνότερο, δείχνει μόνο την απευθείας τιμή. Ο κώδικας, οι επιλογές του και τι δείχνει είναι στη σελίδα Widget κρατήσεων, και το πώς μετράτε στο GA4 τις κρατήσεις που φέρνει στη σελίδα Μέτρηση του widget στο εργαλείο ανάλυσης.
API ελέγχου τιμών
Ένα GET με το κλειδί ενσωμάτωσης του ξενοδοχείου επιστρέφει σε JSON την απάντηση του widget για μία διανυκτέρευση: την απευθείας τιμή του ξενοδοχείου και, όταν είναι η χαμηλότερη ή ίδια, τις τιμές των OTA δίπλα της. Χρησιμοποιήστε το για να αναφέρετε την απευθείας τιμή σε ένα bot στο WhatsApp, σε έναν βοηθό συνομιλίας ή σε ένα δικό σας widget. Το αίτημα, οι απαντήσεις και ένα παράδειγμα bot είναι στη σελίδα API ελέγχου τιμών.
Κλειδιά διασύνδεσης
Τα webhook και το widget έχουν το καθένα δικό του κλειδί, και το API ελέγχου τιμών χρησιμοποιεί το κλειδί του widget. Λειτουργούν διαφορετικά:
| Κλειδί | Μορφή | Πού δημιουργείται | Είναι μυστικό; |
|---|---|---|---|
| Κλειδί υπογραφής | whsec_… | Ρυθμίσεις → Webhook, ένα ανά λογαριασμό | Ναι. Αποθηκεύστε το μόνο στον διακομιστή σας. |
| Κλειδί ενσωμάτωσης | wk_… | Ρυθμίσεις → Widget κρατήσεων, ένα ανά ξενοδοχείο, για το widget και το API ελέγχου τιμών | Όχι. Περιλαμβάνεται στον δημόσιο κώδικα HTML. |
Το κλειδί υπογραφής αποδεικνύει ότι ένα webhook ήρθε από το StayParity. Εμφανίζεται μία φορά, και μόνο οι διαχειριστές του λογαριασμού μπορούν να το δημιουργήσουν ή να το αντικαταστήσουν.
Το κλειδί ενσωμάτωσης χρησιμεύει μόνο για να εμφανίζεται το widget του ξενοδοχείου και να απαντά ο έλεγχος τιμών του, και κανένα από τα δύο δεν δείχνει κάτι παραπάνω από όσα βλέπει έτσι κι αλλιώς κάθε πελάτης. Οποιοσδήποτε μπορεί να το αντιγράψει από τον κώδικα της σελίδας. Αν αυτό σας απασχολεί, αντικαταστήστε τον κώδικα στην εφαρμογή, και το παλιό κλειδί σταματά να λειτουργεί. Το πρόγραμμα περιήγησης ενός πελάτη μπορεί να συνεχίσει να δείχνει ένα widget που φόρτωσε μέσα στα τελευταία πέντε λεπτά.
Δεν υπάρχει API για ανάγνωση ή αλλαγή των δεδομένων του λογαριασμού. Τα webhook στέλνουν στον διακομιστή σας, και το widget και το API ελέγχου τιμών διαβάζουν την ίδια δημόσια σύγκριση. Κανένα από αυτά δεν χρειάζεται API token.
Μορφές για εργαλεία και AI agents
- Η προδιαγραφή OpenAPI 3.1 περιγράφει το API ελέγχου τιμών στην ενότητα
pathsκαι το συμβάν webhook στην ενότηταwebhooks. - Αυτή η τεκμηρίωση ως απλό κείμενο για γλωσσικά μοντέλα: το llms.txt έχει τη λίστα των σελίδων, και το llms-full.txt όλες τις σελίδες, στα αγγλικά, σε ένα αρχείο.
- Κάθε σελίδα σε Markdown: προσθέστε
.mdστη διεύθυνσή της, όπως στο /el/developers/webhooks.md. Η επισκόπηση είναι στο /el/developers/index.md.