box.com アプリの Webhook をセットアップしようとしたときに、authorization_code を渡すオプションがないことに気付きました。これがないと、コードは box.com からファイルの更新されたコンテンツを取得できません。
簡略化されたワークフローは次のとおりです。
- ユーザーは、box.com アカウントでファイルの [その他のアクション] を選択し、[XYZ に送信] をクリックします。
- これにより、ユーザーを webapp に送信するポップアップ ウィンドウが表示され、ファイル ID と認証コードが渡されます。
- 私たちの webapp は認証コードを使用してファイルをダウンロードし、後で参照できるようにリソースに box.com ファイル ID をタグ付けして保存します。
- ユーザーは、box.com で「新しいバージョンのアップロード」を選択し、新しいファイルをアップロードします。
- Webhook がトリガーされ、ファイル ID を渡す Web アプリケーションへの GET が発行されます。
- Web アプリケーションは、ダウンロードしたファイルを ID で検索し、新しいバージョンのダウンロードを試みます。これを行うには認証コードが必要です。(元の認証コードの有効期限が切れて久しい。)