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 başına faturalandırılır, böylece yalnızca gerçekten gönderdiğiniz trafik için ödeme yaparsınız.
Planlar ve fiyatlandırma
Bölüm başlığı “Planlar ve fiyatlandırma”Bir API çağrısı = bir istek. Ölçülen kullanım 1.000 istek başına faturalandırılı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 başına ödeme | Özel hacim ve müzakere edilen koşullar |
| Dakikada istek sayısı | 30 (60 patlama) | Sınırsız | Sınırsız |
| Aylık istek sayısı | 10.000 | Sınırsız | Sınırsız |
| API yanıt süresi (P95) | — | 500 ms altında | 500 ms altında |
| 1.000 istek başına fiyat | Ücretsiz | $1.00 | Özel |
| Rezervasyona dönüşüm aşımı (5.000:1 oranını aşan her 1.000 fazla arama için) | — | $2.00 | Özel |
| Oran sınırı yanıtı | 429 (duraklatma / aylık kesin durdurma) | Yok | Yok |
| Hizmet Düzeyi Anlaşması | — | ✓ | ✓ |
| Öncelikli destek | — | ✓ | ✓ |
| Özel onboarding | — | — | ✓ |
Bir API anahtarı alın · Ölçülen faturalandırmaya başlayın · Satış ile iletişime geçin
API referansı
Bölüm başlığı “API referansı”Rezervasyon yapılabilir envanteri sunan iki OpenAPI yüzeyi vardır ve bunlar yukarıdaki iki katmana karşılık gelir:
- Ücretsiz — Tüketici / Rezervasyon Motoru API’si (
/api/public/**): anonim, tarayıcı ve widget odaklı. Rezervasyon Motoru referansına göz atın → - Ücretli — Partner Entegratör API’si (
/api/partner/**): kimlik doğrulamalı, kullanım ölçümlü, ölçekli sunucu-sunucu entegrasyonu için tasarlanmış. Entegratör referansına göz atın →
Kullanım ve sınırlar nasıl çalışır
Bölüm başlığı “Kullanım ve sınırlar nasıl çalışır”Ücretsiz katman
Bölüm başlığı “Ücretsiz katman”Ücretsiz katman, düşük maliyetle makul üretim trafiği oluşturmanıza, test etmenize ve çalıştırmanıza olanak tanır.
- Oran sınırı — Dakikada 30 istek, 60 istek patlaması ile. Sürekli oran üzerindeki kısa dalgalanmalar patlama hakkı ile karşılanır. Aşarsanız, API HTTP 429 (Çok Fazla İstek) ile yanıt verir ve anahtarınızın trafiği sunmaya başlamadan önce 5 dakikalık duraklatma uygular. Duraklatma süresi bitene kadar bekleyin ve tekrar deneyin, uç noktaya aşırı yüklenmeyin.
- Aylık kota — Takvim ayı başına 10.000 istek. Aylık sınırı aştığınızda, API ayın geri kalanında HTTP 429 döner — kesin durdurma — ve devam etmek için Ücretli katmana abone olmanız gerektiğini belirten bir mesaj gösterir. Sayaç bir sonraki takvim ayının başında sıfırlanır.
Ücretsiz katman Hizmet Düzeyi Anlaşması veya öncelikli destek içermez.
Ücretli katman
Bölüm başlığı “Ücretli katman”Ücretli katman aylık sınırı ve oran sınırı duraklatmalarını kaldırır, yalnızca kullandığınız kadar faturalandırılır.
-
Ölçülen istekler — 1.000 istek başına $1.00. Normal kullanımda aylık istek sınırı veya oran sınırı kısıtlaması yoktur; gerçek hacim üzerinden faturalandırılırsınız.
-
Rezervasyona dönüşüm aşımı — 1.000 fazla arama başına $2.00. Tedarikin sağlıklı kalması için arama (“bakış”) ile onaylanmış rezervasyonlar arasındaki oran ölçülür. Rezervasyon başına 5.000 arama hakkınız vardır, aşım uygulanmadan önce. Fazla arama şu şekilde hesaplanır:
fazla = max(0, aramalar − rezervasyonlar × 5.000)Aşım, 1.000 fazla arama başına $2.00 olarak faturalandırılır. İyi dönüşüm sağlayan entegrasyonlar nadiren aşım ücreti öder; bu ücret yalnızca çok fazla arama yapan trafiğe uygulanı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ı
Bölüm başlığı “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”, “bize”) kimlik doğrulamalı Wink Partner API’si (“Partner API” veya “Hizmet”) için müşteriye (“Müşteri”, “siz”) sağladığı kullanılabilirlik taahhüdü, hizmet kredileri ve destek hedeflerini belirler. Bu SLA, Partner API’ye eriştiğiniz Wink ile aranızdaki sözleşmeye (“Sözleşme”) dahil edilmiştir ve geçerlidir; aktif, ücretli ve iyi durumda bir Partner API aboneliğiniz olduğu sürece uygulanır. Burada tanımlanmayan büyük harfli terimler Sözleşmede verilen anlamlara sahiptir.
1. Tanımlar
Bölüm başlığı “1. Tanımlar”- “Çalışma Süresi”, Partner API’nin düzgün biçimlendirilmiş, kimlik doğrulamalı istekleri kabul edip başarılı şekilde yanıtladığı dönemlerdir.
- “Kesinti Süresi”, Partner API’nin düzgün biçimlendirilmiş, kimlik doğrulamalı isteklere başarılı yanıt vermediği, dakika cinsinden ölçülen herhangi bir süredir; Bölüm 4’te belirtilen hariç tutmalar dışındadır. İzole hatalar, önemsiz istek oranını etkiliyorsa, tek başına Kesinti Süresi sayılmaz.
- “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 yüzde olarak ifade edilir.
- “Planlı Bakım”, Wink’in Bölüm 4’e uygun olarak önceden bildirimde bulunduğu Hizmetin planlı bakımıdır.
- “Hizmet Kredisi”, Partner API için o ay ödediğiniz veya ödeyeceğiniz ücretlerin yüzdesi olarak hesaplanan ve çalışma süresi taahhüdünün karşılanmaması durumunda gelecekteki Partner API ücretlerinden mahsup edilen kredi tutarıdır; tek ve münhasır çaredir.
- “Yanıt Süresi”, Wink’in hizmet sınırında düzgün biçimlendirilmiş, kimlik doğrulamalı 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ü
Bölüm başlığı “2. Kullanılabilirlik ve Performans Taahhüdü”Wink, Partner API’nin her takvim ayında en az %99,9 Aylık Çalışma Süresi Yüzdesi ile kullanılabilir olmasını ticari makul çabalarla sağlamayı taahhüt eder (“Ç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 kapsamaz. Aylık Çalışma Süresi Yüzdesi ve Yanıt Süresi ölçümleri için Wink’in izleme sistemleri yetkili kayıt kaynağıdır.
Wink ayrıca her takvim ayı boyunca düzgün biçimlendirilmiş, kimlik doğrulamalı başarılı istekler için Wink’in hizmet sınırında ölçülen %95 persentil (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 hatalarını ve olağandışı büyük veya karmaşık toplu istekleri kapsamaz. 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
Bölüm başlığı “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 ödeyeceğiniz 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 veya üzerinde | %10 |
| %99,0’ın altında ama %95,0 veya üzerinde | %25 |
| %95,0’ın altında | %50 |
- 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 ile makul şekilde temin edilebilir destekleyici günlükleri veya kanıtları içermelidir. Bu süre sonrasında yapılan talepler uygun değildir.
- Kredi şekli. Onaylanan Hizmet Kredileri gelecekteki Partner API ücretlerinden mahsup edilir ve nakit değeri yoktur. İade değildir ve geçerli yasa gerektirmedikçe ödenmez.
- Maksimum kredi. Herhangi bir takvim ayı için verilebilecek toplam Hizmet Kredisi, o ay için ödediğiniz veya ödeyeceğiniz Partner API ücretlerinin %50’sini aşamaz.
- Tek ve münhasır çare. Hizmet Kredileri, Wink’in Çalışma Süresi Taahhüdünü karşılamaması veya Partner API’nin kullanılabilirliğindeki diğer eksiklikler için sizin tek ve münhasır çarenizdir.
4. Hariç Tutmalar
Bölüm başlığı “4. Hariç Tutmalar”Çalışma Süresi Taahhüdü ve buna bağlı Hizmet Kredileri, aşağıdaki durumlar için geçerli değildir ve Kesinti Süresi olarak sayılmaz:
- Wink’in önceden bildirimde bulunduğu Planlı Bakım, bu bildirim müşterilerle normalde iletişim kurduğu kanallardan makul süre öncesinde yapılmışsa;
- 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;
- Sizin eylemleriniz veya ihmalleriniz, ekipmanınız, yazılımınız veya ağınız ya da Wink’in doğrudan kontrolü dışındaki herhangi bir üçüncü taraf hizmet, ürün veya sağlayıcı kaynaklı sorunlar;
- Hizmeti kötüye kullanmanız veya Sözleşme, bu SLA, kabul edilebilir kullanım koşulları veya geçerli oran sınırlarını ihlal etmeniz, aşırı trafik, otomatik kötüye kullanım veya dolandırıcılık gibi Wink’in makul şekilde aşırı kabul ettiği trafik dahil;
- Sözleşme kapsamında uygun şekilde uygulanan erişim askıya alma veya sonlandırma işlemleri, ödeme yapılmaması nedeniyle askıya alma dahil.
5. Destek ve Yanıt Hedefleri
Bölüm başlığı “5. Destek ve Yanıt Hedefleri”Wink, Partner API için yerel resmi tatiller hariç standart çalışma saatlerinde destek sağlar. Wink, sizin atadığınız ve Wink’in makul şekilde onayladığı önem derecesine göre, düzgün iletilmiş destek taleplerini aşağıdaki hedef yanıt süreleri içinde onaylamaya ticari makul çabalarla çalışır:
| Önem Derecesi | Açıklama | Hedef ilk yanıt süresi |
|---|---|---|
| Sev 1 — Kritik | Partner API üretimde kullanılamıyor veya çalışmıyor, geçici çözüm yok. | 4 saat |
| Sev 2 — Önemli | Önemli özellik bozuk 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 garantisi değildir. Öncelikli destek ve önem derecesine göre hedefler, dahil olduğu belirtilen katmanlarda geçerlidir.
6. Veri ve Güvenlik
Bölüm başlığı “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 Sözleşmedeki 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ı
Bölüm başlığı “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 açıkça belirtmedikçe, 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 Sözleşmede 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
Bölüm başlığı “8. Süre, Değişiklikler ve Fesih”Bu SLA, SLA’nın geçerli olduğu 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 normalde iletişim kurduğu kanallardan duyurulur ve güncelleme yürürlüğe girdikten sonra Partner API’yi kullanmaya devam etmeniz güncellenmiş SLA’yı kabul ettiğiniz anlamına gelir. Bu SLA, Sözleşmenin 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 — hak kazanılmış ancak talep edilmemiş Hizmet Kredisi uygunluğu, sorumluluğun sınırlandırılması ve tanımlar dahil — yürürlükte kalır.
