İçeriğe geç
Wink

Webhook Entegrasyonu

Webhook’lar, Wink hesabınızda gerçekleşen olaylar — yeni rezervasyonlar, iptaller, ödeme güncellemeleri ve daha fazlası — için sistemlerinizin gerçek zamanlı bildirim almasını sağlar. Bu rehber, kurulum ve en iyi uygulamalar konusunda sizi yönlendirir.

Hedef Kitle

Section titled “Hedef Kitle”

Bu rehber, Wink’i mülk yönetim sistemleri (PMS), kanal yöneticileri, CRM’ler veya özel panolar gibi harici sistemlerle entegre eden geliştiriciler içindir.

Webhook’lar nasıl çalışır

Section titled “Webhook’lar nasıl çalışır”
  1. Wink üzerinde bir webhook URL’si kaydedersiniz.
  2. Bir olay gerçekleştiğinde (örneğin, yeni bir rezervasyon), Wink URL’nize bir HTTP POST gönderir.
  3. Sunucunuz yükü işler ve 200 OK ile yanıt verir.

Webhook kurulumu

Section titled “Webhook kurulumu”
  1. Hesabınıza giriş yapın (Extranet, Studio veya TripPay — hepsi webhook desteği sunar).
  2. Applications bölümüne, ardından Webhooks sekmesine gidin. Bkz. Webhooks.
  3. Create webhook butonuna tıklayın.
  4. Bir isim girin (örneğin, “PMS Rezervasyon Senkronizasyonu”).
  5. Webhook URL’nizi girin — sunucunuzdaki HTTPS uç noktası.
  6. Olayları seçin — Abone olmak istediğiniz belirli olayları seçin veya tüm olayları almak için boş bırakın.
  7. Enabled seçeneğini açın.
  8. Save butonuna tıklayın.

Olay türleri

Section titled “Olay türleri”

Wink, hesap yönetimi, rezervasyon sözleşmeleri, ödemeler, kanal yöneticisi güncellemeleri ve yönetim varlıkları dahil olmak üzere kategorilerde 64+ webhook olay türü destekler. Yaygın olaylar şunlardır:

KategoriÖrnekler
Rezervasyonbooking.create, booking.cancelled
Rezervasyon sözleşmesibooking.contract.created, booking.contract.processing, booking.contract.cancelled
Ödemeinternal.payment.succeeded, internal.payment.failed
İadelerbooking.contract.refund.partial, booking.contract.refund.full
Kanal yöneticisichannel-manager.update.rate, channel-manager.update.availability
Hesapaccount.create, account.status.updated

Her olay türünün açıklamalarıyla tam listesi için Webhook Olayları Kataloğuna bakın.

Tüm 64+ olay türünü görüntüle

En iyi uygulamalar

Section titled “En iyi uygulamalar”
  • HTTPS kullanın — Wink, yükleri yalnızca HTTPS uç noktalarına gönderir.
  • Hızlı yanıt verin — Yükü aldığınızda hemen 200 OK döndürün. Ağır işlemleri asenkron yapın.
  • İdempotentlik — İşleyiciniz idempotent olmalıdır. Wink, 200 yanıtı alamazsa teslimatı yeniden deneyebilir.
  • Kaynağı doğrulayın — İşlem yapmadan önce gelen isteklerin Wink’ten geldiğini doğrulayın.
  • Kayıt tutma — Aldığınız her webhook yükünü kaydedin. Bu, entegrasyon sorunlarını çözmeyi kolaylaştırır.

Duraklatma ve silme

Section titled “Duraklatma ve silme”

Bir webhook’u silmeden devre dışı bırakabilirsiniz. Bu, teslimatı duraklatır ve yapılandırmanızı kaybetmeden sorun gidermenize olanak tanır. Hazır olduğunuzda tekrar açabilirsiniz.

Webhook’u silmek, onu kalıcı olarak kaldırır. Bu webhook’a bağlı herhangi bir entegrasyon bildirim almaya devam edemez.

Daha fazla okuma

Section titled “Daha fazla okuma”