Box Developerドキュメント

スキルのWebhookペイロード

このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 **Box APIのバージョン管理**を参照してください。

スキルのinvocation_urlに送信されるBoxスキルのペイロード。

string
fd1d2e53-35f5-41fb-9c25-4ba326daf2f9_341016304

呼び出しリクエストの一意の識別子。

string
skill_invocation

値は常にskill_invocationになります。

次の値に固定: skill_invocation

string (date-time)
2012-12-12T10:53:43-08:00

この呼び出しが作成された日時。

object

この呼び出しをトリガーする対象になった企業。

11446498

この会社の一意の識別子。

enterprise

値は常にenterpriseになります。

次の値に固定: enterprise

Acme Inc.

企業の名前。

Event object

この呼び出しをトリガーしたイベント。

object

この呼び出しをトリガーしたスキル。

string
11446498

このスキルの一意の識別子。

string
skill

値は常にskillになります。

次の値に固定: skill

hxel2s12wd2h9r8ne103c4gjbqefofih

アプリケーションのクライアントID。

string
Hello World Skill

スキルの名前。

File / Folder object

呼び出しがトリガーされる原因となった項目。

object

このイベントの詳細のステータス。

Example

追加のステータス情報。

400

エラーコード情報 (エラーが発生した場合)。

Example

ステータス情報。

invoked

このイベントの状態。

  • invoked - ファイルへのスキルの適用を開始するためにイベント詳細を使用してスキルをトリガーしました。
  • processing - 現在処理中です。
  • success - 処理が正常に完了しました。
  • transient_failure - 再試行可能な問題が発生しました。
  • permanent_failure - 再試行しても解決できない永続的な問題が発生しました。

次の値のいずれか1つ: invoked,processing,success,transient_failure,permanent_failure

object

この項目の読み取り専用および読み取り/書き込みアクセス権限トークン。

object

アクセストークンの基本情報。

string (token)
c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ

リクエストされたアクセストークン。

integer (int64)
3600

このトークンが期限切れになるまでの秒数。

[{"scope":"gcm"}, {"scope":"item_upload","object_id":933941692081,"object_type":"file"}, {"scope":"manage_skill_invocations"}]

このアクセストークンで許可される権限を返します。これにより、リソース (ファイルやフォルダなど) のリストと、各リソースで許可されるスコープが提供されます。

bearer

返されるアクセストークンのタイプ。

次の値に固定: bearer

アクセストークンの基本情報。

string (token)
c3FIOG9vSGV4VHo4QzAyg5T1JvNnJoZ3ExaVNyQWw6WjRsanRKZG5lQk9qUE1BVQ

リクエストされたアクセストークン。

integer (int64)
3600

このトークンが期限切れになるまでの秒数。

[{"scope":"gcm"}, {"scope":"item_upload","object_id":933941692081,"object_type":"file"}, {"scope":"manage_skill_invocations"}]

このアクセストークンで許可される権限を返します。これにより、リソース (ファイルやフォルダなど) のリストと、各リソースで許可されるスコープが提供されます。

bearer

返されるアクセストークンのタイプ。

次の値に固定: bearer

string
FILE_CONTENT

呼び出しをトリガーしたアクション。