アプリケーション
アプリケーションは、開発者としてWinkのすべての機能にアクセスするためのものです。すべてのデータにアクセスできるだけでなく、Winkの機能を拡張することも可能です。
WinkのOAuth2サーバーを使って、GoogleやFacebookのようにあなたの旅行サイトを認証することも選べます。
これにより、Winkの機能をあなた自身のウェブサイトやアプリケーションに拡張できます。
- Accountsから操作したいアカウントを選択します。
- アカウントカードの下部にある
Actionsをクリックし、Manage accountを選択します。 - 次のページで
Applicationsタブをクリックします。 - このセクションにすべてのアプリケーションが一覧表示されます。
- 既存のアプリを編集するか、新しいアプリを作成します。
アプリの作成
Section titled “アプリの作成”作成済みのアプリのsecret keyにはアクセスできないため、自分で新しいアプリを作成する必要があります。
クライアントタイプ
Section titled “クライアントタイプ”アプリケーションを作成するときは、認証方法を決定するクライアントタイプを選択します:
- SPA(シングルページアプリケーション)— OAuth2の認可コードフロー(PKCE付き)を使うブラウザベースのフロントエンドアプリ向け。ウェブアプリで最も一般的なタイプです。
- MACHINE_2_MACHINE — クライアント認証情報を使って直接認証するサーバー間連携向け。ユーザーがいない状態でバックエンドサービスがWink APIを呼び出す場合に使用します。
アプリケーション作成の手順は以下の通りです:
- アプリページで
Create new applicationボタンをクリックします。 - 名前 アプリに名前を付けます。例: Cool App
- クライアントタイプ ウェブアプリなら
SPA、サーバー連携ならMACHINE_2_MACHINEを選択します。 - エンティティ名 既存のアカウントのいずれかにアプリを紐づけます。例: Cool Account
- リダイレクトURI 少なくとも1つのリダイレクトURIが必要です。認証成功後のリダイレクトドメインの検証に使われます。例: https://www.cool-site.com
- ログアウト後リダイレクトURI (任意) ログアウト後にユーザーをリダイレクトするURL。セッション終了後に既知のページに誘導できます。
Saveボタンをクリックして続行します。
アプリ一覧にリダイレクトされます。新しいアプリがリストに表示され、アプリのシークレットキーはこの一度だけ表示されます。必ずコピーして安全な場所に保存してください。
アプリの更新
Section titled “アプリの更新”リダイレクトURIを変更したり、URIを追加・削除したい場合はアプリを更新する必要があります。
既存のアプリを更新するには、以下の手順を行います:
- 更新したいアプリの
Actionsリンクをクリックします。 Actionsの下にあるUpdateボタンをクリックします。- アプリの内容を変更します。
Saveボタンをクリックして続行します。
アプリ一覧にリダイレクトされます。
アプリの削除
Section titled “アプリの削除”不要になったアプリは削除できます。
アプリを削除するには、以下の手順を行います:
- 削除したいアプリの
Actionsリンクをクリックします。 Actionsの下にあるRemoveボタンをクリックします。- 削除確認のため
OKボタンをクリックします。
アプリ一覧にリダイレクトされます。