İçeriğe geç

Uygulamalar

Uygulamalar, 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. Hesaplar sayfasından çalışmak istediğiniz hesabı 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ı yenileyin veya silin ya da yeni bir tane oluşturun.

Sizin için oluşturduğumuz uygulamanın gizli anahtarına 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ı (yetkilendirme kodu akışı).
  • 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 (istemci kimlik bilgileri); 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 İstemci Kimliği ile İstemci gizli anahtarını gösteren tek seferlik bir iletişim kutusu açılır. Gizli anahtarı şimdi kopyalayın ve güvenli bir yerde saklayın — bir daha asla gösterilmez ve daha sonra geri alınamaz (yalnızca kimlik bilgilerini yenileyerek yeni bir tane alabilirsiniz).

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 nedenle işaretli ve kilitlidir; seçim yapılamaz.

Diğer her şey isteğe bağlıdır. Kalan kapsamlar, Kapsamlar sayfasında 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 listenin üstündeki Tümü / Hiçbiri bağlantılarını kullanın.

Bu formda kasıtlı olarak sunulmayan iki kapsam ailesi vardır:

  • mcp.* — Model Context Protocol taşıma için AI ajan erişimi, ayrı olarak sağlanır ve yalnızca makine-makine istemcileri içindir.
  • 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 kimlik bilgilerini yenileyin:

  1. Uygulamalar listenizde uygulamayı bulun ve Rotate butonuna tıklayın.
  2. İletişim kutusunu onaylayın — mevcut İstemci Kimliği ve gizli anahtar hemen geçersiz olur.
  3. Kapatmadan önce yeni İstemci Kimliği ve gizli anahtarı 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.