Setup
この記事では、開発者としてすぐにセットアップし、Wink で API のテストを始める方法を説明します。
次の手順に従ってください。
- 登録する Winkのユーザーアカウント
- 作成する 旅行代理店アカウント または アフィリエイトアカウント。
- アプリケーションを作成する ここで、ステップ 2 で作成したアカウントに関連付けます。
- 作成したら
Application
クライアント ID とクライアント シークレットを安全な場所に保存します。
Winkでは、すべての画像と動画アセットにCloudinaryを使用しています。旅行関連インベントリにアクセスすると、Cloudinaryの高度な機能をすべてご利用いただけます。
私たちの cloud_name
は traveliko
。
私たちがサポートするすべての旅行インベントリタイプには、ネストされた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ドキュメント
Section titled “APIドキュメント”当社のドキュメント サイトは、サイト内から API コマンドを実行できるように設定されています。
この例では、Search Lookups (OAuth2)
API 呼び出し。
:::tip[プロのヒント]
使いやすさを考慮して、インテグレーターには、私たちが指定するエンドポイントを使用することをお勧めします。OAuth2
これらのエンドポイントはAPI呼び出し元を予期しており、どのアカウントを使用しているかをすでに把握しているので、companyIdentifier
URL に含めてください。
:::
- 使用 ルックアップAPI 目的地やホテルを検索します。
- 左のナビゲーションバーで、
Authentication
。 - クライアントIDとクライアントシークレットを入力し、
Get TOKEN
ボタン。 - 資格情報が有効な場合は、API キーが適用されていることがわかります。
- これで、ルックアップ エンドポイントをテストできます。
Postman でも同じことができます。
- ダウンロード 郵便配達員。
- クリック
Download OpenAPI spec
上から ルックアップAPI ページ。 - Postman にインポートします。
- 新しいコレクションとしてインポートした場合
Wink API
コレクション名の横にある水平の省略記号(3つの点)をクリックし、Edit
。 - の中で
Authorization tab
、設定します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
そのため、すべての呼び出しにトークンが含まれます。
:::tip[プロのヒント] サーバードメイン、クライアントID、クライアントシークレットを環境変数に設定することをお勧めします。これにより、ステージング環境と本番環境を簡単に切り替えることができ、作成したすべての操作を再利用できるようになります。 :::