İçeriğe geç
Academy

Kurulum

Bu makale, 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ı kaydolun
  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 görsel 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 olur.

cloud_name değerimiz travelikodur.

Cloudinary

Section titled “Cloudinary”

Örnek

Section titled “Örnek”

Desteklediğimiz her seyahat envanteri türü için multimedias adında 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": "Lobi resmi",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

Yukarıda vurgulanan satır, Cloudinary benzersiz ID’si olan partners/radisson_blu_logoyu gösterir. Bu, resmi istediğiniz formatta, kalitede ve boyutta almanız için gereken 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, API komutlarını site içinden çalıştırmanıza olanak verecek ş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 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 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ü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 içe 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ı için, kimlik doğrulama sekmesinin Inherit auth from parent olarak ayarlandığından emin olun; böylece her çağrıda token dahil edilir.