ファイルに対するタスクのリストを取得

get
https://api.box.com/2.0
/files/:file_id/tasks

そのファイルに関連するすべてのタスクのリストを取得します。このエンドポイントはページ割りをサポートしていません。

リクエスト

application/json

パスパラメータ

stringパス内必須
12345

ファイルを表す一意の識別子。

ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123の場合、file_id123です。

レスポンス

application/jsonTasks

ファイルに関連するタスクのリストを返します。

このファイルに関連するタスクが存在しない場合は、空のコレクションが返されます。

ファイルが見つからない場合、またはユーザーがファイルにアクセスできない場合はエラーを返します。

file_idが指定されていない場合はエラーを返します。

IDが0のファイルのタスクを取得しようとした場合はエラーを返します。

予期しないクライアントエラー。

get
ファイルに対するタスクのリストを取得
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

cURL
curl -X GET https://api.box.com/2.0/files/12345/tasks \
     -H 'Authorization: Bearer <ACCESS_TOKEN>'
.NET
BoxCollection<BoxTask> tasks = await client.FilesManager.FilesManager.GetFileTasks("11111");
Java
BoxFile file = new BoxFile(api, "id");
List<BoxTask.Info> tasks = file.getTasks();
Python
tasks = client.file(file_id='11111').get_tasks()
for task in tasks:
    print('Task ID is {0} and the type is {1}'.format(task.id, task.type))
Node
client.files.getTasks('11111')
	.then(tasks => {
		/* tasks -> {
			total_count: 1,
			entries: 
			[ { type: 'task',
				id: '22222',
				item: 
					{ type: 'file',
					id: '11111',
					sequence_id: '6',
					etag: '6',
					sha1: '81cc829fb8366fcfc108aa6c5a9bde01a6a10c16',
					name: 'box-logo.png' },
				due_at: null } ] }
		*/
	});
iOS
client.files.listTasks(forFile: "11111") { results in
    switch results {
    case let .success(iterator):
        for i in 1 ... 10 {
            iterator.next { result in
                switch result {
                case let .success(item):
                    print("Task messsage: \(task.message)")
                case let .failure(error):
                    print(error)
                }
            }
        }
    case let .failure(error):
        print(error)
    }
}