コンテンツにスキップ

アプリケーション

アプリケーションは開発者としてWinkのすべての機能にアクセスできます。すべてのデータにアクセスできるだけでなく、Winkの機能を拡張することも可能です。
WinkのOAuth2サーバーを使って、GoogleやFacebookのようにあなたの旅行サイトを認証することもできます。
これにより、Winkの機能をあなた自身のウェブサイトやアプリケーションに拡張できます。

Sample application
サンプルアプリケーションのエントリー
  1. Accountsから操作したいアカウントを選択します。
  2. アカウントカードの下部にあるActionsをクリックし、Manage accountを選択します。
  3. 次のページでApplicationsタブをクリックします。
  4. このセクションにすべてのアプリケーションが一覧表示されます。
  5. 既存のものをローテーションまたは削除するか、新しいものを作成します。

作成済みのアプリのsecret keyにはアクセスできないため、自分で作成する必要があります。
プロパティや会社を設定しなくてもここでアプリケーションを作成できます — 特定のアカウントに紐づいていません。

アプリケーションを作成するときに、認証方法を決定するクライアントタイプを選択します。
これは後から変更できません — 別のタイプが必要な場合は新しいアプリケーションを作成してください。

  • Webアプリケーション — クライアントシークレットを安全に保持できるサーバーレンダリングアプリ(認可コードフロー)。
  • シングルページアプリ(SPA) — バックエンドを持たないブラウザアプリ。PKCEを使用し、クライアントシークレットは不要。
  • モバイルアプリ — ネイティブのiOS/Androidアプリ。PKCEを使用し、リフレッシュトークンはローテーションされます。
  • マシン間通信 — 自身として動作するバックエンドサービス(クライアントクレデンシャル)。ユーザーサインインなし。

アプリケーション作成の手順は以下の通りです:

  1. アプリページでCreate new applicationボタンをクリックします。
  2. 名前 アプリに名前を付けます。例: Cool App
  3. クライアントタイプ アプリの認証方法に合ったタイプを選択します — 上記のクライアントタイプを参照してください。
  4. リダイレクトURI 少なくとも1つのリダイレクトURIが必要です。認証成功後のリダイレクトドメインの検証に使われます。マシン間通信アプリでは使用しません。例: https://www.cool-site.com
  5. ログアウト後リダイレクトURI (任意) ログアウト後にユーザーをリダイレクトするURL。空欄の場合は上記のリダイレクトURIが再利用されます。
  6. スコープ このアプリケーションがあなたの代わりにアクセスできる範囲を選択します — 下記のスコープの選択を参照してください。
  7. Create applicationボタンをクリックして続行します。

アプリケーション一覧にリダイレクトされ、新しいクライアントIDとクライアントシークレットが一度だけ表示されるダイアログが表示されます。
シークレットは今すぐコピーして安全な場所に保存してください — 再表示されることはなく、後から取得する方法はありません(ローテーションのみ可能です)。

すべてのアプリケーションは常に**サインイン(OpenID Connect)**スコープ(openid、profile、email、offline_access)を持っています — これらはユーザーの本人確認とサインイン状態の維持に使われるため、チェック済みかつロックされており、選択できません。

その他はすべてオプトインです。残りのスコープはScopesに記載された機能別セクション(アカウント、在庫&料金、予約、マーケティング&プロモーション、物件コンテンツ、分析&レポート、チャネルマネージャー連携、決済、会計&元帳)に分類されており、それぞれが何を可能にするかの説明があります。
リスト上部のAll / Noneリンクで、すべてのオプションスコープを一括選択または解除できます。

このフォームで意図的に提供されていないスコープファミリーが2つあります:

  • mcp.* — Model Context ProtocolトランスポートへのAIエージェントアクセス。アプリケーションを作成するものではありません。Claude、ChatGPT、CodexなどのAIクライアントが自身を登録し、MCP同意画面を通じてこれらのスコープを要求します。マシン間通信アプリには付与されません。MCPは常にサインインユーザーの代理として動作するためです。
  • 管理者レベルのスコープ(administrator.*) — アプリケーション単位では付与されないプラットフォームレベルのアクセス権。

アプリ作成後、このタブと同意済みアプリで付与されたスコープがセクション別に表示され(例:「予約: booking.read」)、アプリを開かずに何ができるか一目で確認できます。

クレデンシャルのローテーション

Section titled “クレデンシャルのローテーション”

クライアントシークレットが漏洩した可能性がある場合や、新しいクレデンシャルに更新したい場合は、アプリを再作成する代わりにローテーションしてください:

  1. アプリ一覧から対象のアプリを見つけてRotateをクリックします。
  2. ダイアログで確認すると、現在のクライアントIDとシークレットは即座に無効になります。
  3. 閉じる前に一度だけ表示される新しいクライアントIDとシークレットをコピーします。

ローテーションしてもアプリ名、クライアントタイプ、リダイレクトURI、スコープはそのままで、クレデンシャルのみが変更されます。

アプリが不要になった場合は削除できます。これは永久的な操作で、クレデンシャルは即座に無効化され、復元できません。

  1. アプリ一覧から対象のアプリを見つけてDeleteをクリックします。
  2. ダイアログで確認し、アプリケーションを完全に削除します。