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:
- Kayıt olmak Wink’teki kullanıcı hesabınız
- Bir tane oluştur seyahat acentesi hesabı veya bir Ortaklık hesabı.
- Bir Uygulama Oluşturun Bunu 2. Adımda oluşturduğunuz hesapla ilişkilendirirsiniz.
- Oluşturduğunuzda
Application
, istemci kimliğini ve istemci sırrını güvenli bir yerde saklayın.
Kanada
Section titled “Kanada”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_name
dırtraveliko
.
Bulutlu
Section titled “Bulutlu”Desteklediğimiz her seyahat envanteri türü için, şu şekilde adlandırılan iç içe geçmiş bir JSON dizisi olacak:multimedias
Multimedya 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.
API belgeleri
Section titled “API belgeleri”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ı öneriyoruzOAuth2
Bu uç noktalar API çağrıcılarını beklediklerini bilir ve hangi hesapta olduğunuzu zaten bilir, böylece sizin belirtmenize gerek kalmazcompanyIdentifier
URL’lerinizde.
:::
- Kullanın Arama API’si Hedefleri veya otelleri almak için.
- Sol gezinme çubuğunda, üzerine tıklayın
Authentication
. - İstemci kimliğinizi ve istemci sırrınızı girin ve tıklayın
Get TOKEN
düğme. - Eğer kimlik bilgileriniz geçerliyse API anahtarınızın uygulandığını göreceksiniz.
- Artık arama uç noktasını test edebilirsiniz.
Postacı
Section titled “Postacı”Aynı şeyi Postman ile de yapabilirsiniz.
- İndirmek Postacı.
- Tıkla
Download OpenAPI spec
en üstten Arama API’si sayfa. - Bunu Postman’a aktarın.
- 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ınEdit
. - İçinde
Authorization tab
, ayarlayınAuth type
OAuth2’ye. - Alanı ayarlayın
Add auth data to
ileRequest headers
. - Alanı ayarlayın
Header prefix
ileBearer
. - Alanı ayarlayın
Token Name
Postman’de kaydettiğiniz token’ınıza istediğiniz ismi verebilirsiniz. Örn. Wink Staging. - Alanı ayarlayın
Grant type
ileClient Credentials
. - Alanı ayarlayın
Access token URL
https://staging-iam.wink.travel/oauth2/token adresine gidin. - Alanı ayarlayın
Client ID
Uygulamanızın oluşturulmasına yardımcı olduğu İstemci Kimliğine. - Alanı ayarlayın
Client Secret
Uygulamanızın oluşturulmasına yardımcı olduğu İstemci Sırrı’na. - Alanı ayarlayın
Scope
ileinventory.read inventory.write inventory.remove
Wink için ihtiyacınız olacak tüm dürbünler bunlar. - Alanı ayarlayın
Client Authentication
ileSend as Basic Auth header
. - Tıkla
Get New Access Token
Token’ınızı almak ve kaydetmek için düğmeye basın. - 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. :::