Ενσωμάτωση Webhook

Τα Webhooks επιτρέπουν στα συστήματά σας να λαμβάνουν ειδοποιήσεις σε πραγματικό χρόνο όταν συμβαίνουν γεγονότα στον λογαριασμό σας στο Wink — νέες κρατήσεις, ακυρώσεις, ενημερώσεις πληρωμών και άλλα. Αυτός ο οδηγός σας καθοδηγεί στη ρύθμιση και τις βέλτιστες πρακτικές.

Κοινό

Αυτός ο οδηγός απευθύνεται σε προγραμματιστές που ενσωματώνουν το Wink με εξωτερικά συστήματα όπως συστήματα διαχείρισης ακινήτων (PMS), διαχειριστές καναλιών, CRM ή προσαρμοσμένους πίνακες ελέγχου.

Πώς λειτουργούν τα webhooks

1. Καταχωρείτε ένα URL webhook στο Wink.
2. Όταν συμβαίνει ένα γεγονός (π.χ. νέα κράτηση), το Wink στέλνει ένα HTTP POST στο URL σας.
3. Ο διακομιστής σας επεξεργάζεται το payload και απαντά με 200 OK.

Ρύθμιση webhook

1. Συνδεθείτε στον λογαριασμό σας (Extranet, Studio ή TripPay — όλα υποστηρίζουν webhooks).
2. Μεταβείτε στο Applications και μετά στο Webhooks. Δείτε Webhooks.
3. Κάντε κλικ στο Create webhook.
4. Εισάγετε ένα όνομα (π.χ. “PMS Booking Sync”).
5. Εισάγετε το URL webhook σας — το HTTPS endpoint στον διακομιστή σας.
6. Επιλέξτε γεγονότα — Επιλέξτε συγκεκριμένα γεγονότα για εγγραφή ή αφήστε κενό για να λαμβάνετε όλα τα γεγονότα.
7. Ενεργοποιήστε το Enabled.
8. Κάντε κλικ στο Save.

Τύποι γεγονότων

Το Wink υποστηρίζει 64+ τύπους γεγονότων webhook σε κατηγορίες όπως διαχείριση λογαριασμού, συμβόλαια κρατήσεων, πληρωμές, ενημερώσεις διαχειριστή καναλιών και διαχείριση οντοτήτων. Συνηθισμένα γεγονότα περιλαμβάνουν:

Κατηγορία	Παραδείγματα
Κράτηση	booking.create, booking.cancelled
Συμβόλαιο κράτησης	booking.contract.created, booking.contract.processing, booking.contract.cancelled
Πληρωμή	internal.payment.succeeded, internal.payment.failed
Επιστροφές	booking.contract.refund.partial, booking.contract.refund.full
Διαχειριστής καναλιών	channel-manager.update.rate, channel-manager.update.availability
Λογαριασμός	account.create, account.status.updated

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

Δείτε όλους τους 64+ τύπους γεγονότων

Συμβουλή

Ξεκινήστε εγγραφόμενοι σε όλα τα γεγονότα κατά την ανάπτυξη. Μόλις κατανοήσετε τα payloads, περιορίστε μόνο στα γεγονότα που χρειάζεται το σύστημά σας.

Βέλτιστες πρακτικές

• Χρησιμοποιήστε HTTPS — Το Wink στέλνει payloads μόνο σε HTTPS endpoints.
• Απαντήστε γρήγορα — Επιστρέψτε 200 OK μόλις λάβετε το payload. Κάντε τυχόν βαριά επεξεργασία ασύγχρονα.
• Αμεταβλητότητα (Idempotency) — Ο χειριστής σας πρέπει να είναι αμετάβλητος. Το Wink μπορεί να επαναλάβει την αποστολή αν δεν λάβει 200.
• Επαλήθευση πηγής — Επαληθεύστε ότι τα εισερχόμενα αιτήματα προέρχονται από το Wink πριν τα επεξεργαστείτε.
• Καταγραφή — Καταγράψτε κάθε payload webhook που λαμβάνετε. Αυτό διευκολύνει πολύ τον εντοπισμό σφαλμάτων στην ενσωμάτωση.

Παύση και διαγραφή

Μπορείτε να απενεργοποιήσετε ένα webhook χωρίς να το διαγράψετε. Αυτό παύει την παράδοση ώστε να μπορείτε να επιλύσετε προβλήματα χωρίς να χάσετε τη ρύθμιση. Όταν είστε έτοιμοι, ενεργοποιήστε το ξανά.

Η διαγραφή ενός webhook το αφαιρεί οριστικά. Οποιαδήποτε ενσωμάτωση βασίζεται σε αυτό το webhook θα σταματήσει να λαμβάνει ειδοποιήσεις.

Περισσότερη ανάγνωση

• Κατάλογος Γεγονότων Webhook — Πλήρης λίστα με όλους τους 64+ τύπους γεγονότων.
• Webhooks — Πλήρης αναφορά για τη διαχείριση webhooks.
• Applications — Διαχειριστείτε τα API credentials σας.
• Developers > APIs — Πλήρης τεκμηρίωση API.