Partner API

Wink Partner API, entegre edenlerin rezervasyon yapılabilir seyahat envanterini sorgulaması için kimlik doğrulamalı, yüksek verimli bir yoldur — gömülebilir widget’larımızı ve genel tarama uç noktalarını besleyen aynı tedarik, birinci sınıf programatik arayüz olarak sunulur. Ücretsiz Web Bileşenleri ve genel tarama uç noktaları hafif, insan odaklı gömme için tasarlanmışken, Partner API ölçekli arama, fiyatlandırma ve rezervasyon yapan sistemler için oluşturulmuştur. Erişim entegre eden başına kimlik doğrulanır ve kullanım bazında faturalandırılır, böylece yalnızca gerçekten gönderdiğiniz trafik için ödeme yaparsınız.

Planlar ve fiyatlandırma

Kullanım otel-geceleri cinsinden ölçülür: bir otelin bir gece konaklaması için fiyatlandırılması — bir API çağrısı değil. 3 gecelik konaklama için 20 otel döndüren bir arama, tek bir istekte 60 otel-gecesidir. İçerik ve Arama (varış yeri araması ve otomatik tamamlama) çağrıları istisnadır: her biri çağrı başına bir birim maliyetlidir, ne döndürürse döndürsün. Hesap uç noktaları ücretsizdir. Fiyatlandırma oran için kesin kaynaktır.

	Ücretsiz	Ücretli	Kurumsal
Fiyat	$0	Kullanıma göre	İletişime geçin
En uygun	Değerlendirme ve düşük hacimli entegrasyonlar	Ölçekli kullanım bazlı ödeme	Özel hacim ve müzakere edilmiş koşullar
Aylık birimler	10.000	Sınırsız	Sınırsız
API yanıt süresi (P95)	—	500 ms altında	500 ms altında
Birim başı fiyat (otel-gece)	Ücretsiz	$0.0001	Özel
Aylık kota yanıtı	429, bir sonraki ayın 1’ine kadar (UTC)	Faturalandırılır, engellenmez	Anlaşmaya bağlı
Hizmet Düzeyi Anlaşması	—	✓	✓
Öncelikli destek	—	✓	✓
Özel onboarding	—	—	✓

Bir API anahtarı alın · Kullanım bazlı faturalandırmaya başlayın · Satış ile iletişime geçin

API referansı

Rezervasyon yapılabilir envanteri sunan iki yüzey vardır ve bunlar yukarıdaki iki katmana karşılık gelir:

• Ücretsiz — Tüketici / Rezervasyon Motoru API’si (REST, /api/public/**): anonim, tarayıcı ve widget odaklı. Rezervasyon Motoru referansına göz atın →
• Ücretli — Partner Entegratör API’si (gRPC, wink.partner.v1): kimlik doğrulamalı, kullanım bazlı, ölçekli sunucu-sunucu entegrasyonu için tasarlanmış. Entegratör referansına göz atın →

Partner Entegratör API’si gRPC’dir, REST değildir. HTTP/2 üzerinden oluşturulmuş bir istemci ile partner.wink.travel:443 adresine çağrı yaparsınız, bir bearer token ve çağrı yaptığınız hesabı ileterek:

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

Yukarıdaki referans sayfası her hizmeti, mesajı ve hata durumunu belgeler ve şema çalışma zamanında sunucu yansıması yoluyla da erişilebilir, böylece grpcurl, Postman ve Insomnia herhangi bir indirme olmadan keşfeder.

İsterseniz önceden bir istemci oluşturmak için .proto kaynak dosyaları github.com/wink-travel/partner-api-proto adresinde yayımlanmıştır.

Kullanım ve sınırlar nasıl çalışır

Ücretsiz katman

Ücretsiz katman, maliyetsiz olarak mütevazı üretim trafiği oluşturmanıza, test etmenize ve çalıştırmanıza olanak tanır.

• Yayınlanmış dakikalık limit yoktur. Wink istek oranlarını izler ve hizmeti korumak için adil kullanım sınırları uygulayabilir. HTTP 429 (Çok Fazla İstek) alırsanız, yeniden denemeden önce Retry-After başlığındaki saniye sayısı kadar bekleyin.
• Aylık kota — takvim ayı başına 10.000 birim. Kota hesap başına verilir ve her ayın 1’inde (UTC) sıfırlanır. Kotasına ulaşan ve kullanım bazlı faturalandırmaya kayıtlı olmayan hesaplar bir sonraki ayın 1’ine kadar HTTP 429 alır — sert durdurma, Retry-After başlığı ve Ücretli katmana abone olmanız için bir mesaj içerir. Kayıtlı hesaplar çalışmaya devam eder ve kota aşımı için faturalandırılır.

Ücretsiz katman Hizmet Düzeyi Anlaşması veya öncelikli destek içermez.

Ücretli katman

Ücretli katman aylık sınırı kaldırır ve yalnızca kullandığınız kadar faturalandırır.

• Ölçülen otel-geceleri — otel-gece başına $0.0001. Aylık üst sınır yoktur; gerçek hacim üzerinden faturalandırılırsınız. Wink yine de hizmeti korumak için adil kullanım sınırları uygulayabilir. Arama ve envanter çağrıları fiyatlandırılan otel-gece başına faturalandırılır; İçerik ve Arama çağrıları her biri bir birim olarak faturalandırılır, bu nedenle isteklerinizi toplu yapmak faturayı düşürür.

Ücretli katman aşağıda açıklanan Hizmet Düzeyi Anlaşmasını — %99,9 çalışma süresi taahhüdü ve 500 ms altında P95 yanıt süresi hedefi — ve öncelikli, önem derecesine göre destek içerir.

Hizmet Düzeyi Anlaşması

Yürürlük tarihi: 5 Temmuz 2026 · Sürüm 1.0

Bu Hizmet Düzeyi Anlaşması (“SLA”), Wink’in (“Wink”, “biz”) kimlik doğrulamalı Wink Partner API’si (“Partner API” veya “Hizmet”) için belirttiği katmanlarda müşteriye (“Müşteri”, “siz”) sağladığı kullanılabilirlik taahhüdünü, hizmet kredilerini ve destek hedeflerini belirler. Bu SLA, Partner API’ye eriştiğiniz Wink ile aranızdaki anlaşmaya (“Anlaşma”) dahil edilmiştir ve geçerlidir; aktif, ücretli ve iyi durumda bir Partner API aboneliğiniz olduğu sürece geçerlidir. Burada tanımlanmayan büyük harfli terimler Anlaşmada verilen anlamları taşır.

1. Tanımlar

1. “Çalışma Süresi”, Partner API’nin düzgün biçimlendirilmiş, kimlik doğrulanmış istekleri kabul edip başarıyla yanıtladığı dönemlerdir.
2. “Kesinti Süresi”, Partner API’nin düzgün biçimlendirilmiş, kimlik doğrulanmış isteklere başarıyla yanıt veremediği, dakikalar cinsinden ölçülen herhangi bir süredir; Bölüm 4’te belirtilen Hariç Tutmalar kapsamındaki süreler hariçtir. İzole hatalar, önemsiz istek kesimlerini etkilese bile tek başına Kesinti Süresi sayılmaz.
3. “Aylık Çalışma Süresi Yüzdesi”, belirli bir takvim ayı için, o ayın toplam dakikalarından toplam Kesinti Süresi dakikalarının çıkarılmasıyla bulunan değerin, o ayın toplam dakikalarına bölünmesiyle elde edilen yüzde değeridir.
4. “Planlı Bakım”, Wink’in Bölüm 4’e uygun olarak önceden bildirimde bulunduğu Hizmetin planlı bakımını ifade eder.
5. “Hizmet Kredisi”, Partner API için o ay ödediğiniz veya ödemeniz gereken ücretlerin yüzdesi olarak hesaplanan ve çalışma süresi taahhüdünün karşılanmaması durumunda gelecekteki Partner API ücretlerine mahsup edilen kredi anlamına gelir.
6. “Yanıt Süresi”, Wink’in hizmet sınırında düzgün biçimlendirilmiş, kimlik doğrulanmış isteği alması ile yanıt vermeye başlaması arasındaki geçen süredir; ağ geçişi ve Wink’in kontrolü dışındaki istemci tarafı süreleri hariçtir.

2. Kullanılabilirlik ve Performans Taahhüdü

Wink, her takvim ayı boyunca Partner API’nin Aylık Çalışma Süresi Yüzdesi en az %99,9 olacak şekilde kullanılabilirliğini sağlamak için ticari makul çabayı gösterecektir (“Çalışma Süresi Taahhüdü”). Bu taahhüt Wink’in hizmet sınırında ölçülür ve Bölüm 4’te belirtilen makul kontrolü dışındaki faktörleri içermez. Wink’in izleme sistemleri Aylık Çalışma Süresi Yüzdesi ve Yanıt Süresi ölçümleri için yetkili kayıt kaynağıdır.

Wink ayrıca her takvim ayı boyunca düzgün biçimlendirilmiş, kimlik doğrulanmış başarılı istekler için Wink’in hizmet sınırında ölçülen %95’lik dilim (P95) Yanıt Süresi hedefini 500 milisaniyenin altında tutmayı hedefler (“Performans Hedefi”). Performans Hedefi, Bölüm 4’te belirtilen faktörleri, isteğin kendisinden kaynaklanan uygulama düzeyindeki hataları ve olağandışı büyük veya karmaşık toplu istekleri hariç tutar. Performans Hedefi bir hizmet hedefidir; Bölüm 3’teki Hizmet Kredileri yalnızca Çalışma Süresi Taahhüdü karşılanmadığında uygulanır ve kullanılabilirlik eksiklikleri için tek ve münhasır çaredir.

3. Hizmet Kredileri

Aylık Çalışma Süresi Yüzdesi herhangi bir takvim ayında Çalışma Süresi Taahhüdünün altına düşerse, o ay için ödediğiniz veya ödemeniz gereken Partner API ücretlerinin yüzdesi olarak hesaplanan Hizmet Kredisi almaya hak kazanabilirsiniz:

Aylık Çalışma Süresi Yüzdesi	Hizmet Kredisi
%99,9’un altında ama %99,0 ve üzerinde	%10
%99,0’ın altında ama %95,0 ve üzerinde	%25
%95,0’ın altında	%50

1. Kredi talebi. Hizmet Kredisi almak için, kesinti yaşanan takvim ayının bitiminden itibaren otuz (30) gün içinde Wink’e yazılı talepte bulunmalısınız. Talep, talep ettiğiniz her Kesinti olayı için tarih ve saatleri ve makul şekilde erişilebilir destekleyici günlükler veya kanıtları içermelidir. Bu süre sonrasında yapılan talepler uygun değildir.
2. Kredi şekli. Onaylanan Hizmet Kredileri gelecekteki Partner API ücretlerine mahsup edilir ve nakit değeri yoktur. İade değildir ve geçerli yasa gerektirmedikçe ödenmez.
3. Maksimum kredi. Herhangi bir takvim ayı için verilen toplam Hizmet Kredileri, o ay için ödediğiniz veya ödemeniz gereken Partner API ücretlerinin %50’sini aşamaz.
4. Tek ve münhasır çare. Hizmet Kredileri, Wink’in Çalışma Süresi Taahhüdünü karşılamaması veya Partner API’nin herhangi bir kullanılabilirlik eksikliği için sizin tek ve münhasır çarenizdir.

4. Hariç Tutmalar

Çalışma Süresi Taahhüdü ve buna bağlı Hizmet Kredileri, aşağıdaki nedenlerden kaynaklanan veya bunlarla ilgili herhangi bir kullanılabilirlik, askıya alma, bozulma veya performans sorunlarına uygulanmaz ve Kesinti Süresi bunları içermez:

1. Wink’in önceden bildirimde bulunduğu Planlı Bakım, bu bildirim makul bir süre öncesinden ve Wink’in müşterilerle iletişim için normalde kullandığı kanallardan yapılmışsa;
2. Doğal afetler, devlet eylemleri, ağ veya hizmet kesintileri, hizmet engelleme veya diğer kötü niyetli saldırılar gibi Wink’in makul kontrolü dışındaki mücbir sebepler veya diğer nedenler;
3. Sizin eylemleriniz veya ihmalleriniz, ekipmanınız, yazılımınız veya ağınız ya da Wink’in doğrudan kontrolü altında olmayan herhangi bir üçüncü taraf hizmet, ürün veya sağlayıcıdan kaynaklanan sorunlar;
4. Hizmeti kötüye kullanmanız veya Anlaşma, bu SLA, kabul edilebilir kullanım koşulları veya geçerli oran sınırlarını ihlal etmeniz, Wink’in makul şekilde aşırı, otomatik kötüye kullanım veya dolandırıcılık olarak belirlediği trafik dahil;
5. Anlaşma kapsamında uygun şekilde gerçekleştirilen erişim askıya alma veya sonlandırmaları, ödeme yapılmaması nedeniyle askıya alma dahil.

5. Destek ve Yanıt Hedefleri

Wink, Partner API için yerel resmi tatiller hariç standart çalışma saatlerinde destek sağlar. Wink, önem derecesine göre ve makul şekilde onayladığı destek taleplerini aşağıdaki hedef yanıt süreleri içinde ilk olarak kabul etmeye ticari makul çaba gösterecektir:

Önem Derecesi	Açıklama	Hedef ilk yanıt süresi
Sev 1 — Kritik	Partner API üretimde kullanılamıyor veya çalışmıyor, çözüm yok.	4 saat
Sev 2 — Önemli	Önemli özellik bozulmuş veya zayıflamış; geçici çözüm var.	1 iş günü
Sev 3 — Önemsiz	Genel sorular, küçük sorunlar veya özellik talepleri.	2 iş günü

Hedef yanıt süreleri Wink’in ilk iletişimi kurmayı amaçladığı zamanları belirtir; çözüm süresi garantisi değildir. Öncelikli destek ve önem derecesine göre hedefler, dahil olduğu belirtilen katmanlarda geçerlidir.

6. Veri ve Güvenlik

Wink, Partner API üzerinden işlenen verilerin gizliliğini, bütünlüğünü ve kullanılabilirliğini korumak için ticari makul idari, teknik ve organizasyonel önlemler uygular ve bunları periyodik olarak gözden geçirir. Wink’in kişisel veri işleme uygulamaları Gizlilik Politikası ve Anlaşmadaki veri işleme koşulları ile yönetilir. API kimlik bilgilerinizi güvence altına almak, elde ettiğiniz verileri yasal olarak kullanmak ve olası kimlik bilgisi ihlallerini derhal Wink’e bildirmek sizin sorumluluğunuzdadır.

7. Sorumluluğun Sınırlandırılması

Hizmet Kredileri, herhangi bir kullanılabilirlik eksikliği veya Çalışma Süresi Taahhüdünün karşılanmaması durumunda tek ve münhasır çaredir ve bu tür başarısızlıklardan kaynaklanan diğer tüm sorumlulukların yerine geçer. Bu SLA’da açıkça belirtilenler dışında, Partner API “olduğu gibi” sağlanır. Geçerli yasanın izin verdiği azami ölçüde, Wink’in Hizmetten kaynaklanan veya Hizmetle ilgili toplam sorumluluğu Anlaşmada belirtilenlerle sınırlıdır ve Wink dolaylı, tesadüfi, özel, sonuçsal veya cezai zararlar ile kar, gelir, veri veya itibar kayıplarından sorumlu değildir, bu tür zararların olasılığı kendisine bildirilmiş olsa bile.

8. Süre, Değişiklikler ve Fesih

Bu SLA, SLA’nın geçerli olduğu belirtilen katmanda aktif Partner API aboneliğiniz olduğu sürece geçerlidir. Wink bu SLA’yı zaman zaman güncelleyebilir; önemli değişiklikler Wink’in müşterilerle iletişim için normalde kullandığı kanallardan duyurulacak ve güncelleme yürürlüğe girdikten sonra Partner API’nin kullanımı güncellenmiş SLA’nın kabulü anlamına gelecektir. Bu SLA, Anlaşmanın veya Partner API aboneliğinizin sona ermesi veya feshi ile otomatik olarak sona erer. Doğası gereği fesih sonrası da geçerli olması gereken bölümler — kazanılmış ancak talep edilmemiş Hizmet Kredisi hakları, sorumluluğun sınırlandırılması ve tanımlar dahil — yürürlükte kalır.