セットアップ

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

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

Winkでユーザーアカウントを登録します。
アフィリエイトアカウントを作成します。アプリケーションを紐付けるために必要です。詳細はStudioとは何かをご覧ください。
アプリケーションを作成し、ステップ2で作成したアフィリエイトアカウントに関連付けます。サーバー間API連携の場合は、クライアントタイプにMACHINE_2_MACHINEを選択してください。
Applicationを作成したら、クライアントIDとシークレットキーをすぐにコピーして保存してください。シークレットキーは一度しか表示されず、再取得できません。

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を示しています。これだけで、任意のフォーマット、品質、サイズで画像を取得できます。

テスト

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

APIドキュメント

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

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

Lookup APIを使って目的地やホテルを取得します。
左のナビゲーションバーでAuthenticationをクリックします。
クライアントIDとクライアントシークレットを入力し、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にアプリが生成したクライアントIDを設定します。
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になっていることを確認し、すべての呼び出しにトークンが含まれるようにします。