Ενσωμάτωση 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 υποστηρίζει διάφορους τύπους γεγονότων. Συνηθισμένα γεγονότα περιλαμβάνουν:

• Δημιουργία κράτησης — Μια νέα κράτηση έχει επιβεβαιωθεί.
• Ακύρωση κράτησης — Μια κράτηση έχει ακυρωθεί.
• Ολοκλήρωση πληρωμής — Η πληρωμή έχει επεξεργαστεί.
• Ενημέρωση κράτησης — Έχουν αλλάξει λεπτομέρειες της κράτησης.

Συμβουλή

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

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

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

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

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

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

Επιπλέον ανάγνωση

• Webhooks — Πλήρης αναφορά για τη διαχείριση webhooks.
• Applications — Διαχείριση των API credentials σας.
• Developers > APIs — Πλήρης τεκμηρίωση API.