İçeriğe geç
Wink

Kurulum

Bu makale, bir geliştirici olarak hızlıca nasıl kurulacağınızı ve Wink üzerinde API’lerimizi test etmeye nasıl başlayacağınızı gösterir.

Aşağıdaki adımları izleyin:

  1. Wink üzerinde kullanıcı hesabınızı kaydettirin.
  2. Bir bağlı kuruluş hesabı oluşturun. Uygulamanızı bağlamak için buna ihtiyacınız olacak. Daha fazla bilgi için Studio nedir sayfasına bakın.
  3. Bir Uygulama oluşturun ve bunu 2. adımda oluşturduğunuz bağlı kuruluş hesabıyla ilişkilendirin. Sunucudan sunucuya API entegrasyonları için, istemci türü olarak MACHINE_2_MACHINE seçin.
  4. Application oluşturduktan sonra, client-id ve gizli anahtarı hemen kopyalayıp kaydedin — gizli anahtar yalnızca bir kez gösterilir ve tekrar alınamaz.

CDN

Bölüm başlığı “CDN”

Wink’te tüm resim ve video varlıklarımız için Cloudinary kullanıyoruz. Seyahat envanterimize eriştiğinizde, Cloudinary’nin tüm gelişmiş özelliklerine tam erişiminiz olacak.

cloud_name değerimiz travelikodur.

Cloudinary

Bölüm başlığı “Cloudinary”

Örnek

Bölüm başlığı “Örnek”

Desteklediğimiz her seyahat envanteri türü için, içinde multimedias adlı iç içe geçmiş bir JSON dizisi bulunur. Bir multimedya girdisinin JSON’u şu şekildedir:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Lobinin resmi",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Yukarıda vurgulanan satır, Cloudinary benzersiz ID’si partners/radisson_blu_logo’yu gösterir. Bu, resmi istediğiniz formatta, kalitede ve boyutta almak için ihtiyacınız olan tek bilgidir.

Test Etme

Bölüm başlığı “Test Etme”

API’lerimiz bölümüne gidin ve çalışmak istediğiniz API’yi seçin.

API dokümanları

Bölüm başlığı “API dokümanları”

Dokümantasyon sitemiz, site içinden API komutlarını çalıştıracak şekilde yapılandırılmıştır.

Bu örnekte, Search Lookups (OAuth2) API çağrısını kullanmak istiyorsunuz.

  1. Hedefleri veya otelleri almak için Lookup API kullanın.
  2. Sol navigasyon çubuğunda Authentication sekmesine tıklayın.
  3. Client-id ve client secret bilgilerinizi girin ve Get TOKEN butonuna tıklayın.
  4. Kimlik bilgileriniz geçerliyse, API anahtarınızın uygulandığını göreceksiniz.
  5. Artık lookup uç noktasını test edebilirsiniz.
Lookup API endpoint
Örnek Search Lookups (OAuth2)

Postman

Bölüm başlığı “Postman”

Aynı işlemi Postman ile de yapabilirsiniz.

  1. Postman uygulamasını indirin.
  2. Lookup API sayfasının üstünden Download OpenAPI spec seçeneğine tıklayın.
  3. Dosyayı Postman’a aktarın.
  4. Eğer yeni bir koleksiyon olarak Wink API adıyla aktardıysanız, koleksiyon adının yanındaki yatay üç noktaya tıklayın ve Edit seçeneğine tıklayın.
  5. Authorization sekmesinde, Auth type alanını OAuth2 olarak ayarlayın.
  6. Add auth data to alanını Request headers olarak ayarlayın.
  7. Header prefix alanını Bearer olarak ayarlayın.
  8. Token Name alanına, Postman’da kaydedeceğiniz token için istediğiniz adı verin. Örneğin Wink Staging.
  9. Grant type alanını Client Credentials olarak ayarlayın.
  10. Access token URL alanını https://staging-iam.wink.travel/oauth2/token olarak ayarlayın.
  11. Client ID alanına uygulamanızın oluşturduğu Client ID’yi girin.
  12. Client Secret alanına uygulamanızın oluşturduğu Client Secret’ı girin.
  13. Scope alanına entegrasyonunuzun ihtiyaç duyduğu boşlukla ayrılmış kapsamları girin (örneğin inventory.read inventory.write inventory.remove). Tam liste için scope referansına bakın.
  14. Client Authentication alanını Send as Basic Auth header olarak ayarlayın.
  15. Get New Access Token butonuna tıklayarak token’ınızı alın ve kaydedin.
  16. Wink API koleksiyonundaki tüm API çağrıları için, kimlik doğrulama sekmesinin Inherit auth from parent olarak ayarlandığından emin olun; böylece her çağrıda token’ınız gönderilir.