İçeriğe geç
Academy

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 seyahat acentesi hesabı veya bir iş ortağı hesabı oluşturun.
    1. Adımda oluşturduğunuz hesapla ilişkilendireceğiniz bir Uygulama oluşturun.
  4. Application oluşturduktan sonra, client-id ve client secret bilgilerinizi güvenli bir yerde saklayın.

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şim hakkınız 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 ş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

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. Hedef 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 uç noktası
Ö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 kısmından 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 içe 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 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, authentication sekmesinin Inherit auth from parent olarak ayarlandığından emin olun, böylece token her çağrıda dahil edilir.