İçeriğe geç

Uygulamalar

Uygulamalar, bir geliştirici olarak Wink’in tüm özelliklerine erişmenizi sağlar. Aynı verilere erişebilir ve hatta Wink’in kendi özelliklerini genişletebilirsiniz. Seyahat sitenizi kimlik doğrulamak için Google veya Facebook kullanır gibi Wink’in OAuth2 sunucusunu kullanmayı seçebilirsiniz. Böylece Wink’in özelliklerini kendi web sitenize veya uygulamanıza entegre edebilirsiniz.

Örnek uygulama
Örnek uygulama girişi
  1. Çalışmak istediğiniz hesabı Hesaplar sayfasından seçin.
  2. Hesap kartının altındaki Actions butonuna tıklayın ve Manage account seçeneğini seçin.
  3. Sonraki sayfada Applications sekmesine tıklayın.
  4. Bu bölümde tüm uygulamalarınız listelenecektir.
  5. Var olan bir uygulamayı döndürün veya silin ya da yeni bir tane oluşturun.

Sizin için oluşturduğumuz uygulamanın secret keyine erişemediğiniz için kendi uygulamanızı oluşturmanız gerekecek. Burada bir uygulama oluşturabilirsiniz; öncelikle bir mülk veya şirket kurmanıza gerek yoktur — herhangi bir hesaba bağlı değildir.

Bir uygulama oluştururken, uygulamanın nasıl kimlik doğrulaması yapacağını belirleyen bir istemci türü seçersiniz. Bu daha sonra değiştirilemez — farklı bir tür gerekiyorsa yeni bir uygulama oluşturun.

  • Web uygulaması — İstemci gizli anahtarını güvenle saklayabilen sunucu tarafı uygulaması (authorization code flow).
  • Tek sayfa uygulaması (SPA) — Arka ucu olmayan tarayıcı uygulaması; PKCE kullanır, istemci gizli anahtarı yoktur.
  • Mobil uygulama — Yerel iOS/Android uygulaması; dönen yenileme belirteçleri ile PKCE kullanır.
  • Makine-makine arası — Kendisi olarak hareket eden arka uç servisi (client credentials); kullanıcı girişi yoktur.

Bir uygulama oluşturmanın adımları şunlardır:

  1. Uygulamalar sayfasından Create new application butonuna tıklayın.
  2. Ad Uygulamanıza bir ad verin. ör. Cool App
  3. İstemci türü Uygulamanızın kimlik doğrulama şekline uygun türü seçin — yukarıdaki İstemci türleri bölümüne bakın.
  4. Yönlendirme URI’leri En az bir yönlendirme URI’si gereklidir. Başarılı kimlik doğrulama sonrası yönlendirme alanını doğrulamak için kullanılır. Makine-makine uygulamaları için kullanılmaz. ör. https://www.cool-site.com
  5. Çıkış sonrası yönlendirme URI’leri (İsteğe bağlı) Kullanıcıların çıkış yaptıktan sonra yönlendirileceği URL’ler. Yukarıdaki yönlendirme URI’lerini tekrar kullanmak için boş bırakın.
  6. Kapsamlar Bu uygulamanın sizin adınıza neleri erişebileceğini seçin — aşağıdaki Kapsam seçimi bölümüne bakın.
  7. Devam etmek için Create application butonuna tıklayın.

Uygulamalar listenize geri yönlendirilirsiniz ve yeni Client ID ile Client secret içeren tek seferlik bir iletişim kutusu gösterilir. Secret anahtarı şimdi kopyalayın ve güvenli bir yerde saklayın — bir daha asla gösterilmez ve daha sonra geri alınamaz (yalnızca yenileyebilirsiniz).

Her uygulama her zaman Oturum açma (OpenID Connect) kapsamlarını (openid, profile, email, offline_access) taşır — bunlar kullanıcının kimliğini doğrular ve oturumun açık kalmasını sağlar, bu yüzden işaretli ve kilitlidir; seçim yapılamaz.

Diğer her şey isteğe bağlıdır. Kalan kapsamlar, Kapsamlar bölümünde belgelenen aynı işlevsel bölümlere ayrılmıştır — Hesap, Envanter ve fiyatlar, Rezervasyonlar, Pazarlama ve promosyonlar, Mülk içeriği, Analitik ve raporlar, Kanal yöneticisi entegrasyonları, Ödemeler ve Muhasebe & defter — her biri neyi açtığını sade bir dille açıklar. Listedeki tüm isteğe bağlı kapsamları aynı anda seçmek veya temizlemek için üstteki All / None bağlantılarını kullanın.

Bu formda bilinçli olarak sunulmayan iki kapsam ailesi vardır:

  • mcp.* — Model Context Protocol taşıma için AI ajan erişimi. Bunun için bir uygulama oluşturmazsınız: Claude, ChatGPT veya Codex gibi bir AI istemcisi kendini kaydeder ve MCP onay ekranından oturum açarken bu kapsamları ister. Makine-makine uygulamalarına asla verilmez, çünkü MCP her zaman oturum açmış bir kullanıcı adına hareket eder.
  • Yönetici düzeyi kapsamlar (administrator.*) — uygulama bazında verilmez, platform düzeyinde erişim sağlar.

Bir uygulama oluşturulduktan sonra, hem bu sekme hem de Onaylanmış Uygulamalar uygulamanın verilen kapsamlarını bölüm bölüm (örneğin “Rezervasyonlar: booking.read”) gösterir, böylece uygulamanın neler yapabileceğini açmadan görebilirsiniz.

Bir istemci gizli anahtarı sızdırılmış olabilir veya sadece yeni kimlik bilgileri istiyorsanız, uygulamayı yeniden oluşturmak yerine bunları yenileyin:

  1. Uygulamalar listenizde uygulamayı bulun ve Rotate butonuna tıklayın.
  2. İletişim kutusunu onaylayın — mevcut Client ID ve secret hemen geçersiz olur.
  3. Kapatmadan önce yeni Client ID ve secret’ı tek seferlik iletişim kutusundan kopyalayın.

Yenileme, uygulamanın adını, istemci türünü, yönlendirme URI’lerini ve kapsamlarını korur — sadece kimlik bilgileri değişir.

Bir uygulamaya artık ihtiyacınız yoksa, kaldırabilirsiniz. Bu kalıcıdır — kimlik bilgileri hemen iptal edilir ve geri alınamaz.

  1. Uygulamalar listenizde uygulamayı bulun ve Delete butonuna tıklayın.
  2. Uygulamayı kalıcı olarak silmek için iletişim kutusunu onaylayın.