Setup

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

ノート

テストは常に私たちのステージング環境データは大幅に少なくなりますが、本番環境に影響を与えることなく、好きなだけテストを行うことができます。

公開準備が整ったら、アカウントとアプリケーションの認証を行い、本番環境で起動できるようになります。

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

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

CDN

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

私たちの cloud_name は traveliko。

曇り空

• はじめる
• SDK
• GitHub 上の Cloudinary
• ビデオチュートリアル

例

私たちがサポートするすべての旅行インベントリタイプには、ネストされた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ドキュメント

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

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

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

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

サンプル検索ルックアップ（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 to に Request headers。
7. フィールドを設定する Header prefix に Bearer。
8. フィールドを設定する Token Name Postmanで保存したトークンに任意の名前を付けます。例：Wink Staging。
9. フィールドを設定する Grant type に Client Credentials。
10. フィールドを設定する Access token URL https://staging-iam.wink.travel/oauth2/token へ。
11. フィールドを設定する Client ID アプリが生成したクライアント ID です。
12. フィールドを設定する Client Secret アプリが生成したクライアント シークレットに。
13. フィールドを設定する Scope に inventory.read inventory.write inventory.removeWink に必要なスコープはこれだけです。
14. フィールドを設定する Client Authentication に Send as Basic Auth header。
15. クリック Get New Access Token ボタンをクリックしてトークンを取得して保存します。
16. Wink APIコレクションのすべてのAPI呼び出しについて、認証タブに次の内容が表示されていることを確認してください。 Inherit auth from parent そのため、すべての呼び出しにトークンが含まれます。

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