アプリケーション
アプリケーションは開発者としてWinkのすべての機能にアクセスできます。すべてのデータにアクセスできるだけでなく、Winkの機能を拡張することも可能です。
WinkのOAuth2サーバーを使って、GoogleやFacebookのようにあなたの旅行サイトを認証することもできます。
これにより、Winkの機能をあなた自身のウェブサイトやアプリケーションに拡張できます。
- Accountsから操作したいアカウントを選択します。
- アカウントカードの下部にある
Actionsをクリックし、Manage accountを選択します。 - 次のページで
Applicationsタブをクリックします。 - このセクションにすべてのアプリケーションが一覧表示されます。
- 既存のものをローテーションまたは削除するか、新しいものを作成します。
アプリの作成
Section titled “アプリの作成”作成済みのアプリのsecret keyにはアクセスできないため、自分で作成する必要があります。
プロパティや会社を設定しなくてもここでアプリケーションを作成できます — 特定のアカウントに紐づいていません。
クライアントタイプ
Section titled “クライアントタイプ”アプリケーションを作成するときに、認証方法を決定するクライアントタイプを選択します。
これは後から変更できません — 別のタイプが必要な場合は新しいアプリケーションを作成してください。
- Webアプリケーション — クライアントシークレットを安全に保持できるサーバーレンダリングアプリ(認可コードフロー)。
- シングルページアプリ(SPA) — バックエンドを持たないブラウザアプリ。PKCEを使用し、クライアントシークレットは不要。
- モバイルアプリ — ネイティブのiOS/Androidアプリ。PKCEを使用し、リフレッシュトークンはローテーションされます。
- マシン間通信 — 自身として動作するバックエンドサービス(クライアントクレデンシャル)。ユーザーサインインなし。
アプリケーション作成の手順は以下の通りです:
- アプリページで
Create new applicationボタンをクリックします。 - 名前 アプリに名前を付けます。例: Cool App
- クライアントタイプ アプリの認証方法に合ったタイプを選択します — 上記のクライアントタイプを参照してください。
- リダイレクトURI 少なくとも1つのリダイレクトURIが必要です。認証成功後のリダイレクトドメインの検証に使われます。マシン間通信アプリでは使用しません。例: https://www.cool-site.com
- ログアウト後リダイレクトURI (任意) ログアウト後にユーザーをリダイレクトするURL。空欄の場合は上記のリダイレクトURIが再利用されます。
- スコープ このアプリケーションがあなたの代わりにアクセスできる範囲を選択します — 下記のスコープの選択を参照してください。
Create applicationボタンをクリックして続行します。
アプリケーション一覧にリダイレクトされ、新しいクライアントIDとクライアントシークレットが一度だけ表示されるダイアログが表示されます。
シークレットは今すぐコピーして安全な場所に保存してください — 再表示されることはなく、後から取得する方法はありません(ローテーションのみ可能です)。
スコープの選択
Section titled “スコープの選択”すべてのアプリケーションは常に**サインイン(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 “クレデンシャルのローテーション”クライアントシークレットが漏洩した可能性がある場合や、新しいクレデンシャルに更新したい場合は、アプリを再作成する代わりにローテーションしてください:
- アプリ一覧から対象のアプリを見つけて
Rotateをクリックします。 - ダイアログで確認すると、現在のクライアントIDとシークレットは即座に無効になります。
- 閉じる前に一度だけ表示される新しいクライアントIDとシークレットをコピーします。
ローテーションしてもアプリ名、クライアントタイプ、リダイレクトURI、スコープはそのままで、クレデンシャルのみが変更されます。
アプリの削除
Section titled “アプリの削除”アプリが不要になった場合は削除できます。これは永久的な操作で、クレデンシャルは即座に無効化され、復元できません。
- アプリ一覧から対象のアプリを見つけて
Deleteをクリックします。 - ダイアログで確認し、アプリケーションを完全に削除します。
