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 ani artış) | 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 üzerindeki her 1.000 aşan 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ı”İki OpenAPI yüzeyi rezervasyon yapılabilir envanteri sunar ve 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 isteklik ani artış ile. Sürekli oranın üzerindeki kısa sıçramalar ani artış 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 devam etmeden ö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 önerilir. 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ır.
-
Ölçülen istekler — 1.000 istek başına $1.00. Aylık istek sınırı yoktur ve normal kullanımda 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 aşan arama başına $2.00. Tedarikin sağlıklı kalması için arama (“arama”) ile onaylanmış rezervasyonlar oranını ölçeriz. Aşım uygulanmadan önce her rezervasyon için 5.000 arama hakkınız vardır. Aşan aramalar şu şekilde hesaplanır:
aşan = max(0, aramalar − rezervasyonlar × 5.000)Aşım daha sonra 1.000 aşan arama başına $2.00 olarak faturalandırılır. İyi dönüşüm sağlayan entegrasyonlar nadiren aşım yapar; ü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 (“Wink”, “biz”) tarafından müşteriye (“Müşteri”, “siz”) kimlik doğrulamalı Wink Partner API’si (“Partner API” veya “Hizmet”) için sağlanan 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çerli, ücretli Partner API aboneliğiniz devam ettiği sürece geçerlidir. Burada tanımlanmayan büyük harfli terimler Sözleşmede verilen anlamı taşır.
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ğrulanmış isteklere yanıt vermeye hazır olduğu süreleri ifade eder.
- “Kesinti Süresi”, Partner API’nin düzgün biçimlendirilmiş, kimlik doğrulanmış isteklere başarılı yanıt veremediği, dakika cinsinden ölçülen süreyi ifade eder; Bölüm 4’te belirtilen hariç tutmalar kapsam dışındadır. İzole hatalar, önemsiz istek oranını etkilemesi durumunda 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 Kesinti Süresi dakikalarının çıkarılmasıyla bulunan değerin, toplam dakika sayısı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 Hizmet 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.
- “Yanıt Süresi”, Wink’in düzgün biçimlendirilmiş, kimlik doğrulanmış isteği aldığı andan yanıt vermeye başladığı ana kadar geçen süredir; ağ gecikmesi ve 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ışı faktörleri kapsamaz. Wink’in izleme sistemleri, Aylık Çalışma Süresi Yüzdesi ve Yanıt Süresi ölçümlerinde yetkili kayıt kaynağıdır.
Wink ayrıca, her takvim ayı boyunca Wink’in hizmet sınırında ölçülen, başarılı, düzgün biçimlendirilmiş, kimlik doğrulanmış istekler için %95’lik dilimde (P95) 500 milisaniye altında Yanıt Süresi hedefler (“Performans Hedefi”). Performans Hedefi, Bölüm 4’te belirtilen faktörleri, istek kaynaklı 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 aşağıdaki oranlarda yüzdesi olarak 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 kayıtları içermelidir. Bu süre aşılırsa talepler kabul edilmez.
- 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 geçemez.
- 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 makul süre öncesinde ve Wink’in müşterilerle iletişimde kullandığı kanallardan yapılmışsa;
- Doğal afetler, devlet eylemleri, ağ veya altyapı arızaları, hizmet engelleme veya diğer kötü niyetli saldırılar gibi Wink’in makul kontrolü dışındaki mücbir sebepler;
- 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 olarak Wink tarafından makul şekilde belirlenen durumlar;
- 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, ö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 ç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 — Küçük | 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 erişilebilirliğ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 yasal sınırlar dahilinde, 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 iletişimde kullandığı 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 hakları, sorumluluğun sınırlandırılması ve tanımlar dahil — yürürlükte kalır.
