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.
Bu rehber sizin için uygun mu?
Bölüm başlığı “Bu rehber sizin için uygun mu?”| Yapmak istiyorsunuz… | Buradan başlayın |
|---|---|
| Uygulamanızda, sitenizde veya AI ürününüzde otelleri gösterip yolcuları rezervasyon yapmaya göndererek komisyon kazanmak | Bu rehber |
| Lisanslı bir seyahat acentesi olarak müşterileriniz adına rezervasyon yapmak | Bu rehberin 5. adıma kadar, sonra Seyahat acentesi olarak rezervasyon |
| Entegrasyon yazmadan rezervasyon yapılabilir otelleri gömmek | Web Bileşenleri |
| Bir AI ajanının arama yapıp rezervasyon yapmasını sağlamak | MCP Sunucuları ve Agentic Payments |
| Bir kanal yöneticisi veya PMS bağlamak | Kanal Yöneticinizi Ekleyin |
Nasıl çalışır
Bölüm başlığı “Nasıl çalışır”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.
Başlamadan önce
Bölüm başlığı “Başlamadan önce”Şunlara ihtiyacınız olacak:
grpcurlveya Postman ya da Insomnia. Partner API gRPC kullanır, REST değil.curl.
Adım 1: Bir staging hesabı oluşturun
Bölüm başlığı “Adım 1: Bir staging hesabı oluşturun”Staging, üretimden tamamen ayrı olup kendi girişleri ve hesapları vardır.
-
staging-app.wink.travel adresine gidin,
Sign-In / Registere tıklayın ve kayıt olun. -
Sol kenar çubuğunda
Accountsa tıklayın, sonraCreateve I am an Affiliate seçeneğini seçin. Gönderdiğiniz rezervasyonlar bu hesaba kredi edilir. Bkz. Hesap Oluşturma.
Adım 2: Bir uygulama oluşturun
Bölüm başlığı “Adım 2: Bir uygulama oluşturun”Uygulama, kodunuza kimlik bilgilerini verir.
-
Hesap kartınızda
Actions>Manage accounta tıklayın, ardındanApplicationssekmesine geçin. -
Create new applicationa tıklayın, bir isim verin ve istemci türü olarak Machine-to-machine seçin. -
Kapsamlar altında Inventory & rates (okuma) seçin. Partner API
inventory.readkontrol eder. -
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.
Adım 3: Bir erişim belirteci alın
Bölüm başlığı “Adım 3: Bir erişim belirteci alın”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:
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:
error | HTTP durumu | Yaygın neden |
|---|---|---|
invalid_client | 401 | Yanlış client ID veya secret, ya da üretim kimlik bilgileri staging-iamde kullanıldı |
invalid_scope | 400 | İstek, uygulamanın kayıtlı olmadığı bir kapsam istiyor |
unauthorized_client | 400 | Uygulamanın client_credentials yetkisi yok |
invalid_request | 400 | Gerekli bir parametre eksik, örneğin gövde JSON yerine form olmalı |
Adım 4: Hesap ID’nizi bulun
Bölüm başlığı “Adım 4: Hesap ID’nizi bulun”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:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsAdım 1’deki bağlı hesap accountId değerini kopyalayın:
export WINK_ACCOUNT_ID=<accountId>Adım 5: Bir şehirde otel arayın
Bölüm başlığı “Adım 5: Bir şehirde otel arayın”Staging ortamında Bangkok’ta test otelleri vardır, bu yüzden arama slug’ı bangkok-thailand kullanılır:
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/SearchByCityGiriş tarihi gelecekte olmalı; geçmiş tarih reddedilir. Her sonuçta şunlar bulunur:
name,starRatingveheroImageUrl, 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.
Adım 6: Rezervasyon bağlantısını oluşturun
Bölüm başlığı “Adım 6: Rezervasyon bağlantısını oluşturun”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>Adım 5’teki otelinurlNamedeğeridir.client-idAdı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 aramasını iletin
Bölüm başlığı “Yolcunun aramasını iletin”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| Parametre | Anlamı | Örnek |
|---|---|---|
sd | Giriş tarihi | sd=2027-03-14 |
n veya ed | Gece sayısı veya çıkış tarihi | n=2 veya ed=2027-03-16 |
rc | Oda başına misafir sayısı | rc=a2 (2 yetişkin) |
l | Görüntüleme dili | l=en |
c | Görüntüleme para birimi | c=USD |
p | Promosyon kodu | p=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.
Adım 7: Test rezervasyonu yapın
Bölüm başlığı “Adım 7: Test rezervasyonu yapı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.
Adım 8: Rezervasyon bildirimleri alın
Bölüm başlığı “Adım 8: Rezervasyon bildirimleri alın”-
Portal’da
Applications > Webhooksa gidin vePOSTisteklerini kabul eden bir uç nokta ekleyin. -
booking.createolayına abone olun veya geliştirme sırasında her şeyi almak için olay listesini boş bırakın. -
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.
Adım 9: Üretime geçin
Bölüm başlığı “Adım 9: Üretime geçin”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:
-
app.wink.travel adresinde bir hesap ve uygulama oluşturun, Adım 1 ve 2’deki gibi. Kimlik bilgileri ortamlar arasında taşınmaz.
-
Her hosttan
staging-kısmını çıkarın:Staging Üretim https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
Ü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.
Seyahat acentesi olarak rezervasyon
Bölüm başlığı “Seyahat acentesi olarak rezervasyon”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ı.
Sonraki adımlar
Bölüm başlığı “Sonraki adımlar”grpcurlelle çağırmak yerine.protoşemasından tipli bir istemci oluşturun.- MCP sunucusunu bağlayın ve AI Yetenekleri ile kodlama asistanınızın canlı API’ye karşı entegrasyonu yazmasını sağlayın.
- Tüm ortamlar ve hostlar listesini okuyun.
