最近アクセスした項目のリストを取得

get
https://api.box.com/2.0
/recent_items/

過去90日間、または最大1,000項目まで遡って、ユーザーが最近アクセスした項目に関する情報を返します。

Request

Bearer [ACCESS_TOKEN]
application/json

Query Parameters

string arrayin queryoptional
id,type,name

レスポンスに含める属性のカンマ区切りリスト。このパラメータを使用すると、標準のレスポンスには通常含まれないフィールドをリクエストできます。

このパラメータを指定すると、明示的に指定しない限り標準フィールドはレスポンスに含まれず、リクエストしたフィールドのほかには、簡易版レプリゼンテーションのフィールドしか返されないことに注意してください。

integer / int64in queryoptional
10001000

返す項目の1ページあたりの最大数。

stringin queryoptional
JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii

結果が返される開始位置のマーカー。マーカーベースのページ割りを使用している場合に使用されます。

これを使用するには、usemarkertrueに設定する必要があります。

Response

最近ユーザーがアクセスした項目のリストを返します。

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

get
最近アクセスした項目のリストを取得
You can now try out some of our APIs live, right here in the documentation.
Log in

Request Example

cURL
curl -i -X GET "https://api.box.com/2.0/recent_items" \
     -H "Authorization: Bearer <ACCESS_TOKEN>"
.NET
BoxCollectionMarkerBasedV2<BoxRecentItem> recentItems = await client.RecentItemsManager
    .GetRecentItemsAsync(limit: 500);
Java
// Get the latest 100 items the user has interacted with
Iterable<BoxRecentItem> recentItems = BoxRecents.getRecentItems(api, 100);
Node
client.recentItems.get({limit: 1000})
	.then(recentItems => {
		/* recentItems -> {
			next_marker: '',
			limit: 1000,
			order: { by: 'interacted_at', direction: 'DESC' },
			entries: 
			[ { type: 'recent_item',
				interaction_type: 'item_preview',
				interacted_at: '2017-06-06T15:46:28-07:00',
				item: 
					{ type: 'file',
					id: '11111',
					file_version: 
					{ type: 'file_version',
						id: '22222',
						sha1: 'd0a8c75ba72bf923bfb0c855bbcf1e8f7cc817dd' },
					sequence_id: '0',
					etag: '0',
					sha1: 'd0a8c75ba72bf923bfb0c855bbcf1e8f7cc817dd',
					name: 'File2.txt' },
				interaction_shared_link: "https://app.box.com/s/27jtnq2g8b7bu30pivpbz6nb2ef47mfs" },
				{ type: 'recent_item',
				interaction_type: 'item_preview',
				interacted_at: '2017-06-06T15:46:27-07:00',
				item: 
					{ type: 'file',
					id: '33333',
					file_version: 
					{ type: 'file_version',
						id: '44444',
						sha1: '12a715416bc96ba3ea860480c815657d5e0809da' },
					sequence_id: '0',
					etag: '0',
					sha1: '12a715416bc96ba3ea860480c815657d5e0809da',
					name: 'Image1.png' },
				interaction_shared_link: null } ] }
		*/
	});

Response Example

{
  "entries": [
    {
      "type": "recent_item",
      "item": {
        "id": 12345,
        "etag": 1,
        "type": "file",
        "sequence_id": 3,
        "name": "Contract.pdf",
        "sha1": "85136C79CBF9FE36BB9D05D0639C70C265C18D37",
        "file_version": {
          "id": 12345,
          "type": "file_version",
          "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
        },
        "description": "Contract for Q1 renewal",
        "size": 629644,
        "path_collection": {
          "total_count": 1,
          "entries": [
            {
              "id": 12345,
              "etag": 1,
              "type": "folder",
              "sequence_id": 3,
              "name": "Contracts"
            }
          ]
        },
        "created_at": "2012-12-12T10:53:43-08:00",
        "modified_at": "2012-12-12T10:53:43-08:00",
        "trashed_at": "2012-12-12T10:53:43-08:00",
        "purged_at": "2012-12-12T10:53:43-08:00",
        "content_created_at": "2012-12-12T10:53:43-08:00",
        "content_modified_at": "2012-12-12T10:53:43-08:00",
        "created_by": {
          "id": 11446498,
          "type": "user",
          "name": "Aaron Levie",
          "login": "ceo@example.com"
        },
        "modified_by": {
          "id": 11446498,
          "type": "user",
          "name": "Aaron Levie",
          "login": "ceo@example.com"
        },
        "owned_by": {
          "id": 11446498,
          "type": "user",
          "name": "Aaron Levie",
          "login": "ceo@example.com"
        },
        "shared_link": {
          "url": "https://www.box.com/s/vspke7y05sb214wjokpk",
          "download_url": "https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg",
          "vanity_url": "https://acme.app.box.com/v/my_url/",
          "vanity_name": "my_url",
          "access": "open",
          "effective_access": "company",
          "effective_permission": "can_download",
          "unshared_at": "2018-04-13T13:53:23-07:00",
          "is_password_enabled": true,
          "permissions": {
            "can_download": true,
            "can_preview": true
          },
          "download_count": 3,
          "preview_count": 3
        },
        "parent": {
          "id": 12345,
          "etag": 1,
          "type": "folder",
          "sequence_id": 3,
          "name": "Contracts"
        },
        "item_status": "active"
      },
      "interaction_type": "item_preview",
      "interacted_at": "2018-04-13T13:53:23-07:00",
      "interaction_shared_link": "https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg"
    }
  ],
  "limit": 1000,
  "next_marker": 3000,
  "prev_marker": 1000
}