İçeriğe geç

Setup

Bu makale, bir geliştirici olarak nasıl hızlı bir şekilde kurulum yapacağınızı ve Wink’te API’lerimizi test etmeye nasıl başlayacağınızı göstermektedir.

Test her zaman bizim tarafımızdan yapılmalıdırsahneleme ortamıOrada çok daha az veri var ama üretim ortamına yük olmadan istediğiniz kadar test yapma özgürlüğüne sahipsiniz.

Canlı yayına geçmeye hazır olduğunuzda, hesabınızı ve uygulamanızı onaylayacağız ve üretim ortamımızda başlatabileceksiniz.

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

  1. Kayıt olmak Wink’teki kullanıcı hesabınız
  2. Bir tane oluştur seyahat acentesi hesabı veya bir Ortaklık hesabı.
  3. Bir Uygulama Oluşturun Bunu 2. Adımda oluşturduğunuz hesapla ilişkilendirirsiniz.
  4. Oluşturduğunuzda Application, istemci kimliğini ve istemci sırrını güvenli bir yerde saklayın.

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

Bizim cloud_namedırtraveliko.

Desteklediğimiz her seyahat envanteri türü için, şu şekilde adlandırılan iç içe geçmiş bir JSON dizisi olacak:multimediasMultimedya girişinin JSON’u şu şekilde 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’nin benzersiz kimliğini gösterirpartners/radisson_blu_logoİstediğiniz formatta, kalitede ve boyutta görüntüyü almak için ihtiyacınız olan tek şey bu.

Hadi gelin, bizimkine gidelimAPI’lerbölümüne gidin ve çalışmak istediğiniz API’yi seçin.

Dokümantasyon sitemiz API komutlarını site içerisinden çalıştırabileceğiniz şekilde düzenlenmiştir.

Bu örnekte, şunu kullanmak istersiniz:Search Lookups (OAuth2)API çağrısı.

:::tip[Pro İpucu] Kullanım kolaylığı için, entegratörlerin bizim belirlediğimiz uç noktaları kullanmasını öneriyoruzOAuth2Bu uç noktalar API çağrıcılarını beklediklerini bilir ve hangi hesapta olduğunuzu zaten bilir, böylece sizin belirtmenize gerek kalmazcompanyIdentifierURL’lerinizde. :::

  1. Kullanın Arama API’si Hedefleri veya otelleri almak için.
  2. Sol gezinme çubuğunda, üzerine tıklayın Authentication.
  3. İstemci kimliğinizi ve istemci sırrınızı girin ve tıklayın Get TOKEN düğme.
  4. Eğer kimlik bilgileriniz geçerliyse API anahtarınızın uygulandığını göreceksiniz.
  5. Artık arama uç noktasını test edebilirsiniz.
Arama API uç noktası
Örnek Arama Aramaları (OAuth2)

Aynı şeyi Postman ile de yapabilirsiniz.

  1. İndirmek Postacı.
  2. Tıkla Download OpenAPI spec en üstten Arama API’si sayfa.
  3. Bunu Postman’a aktarın.
  4. Bunu yeni bir koleksiyon olarak içe aktardıysanız Wink API, koleksiyon adının yanındaki yatay üç noktaya (3 nokta) tıklayın ve tıklayın Edit.
  5. İçinde Authorization tab, ayarlayın Auth type OAuth2’ye.
  6. Alanı ayarlayın Add auth data to ile Request headers.
  7. Alanı ayarlayın Header prefix ile Bearer.
  8. Alanı ayarlayın Token Name Postman’de kaydettiğiniz token’ınıza istediğiniz ismi verebilirsiniz. Örn. Wink Staging.
  9. Alanı ayarlayın Grant type ile Client Credentials.
  10. Alanı ayarlayın Access token URL https://staging-iam.wink.travel/oauth2/token adresine gidin.
  11. Alanı ayarlayın Client ID Uygulamanızın oluşturulmasına yardımcı olduğu İstemci Kimliğine.
  12. Alanı ayarlayın Client Secret Uygulamanızın oluşturulmasına yardımcı olduğu İstemci Sırrı’na.
  13. Alanı ayarlayın Scope ile inventory.read inventory.write inventory.removeWink için ihtiyacınız olacak tüm dürbünler bunlar.
  14. Alanı ayarlayın Client Authentication ile Send as Basic Auth header.
  15. Tıkla Get New Access Token Token’ınızı almak ve kaydetmek için düğmeye basın.
  16. Wink API koleksiyonu altındaki tüm API çağrıları için kimlik doğrulama sekmesinin şunu söylediğinden emin olun: Inherit auth from parent yani her çağrıda token’ınız ekleniyor.

:::tip[Pro İpucu] Sunucu etki alanını, istemci kimliğini ve istemci sırrını ortam değişkenlerine dönüştürmeniz önerilir. Bu şekilde, hazırlama ve üretim ortamları arasında kolayca geçiş yapabilir ve oluşturduğunuz tüm işlemleri yeniden kullanabilirsiniz. :::