İçeriğe geç

Hızlı Başlangıç

Bu rehber sizi yaklaşık 30 dakika içinde hiçbir şeyden çalışan bir entegrasyona götürür. Sonunda şunlara sahip olacaksınız:

  • Partner API’den bir şehirdeki oteller için canlı fiyatlar,
  • rezervasyonları hesabınıza kredi eden bir rezervasyon bağlantısı,
  • bir test rezervasyonu ve bunun gerçekleştiğini bildiren bir webhook.

Her şey staging ortamında, test ortamımızda gerçekleşir. Bizden erişim istemenize gerek yoktur ve daha sonra üretime geçiş için onay gerekmez.

Yapmak istiyorsunuz…Buradan başlayın
Uygulamanızda, sitenizde veya AI ürününüzde otelleri gösterip yolcuları rezervasyon yapmaya göndererek komisyon kazanmakBu rehber
Lisanslı bir seyahat acentesi olarak müşterileriniz adına rezervasyon yapmakBu rehberin 5. adıma kadar, sonra Seyahat acentesi olarak rezervasyon
Entegrasyon yazmadan rezervasyon yapılabilir otelleri gömmekWeb Bileşenleri
Bir AI ajanının arama yapıp rezervasyon yapmasını sağlamakMCP Sunucuları ve Agentic Payments
Bir kanal yöneticisi veya PMS bağlamakKanal Yöneticinizi Ekleyin

Otelleri ve canlı fiyatlarını bulmak için Partner API kullanırsınız. Her otelin sabit bir urlName değeri vardır. Bunu, kimlik bilgilerinizi taşıyan Wink Rezervasyon Motoru book.wink.travel bağlantısına dönüştürürsünüz. Yolcu orada rezervasyon yapar ve ödeme yapar, rezervasyon hesabınıza kredi edilir.

Şunlara ihtiyacınız olacak:

  • grpcurl veya Postman ya da Insomnia. Partner API gRPC kullanır, REST değil.
  • curl.

Staging, üretimden tamamen ayrı olup kendi girişleri ve hesapları vardır.

  1. staging-app.wink.travel adresine gidin, Sign-In / Registere tıklayın ve kayıt olun.

  2. Sol kenar çubuğunda Accountsa tıklayın, sonra Create ve I am an Affiliate seçeneğini seçin. Gönderdiğiniz rezervasyonlar bu hesaba kredi edilir. Bkz. Hesap Oluşturma.

Uygulama, kodunuza kimlik bilgilerini verir.

  1. Hesap kartınızda Actions > Manage accounta tıklayın, ardından Applications sekmesine geçin.

  2. Create new applicationa tıklayın, bir isim verin ve istemci türü olarak Machine-to-machine seçin.

  3. Kapsamlar altında Inventory & rates (okuma) seçin. Partner API inventory.read kontrol eder.

  4. Create applicationa tıklayın ve Client ID ile Client secreti kopyalayın. Secret sadece bir kez gösterilir, sonra alınamaz.

Diğer istemci türleri ve kapsamlar için Applications sayfasına bakın.

Terminal window
curl -X POST https://staging-iam.wink.travel/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=<YOUR_CLIENT_ID>" \
-d "client_secret=<YOUR_CLIENT_SECRET>" \
-d "scope=inventory.read"

Yanıttan access_token değerini kaydedin:

Terminal window
export WINK_TOKEN=<access_token>

Belirteçlerin süresi dolar. Kendi kodunuzda bir OAuth2 kütüphanesi kullanarak bunları alın ve yenileyin. Bkz. Kimlik Doğrulama.

Belirteç isteği reddedilirse, yanıt error kodu içeren JSON gövdesidir:

errorHTTP durumuYaygın neden
invalid_client401Yanlış client ID veya secret, ya da üretim kimlik bilgileri staging-iamde kullanıldı
invalid_scope400İstek, uygulamanın kayıtlı olmadığı bir kapsam istiyor
unauthorized_client400Uygulamanın client_credentials yetkisi yok
invalid_request400Gerekli bir parametre eksik, örneğin gövde JSON yerine form olmalı

Her Partner API çağrısı, işlem yaptığınız hesabı managing-entity-id başlığında belirtir. Token’ın işlem yapabileceği hesapları listeleyin:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-d '{}' \
staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

Adım 1’deki bağlı hesap accountId değerini kopyalayın:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Staging ortamında Bangkok’ta test otelleri vardır, bu yüzden arama slug’ı bangkok-thailand kullanılır:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-H "managing-entity-id: $WINK_ACCOUNT_ID" \
-d '{
"urlName": "bangkok-thailand",
"userSession": {
"itinerary": {
"startDate": "2026-12-01",
"nights": 2,
"room": { "adults": 2 }
},
"currencyCode": "USD",
"languageCode": "en"
}
}' \
staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCity

Giriş tarihi gelecekte olmalı; geçmiş tarih reddedilir. Her sonuçta şunlar bulunur:

  • name, starRating ve heroImageUrl, bir sonuç satırı göstermek için yeterli,
  • roomTypes, canlı teklifler, en ucuz oda ilk,
  • urlName, rezervasyon bağlantısı için gereken slug.

Fiyatlar küçük birimlerde tam sayıdır: yanıt içindeki currencyExponent değerinin (USD için 2) 10’un kuvvetiyle bölünür (örneğin 12500 = 125,00 $).

Bir şehrin slug’ını bilmiyor musunuz? wink.partner.v1.Lookup/Search ile çözebilirsiniz. Bir mülkün tam içeriği için Content servisini kullanın. Partner API referansı tüm çağrıları belgeler.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> Adım 5’teki otelin urlName değeridir.
  • client-id Adım 2’deki uygulamanızın Client ID’sidir.
  • configuration-id özelleştirme ID’nizdir: Manage account > Customizations. Bir özelleştirme, rezervasyon sayfasında markanızı, varsayılan dili ve para birimini de ayarlar.

Yolcunun tarihlerini, misafir sayısını, dili ve para birimini aynı bağlantıya ekleyin, böylece otel sayfası bunlarla dolu açılır:

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD
ParametreAnlamıÖrnek
sdGiriş tarihisd=2027-03-14
n veya edGece sayısı veya çıkış tarihin=2 veya ed=2027-03-16
rcOda başına misafir sayısırc=a2 (2 yetişkin)
lGörüntüleme dilil=en
cGörüntüleme para birimic=USD
pPromosyon kodup=ABC123

Bu parametreler, özelleştirmenizde ayarlanmış varsayılanları geçersiz kılar. Şimdi Rezervasyon Butonu rehberi tam rc formatını, çocuklar ve birden fazla oda dahil, açıklar.

Bağlantı otel sayfasını açar; oda veya fiyat önceden seçilemez. Yolcu otel sayfasında canlı fiyatla oda seçer.

Tek bir otele değil, rezervasyon motoru ana sayfasına bağlantı için Doğrudan Bağlantı bölümüne bakın.

Bağlantınızı açın, tarih ve oda seçin, ve bir Stripe test kartı ile ödeme yapın; örneğin 4242 4242 4242 4242 herhangi bir gelecekteki son kullanma tarihi ve CVC ile. Staging ortamında gerçek karttan ücret alınmaz. Onay sayfasındaki rezervasyon kodunu not edin; WNK ile başlar.

  1. Portal’da Applications > Webhooksa gidin ve POST isteklerini kabul eden bir uç nokta ekleyin.

  2. booking.create olayına abone olun veya geliştirme sırasında her şeyi almak için olay listesini boş bırakın.

  3. Kendinize test olayı gönderin, sonra başka bir test rezervasyonu yapın ve gelmesini izleyin.

Her teslimatın imzasını doğrulamadan güvenmeyin. Bkz. Webhook Entegrasyonu ve Webhook Olayları Kataloğu.

Geliştiriciler için onay adımı yoktur. (Seyahat acentesi hesapları önce sertifikalandırılır; bkz. aşağı.) Entegrasyonunuz staging’de çalıştığında:

  1. app.wink.travel adresinde bir hesap ve uygulama oluşturun, Adım 1 ve 2’deki gibi. Kimlik bilgileri ortamlar arasında taşınmaz.

  2. Her hosttan staging- kısmını çıkarın:

    StagingÜretim
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel
  3. Üretim hesap ID’nizi (Adım 4) ve özelleştirme ID’nizi (Adım 6) tekrar bulun. Bunlar staging’den farklıdır.

Partner API kullanımı otel-gece bazında ölçülür ve aylık ücretsiz kontenjan vardır. Fiyatlandırma ve limitler için Partner API sayfasına bakın.

Hesabınız lisanslı bir seyahat acentesiyse, yolcuları book.wink.travele göndermenize gerek yoktur: doğrudan wink.partner.v1.Booking/CreateBooking ile rezervasyon oluşturabilir ve diğer Booking çağrılarıyla yönetebilirsiniz. Diğer hesaplar yolcuları rezervasyon bağlantısına gönderir.

Seyahat acentesi hesapları sertifikalandırılır: Wink her acentenin kaydını rezervasyon yapmadan önce inceler. Müşterilerinden ödeme tahsil etmek isteyen acenteler, kayıtlı satıcı olarak, Partner API üzerinden rezervasyon yapmalı ve Wink’in yazılı onayını almalıdır. Bkz. Seyahat Acentesi Olarak Başlarken ve Partner API referansı.