コンテンツにスキップ

Setup

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

次の手順に従ってください。

  1. 登録する Winkのユーザーアカウント
  2. 作成する 旅行代理店アカウント または アフィリエイトアカウント
  3. アプリケーションを作成する ここで、ステップ 2 で作成したアカウントに関連付けます。
  4. 作成したら Applicationクライアント ID とクライアント シークレットを安全な場所に保存します。

Winkでは、すべての画像と動画アセットにCloudinaryを使用しています。旅行関連インベントリにアクセスすると、Cloudinaryの高度な機能をすべてご利用いただけます。

私たちの cloud_nametraveliko

私たちがサポートするすべての旅行インベントリタイプには、ネストされたJSON配列があります。multimediasマルチメディアエントリの 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 コマンドを実行できるように設定されています。

この例では、Search Lookups (OAuth2)API 呼び出し。

:::tip[プロのヒント] 使いやすさを考慮して、インテグレーターには、私たちが指定するエンドポイントを使用することをお勧めします。OAuth2これらのエンドポイントはAPI呼び出し元を予期しており、どのアカウントを使用しているかをすでに把握しているので、companyIdentifierURL に含めてください。 :::

  1. 使用 ルックアップAPI 目的地やホテルを検索します。
  2. 左のナビゲーションバーで、 Authentication
  3. クライアントIDとクライアントシークレットを入力し、 Get TOKEN ボタン。
  4. 資格情報が有効な場合は、API キーが適用されていることがわかります。
  5. これで、ルックアップ エンドポイントをテストできます。
ルックアップAPIエンドポイント
サンプル検索ルックアップ(OAuth2)

Postman でも同じことができます。

  1. ダウンロード 郵便配達員
  2. クリック Download OpenAPI spec 上から ルックアップAPI ページ。
  3. Postman にインポートします。
  4. 新しいコレクションとしてインポートした場合 Wink APIコレクション名の横にある水平の省略記号(3つの点)をクリックし、 Edit
  5. の中で Authorization tab、設定します Auth type OAuth2 へ。
  6. フィールドを設定する Add auth data toRequest headers
  7. フィールドを設定する Header prefixBearer
  8. フィールドを設定する Token Name Postmanで保存したトークンに任意の名前を付けます。例:Wink Staging。
  9. フィールドを設定する Grant typeClient Credentials
  10. フィールドを設定する Access token URL https://staging-iam.wink.travel/oauth2/token へ。
  11. フィールドを設定する Client ID アプリが生成したクライアント ID です。
  12. フィールドを設定する Client Secret アプリが生成したクライアント シークレットに。
  13. フィールドを設定する Scopeinventory.read inventory.write inventory.removeWink に必要なスコープはこれだけです。
  14. フィールドを設定する Client AuthenticationSend as Basic Auth header
  15. クリック Get New Access Token ボタンをクリックしてトークンを取得して保存します。
  16. Wink APIコレクションのすべてのAPI呼び出しについて、認証タブに次の内容が表示されていることを確認してください。 Inherit auth from parent そのため、すべての呼び出しにトークンが含まれます。

:::tip[プロのヒント] サーバードメイン、クライアントID、クライアントシークレットを環境変数に設定することをお勧めします。これにより、ステージング環境と本番環境を簡単に切り替えることができ、作成したすべての操作を再利用できるようになります。 :::