Ισοτιμία τιμών για booking engine και ομίλους ξενοδοχείων.
Συγκρίνουμε την απευθείας τιμή κάθε ξενοδοχείου με την Booking.com, την Expedia και τα κανάλια που παρακολουθεί στα αποτελέσματα αναζήτησης ξενοδοχείων, και βάζουμε μια απόκλιση στη λίστα του ξενοδοχείου μόλις συμφωνήσουν δύο έλεγχοι. Το υπογεγραμμένο webhook παρακάτω στέλνει κάθε νέα απόκλιση τιμής στο endpoint σας.
Content-Type: application/json
webhook-id: ns4k8w2q7c1m9x5t3h6v0b2r8d7f4j1g
webhook-timestamp: 1791549711
webhook-signature: v1,Xq0c…e21a=
{
"version": 4,
"id": "ns4k8w2q7c1m9x5t3h6v0b2r8d7f4j1g",
"event": "disparity.opened",
"disparityId": "jn7cq2b1x9d8w4fzr3m6kt5v0h7s2e8a",
"hotel": { "id": "kd72mbx0vy4p9s1c6tqh8wf3gr5n2j7e", "name": "Hotel Aurora" },
"ota": "booking",
"stayDate": "2026-10-16",
"occupancy": 2,
"currency": "EUR",
"directPriceMinor": 18800,
"otaPriceMinor": 17900,
"deltaMinor": 900,
"directPriceEurMinor": 18800, "otaPriceEurMinor": 17900, "deltaEurMinor": 900,
"deltaPct": 4.79,
"trust": "seen_twice",
"findingKind": "rate_disparity",
"evidence": { … },
"detectedAt": "2026-10-09T12:02:00.000Z"
}Ενδεικτικό. Το Hotel Aurora δεν υπάρχει.
Δεν δένεται με ένα booking engine.
Παίρνουμε την απευθείας τιμή κάθε ξενοδοχείου από τα αποτελέσματα αναζήτησης ξενοδοχείων, οπότε καλύπτουμε ήδη ξενοδοχεία με οποιοδήποτε booking engine.
Από τα αποτελέσματα αναζήτησης ξενοδοχείων
Χρησιμοποιούμε την τιμή που δείχνει η επίσημη ιστοσελίδα κάθε ξενοδοχείου στα αποτελέσματα αναζήτησης ξενοδοχείων (Google Hotels), για την ίδια διανυκτέρευση και τα ίδια άτομα με τα κανάλια.
Χωρίς εγκατάσταση
Καμία πρόσβαση στο booking engine, στο channel manager ή στο PMS, και τίποτα στην ιστοσελίδα του ξενοδοχείου. Η ομάδα μας ρυθμίζει κάθε ξενοδοχείο.
Οι ίδιοι έλεγχοι για κάθε ξενοδοχείο
Όποιο booking engine κι αν έχει ένα ξενοδοχείο, παίρνει τους ίδιους ελέγχους, τη δική του λίστα και τις ίδιες ειδοποιήσεις.
Ένα υπογεγραμμένο συμβάν όταν ανοίγει μια απόκλιση τιμής.
Στέλνεται ως JSON στο endpoint κάθε ξενοδοχείου, με έκδοση ήδη από το πρώτο πεδίο.
Τα πεδία
- version
- Σήμερα πάντα 4. Μπορεί να προστεθούν πεδία χωρίς αλλαγή έκδοσης, οπότε αγνοήστε όσα δεν αναγνωρίζετε.
- id
- Το id αυτής της παράδοσης. Κάθε επανάληψή της έχει το ίδιο, στο σώμα και στην κεφαλίδα webhook-id, οπότε χρησιμοποιήστε το για να παραλείπετε τα διπλότυπα.
- event
- Πάντα disparity.opened: μια νέα απόκλιση. Είναι το μόνο συμβάν.
- disparityId
- Το id της απόκλισης.
- hotel
- Το id και το όνομα του ξενοδοχείου στο StayParity.
- ota
- Το κανάλι, ως slug με πεζά: booking, expedia ή όποιο κανάλι έδειξαν τα αποτελέσματα αναζήτησης.
- stayDate
- Η διανυκτέρευση, σε μορφή YYYY-MM-DD.
- occupancy
- Ο αριθμός ατόμων.
- currency
- Το νόμισμα του ξενοδοχείου, ως κωδικός ISO 4217, π.χ. EUR ή RON. Τα τρία επόμενα πεδία είναι σε αυτό.
- directPriceMinor
- Η απευθείας τιμή του ξενοδοχείου, στη μικρότερη υποδιαίρεση του νομίσματός του.
- otaPriceMinor
- Η τιμή του καναλιού, στη μικρότερη υποδιαίρεση του νομίσματος του ξενοδοχείου.
- deltaMinor
- Πόσο λιγότερο χρεώνει το κανάλι, στη μικρότερη υποδιαίρεση του νομίσματος του ξενοδοχείου.
- directPriceEurMinor
- Η απευθείας τιμή του ξενοδοχείου, σε λεπτά του ευρώ.
- otaPriceEurMinor
- Η τιμή του καναλιού, σε λεπτά του ευρώ.
- deltaEurMinor
- Πόσο λιγότερο χρεώνει το κανάλι, σε λεπτά του ευρώ.
- deltaPct
- Η ίδια διαφορά ως ποσοστό της απευθείας τιμής, με δύο δεκαδικά.
- trust
- Πάντα seen_twice: δύο έλεγχοι των αποτελεσμάτων αναζήτησης ξενοδοχείων με απόσταση τουλάχιστον 30 λεπτών, με την ίδια βάση, βρήκαν τιμές που απέχουν έως 1% μεταξύ τους.
- reason
- now_over_threshold όταν μια απόκλιση ήδη ανοιχτή κάτω από τα όριά σας τα ξεπέρασε στο μεταξύ. Δεν υπάρχει σε νέα απόκλιση.
- findingKind
- Πάντα rate_disparity: το ίδιο δωμάτιο με τους ίδιους όρους, φθηνότερα στο κανάλι.
- evidence
- Ο πρώτος έλεγχος της απόκλισης και ο πιο πρόσφατος, ο καθένας με τις δύο προσφορές όπως τις διαβάσαμε: τιμή, πηγή, ώρα, δωμάτιο, διατροφή και όροι ακύρωσης.
- detectedAt
- Πότε εντοπίστηκε πρώτη φορά η απόκλιση, σε UTC.
Πώς γίνεται η παράδοση
- Ένα POST με Content-Type application/json, σε δημόσια διεύθυνση https
- Παραδίδεται μόλις το endpoint σας απαντήσει με 2xx μέσα σε 10 δευτερόλεπτα
- Μετά από 5xx ή λήξη χρόνου, η παράδοση επαναλαμβάνεται, με μεγαλύτερη αναμονή κάθε φορά
- Ένα 4xx θεωρείται άρνηση, και η παράδοση δεν επαναλαμβάνεται
- Οι ανακατευθύνσεις δεν ακολουθούνται, οπότε δώστε την τελική διεύθυνση
Ποιες αποκλίσεις στέλνονται
- Ο κανόνας ειδοποίησης κάθε ξενοδοχείου ορίζει την ελάχιστη διαφορά, στο νόμισμα του ξενοδοχείου και σε ποσοστό
- Αποκλίσεις από τα κανάλια που παρακολουθεί το ξενοδοχείο, για το ίδιο δωμάτιο με το ξενοδοχείο, με αντιστοίχιση και των δύο σε έναν από τους τύπους δωματίων του. Όσες δεν αναφέρουν δωμάτιο μένουν στη λίστα και στη σύνοψη με email
- Ένα συμβάν ανά απόκλιση, όταν ανοίγει, και όχι ξανά όσο παραμένει ανοιχτή
- Κάθε ξενοδοχείο μπορεί να στέλνει στο δικό του endpoint, ή πολλά ξενοδοχεία στο ίδιο
HMAC-SHA256 πάνω στο id, τη χρονική σήμανση και το αυτούσιο σώμα.
Ακολουθεί το Standard Webhooks, οπότε η επίσημη βιβλιοθήκη μπορεί να την ελέγξει στις περισσότερες γλώσσες.
webhook-id: <the payload's id>
webhook-timestamp: <unix seconds>
webhook-signature: v1,<base64 HMAC‑SHA256>- 1Διαβάστε τρεις κεφαλίδες: webhook-id, webhook-timestamp σε δευτερόλεπτα Unix και webhook-signature, που είναι v1, ένα κόμμα και μετά η υπογραφή σε base64.
- 2Υπολογίστε HMAC-SHA256 πάνω στο id, μια τελεία, τη χρονική σήμανση, μια τελεία και μετά το σώμα ακριβώς όπως έφτασε. Κλειδί είναι το κλειδί υπογραφής σας μετά το whsec_, αποκωδικοποιημένο από base64.
- 3Συγκρίνετε τις δύο υπογραφές σε σταθερό χρόνο και απορρίψτε μια χρονική σήμανση πολύ μακριά από την τρέχουσα ώρα, ώστε ένα αίτημα που υποκλάπηκε να μην μπορεί να σταλεί ξανά.
- 4Κάθε επανάληψη κρατά το webhook-id της και υπογράφεται από την αρχή, με δική της χρονική σήμανση.
Ένα κλειδί υπογραφής ανά λογαριασμό υπογράφει τις παραδόσεις όλων των ξενοδοχείων. Ένας διαχειριστής το δημιουργεί στην εφαρμογή και το βλέπει μία φορά· ένα νέο κλειδί αντικαθιστά το παλιό.
Επαλήθευση σε Node.js
import { createHmac, timingSafeEqual } from "node:crypto";
// Or let the official library do it: npm install standardwebhooks, then
// new Webhook(secret).verify(rawBody, headers) throws unless it checks out.
// rawBody: the request body exactly as it arrived, before JSON.parse.
// headers: the request headers, with Node's lower-case names.
// secret: your whole signing secret, whsec_ prefix included.
function verify(rawBody, headers, secret, toleranceSeconds = 300) {
const id = headers["webhook-id"];
const timestamp = Number(headers["webhook-timestamp"]);
if (!id || !Number.isInteger(timestamp)) return false;
if (Math.abs(Date.now() / 1000 - timestamp) > toleranceSeconds) return false;
const key = Buffer.from(secret.replace(/^whsec_/, ""), "base64");
const expected = createHmac("sha256", key).update(`${id}.${timestamp}.${rawBody}`).digest();
return String(headers["webhook-signature"] ?? "").split(" ").some((entry) => {
const [version, signature = ""] = entry.split(",", 2);
const given = Buffer.from(signature, "base64");
return version === "v1" && given.length === expected.length && timingSafeEqual(given, expected);
});
}Python, PHP, επαναλήψεις και δοκιμές στην τεκμηρίωση του webhook
Όλα τα ξενοδοχεία σε έναν λογαριασμό.
Για έναν ξενοδοχειακό όμιλο, ή για τα ξενοδοχεία που μας φέρνετε ως συνεργάτης.
Κάθε ξενοδοχείο, η δική του λίστα
Κάθε ξενοδοχείο έχει τις δικές του αποκλίσεις και τον δικό του κανόνα ειδοποίησης, και η εφαρμογή περνάει από το ένα στο άλλο.
Η ομάδα σας, με ρόλους
Οι διαχειριστές είναι υπεύθυνοι για την ομάδα και το κλειδί υπογραφής. Τα μέλη δουλεύουν τη λίστα και ρυθμίζουν τις ειδοποιήσεις.
Τη ρύθμιση την κάνουμε εμείς
Η ομάδα μας προσθέτει κάθε ξενοδοχείο, τον κανόνα ειδοποίησής του και την πρόσβαση της ομάδας σας. Τα ξενοδοχεία σας δεν εγκαθιστούν τίποτα.
Συστήστε τα ξενοδοχεία σας ή μεταπωλήστε το StayParity.
Πείτε μας πώς δουλεύετε με τα ξενοδοχεία και θα συμφωνήσουμε μαζί τους όρους.
Σύσταση
Μας συστήνετε τα ξενοδοχεία με τα οποία συνεργάζεστε. Εμείς τα ρυθμίζουμε και τα υποστηρίζουμε.
Μεταπώληση
Προσφέρετε το StayParity στα ξενοδοχεία σας, μαζί με όσα ήδη τους πουλάτε.
Τι ρωτούν πρώτα οι συνεργάτες.
Όχι. Χρησιμοποιούμε την τιμή που δείχνουν τα αποτελέσματα αναζήτησης ξενοδοχείων για την επίσημη ιστοσελίδα κάθε ξενοδοχείου, όποιο booking engine κι αν έχει.
Όχι ακόμη. Η απευθείας τιμή κάθε ξενοδοχείου είναι αυτή που δείχνουν τα αποτελέσματα αναζήτησης ξενοδοχείων για την επίσημη ιστοσελίδα του. Αν έχετε booking engine και θέλετε να διαβάζουμε τις τιμές των ξενοδοχείων σας κατευθείαν από αυτό, μιλήστε μας.
Από τη λίστα κάθε ξενοδοχείου και την ημερήσια ή εβδομαδιαία σύνοψή του με email, και το webhook στέλνει κάθε νέα απόκλιση τιμής στο endpoint σας μόλις ανοίξει. Αν χρειάζεστε κάτι που δεν περιέχει, πείτε μας.
Τίποτα, για τους ελέγχους και τις ειδοποιήσεις. Το widget απευθείας κρατήσεων είναι μία ετικέτα script στην ιστοσελίδα του ξενοδοχείου, και μόνο αν θέλει το widget.
Δώστε μας την ιστοσελίδα σας. Θα ελέγξουμε τις επόμενες 30 ημέρες.
Χωρίς κάρτα, χωρίς εγκατάσταση. Τις επόμενες 30 ημέρες, σε σύγκριση με την Booking.com, την Expedia και τα άλλα μεγάλα OTA.