İç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

Section titled “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

Section titled “Cloudinary”

Örnek

Section titled “Ö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 şöyle görünür:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Picture of the lobby",
      "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. İstediğiniz formatta, kalitede ve boyutta resmi almak için ihtiyacınız olan tek şey budur.

Test Etme

Section titled “Test Etme”

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

API dokümanları

Section titled “API dokümanları”

Dokümantasyon sitemiz, site içinden API komutlarını çalıştırabileceğiniz ş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 navigasyonda 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

Section titled “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ğini seçin.
  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 ismi 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 inventory.read inventory.write inventory.remove yazın. Bunlar Wink için gereken tüm kapsamlar.
  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ında, kimlik doğrulama sekmesinin Inherit auth from parent olarak ayarlandığından emin olun; böylece token her çağrıyla gönderilir.