セットアップ

この記事では、開発者として迅速にセットアップし、WinkのAPIをテストし始める方法を説明します。

以下の手順に従ってください：

Winkでユーザーアカウントを登録します
旅行代理店アカウントまたはアフィリエイトアカウントを作成します。
ステップ2で作成したアカウントに紐づけるアプリケーションを作成します。
Applicationを作成したら、client-idとclient secretを安全な場所に保存してください。

CDN

Winkでは、すべての画像および動画資産にCloudinaryを使用しています。旅行在庫にアクセスすると、Cloudinaryの高度な機能をすべて利用できます。

当社のcloud_nameは travelikoです。

Cloudinary

例

サポートしているすべての旅行在庫タイプには、multimediasというネストされたJSON配列があります。マルチメディアエントリのJSONは以下のようになります：

{
  "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"
    }
  ]
}

上記のハイライトされた行はCloudinaryのユニークID partners/radisson_blu_logoを示しています。これだけで、任意のフォーマット、品質、サイズで画像を取得できます。

テスト

APIセクションにアクセスし、使用したいAPIを選択してください。

APIドキュメント

当社のドキュメントサイトは、サイト内からAPIコマンドを実行できるように設定されています。

この例では、Search Lookups (OAuth2) APIコールを使用します。

Lookup APIを使って目的地やホテルを取得します。
左のナビゲーションバーでAuthenticationをクリックします。
client-idとclient secretを入力し、Get TOKENボタンをクリックします。
資格情報が有効であれば、APIキーが適用されたことが表示されます。
これでlookupエンドポイントをテストできます。

Lookup API endpoint — *Search Lookups (OAuth2)のサンプル*

Postman

Postmanでも同様のことができます。

Postmanをダウンロードします。
Lookup APIページの上部からDownload OpenAPI specをクリックします。
それをPostmanにインポートします。
新しいコレクションWink APIとしてインポートした場合、コレクション名の横の横三点リーダー（3点）をクリックし、Editを選択します。
AuthorizationタブでAuth typeをOAuth2に設定します。
Add auth data toをRequest headersに設定します。
Header prefixをBearerに設定します。
Token NameにPostmanで保存するトークン名を任意に設定します。例：Wink Staging。
Grant typeをClient Credentialsに設定します。
Access token URLを https://staging-iam.wink.travel/oauth2/token に設定します。
Client IDにアプリが生成したClient IDを設定します。
Client Secretにアプリが生成したClient Secretを設定します。
Scopeに inventory.read inventory.write inventory.remove を設定します。これがWinkで必要なすべてのスコープです。
Client AuthenticationをSend as Basic Auth headerに設定します。
Get New Access Tokenボタンをクリックしてトークンを取得し、保存します。
Wink APIコレクション内のすべてのAPIコールで、認証タブがInherit auth from parentになっていることを確認し、すべてのコールにトークンが含まれるようにします。