セットアップ

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

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

Winkでユーザーアカウントを登録します
旅行代理店アカウントまたはアフィリエイトアカウントを作成します。
ステップ2で作成したアカウントに紐づけるアプリケーションを作成します。
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を示しています。これだけで、任意のフォーマット、品質、サイズで画像を取得できます。

テスト

API セクションにアクセスし、使用したい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になっていることを確認し、すべての呼び出しにトークンが含まれるようにします。