tencent cloud

Smart Media Hosting

Product Introduction
Product Overview
Feature Description
Product Strengths
Use Cases
Basic Concept
Purchase Guide
Quick Start
Create Media Library
Initiate request
Service Level API Document
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
Business Level API Document
Introduction
Access Token Operation API
Tenant Space Operation API
File Operation API
Directory or Album Operation API
Recycle Bin Operation API
Quota Operation API
Query Task Operation API
Search Operation API
Historical Version Operations API
Directory and File Batch Operation API
Collection Operation API
Error Codes
SDK Documentation
Android SDK
iOS SDK
HarmonyOS SDK
FAQs
Enterprise Network Disk
Product Introduction
Purchase Guide
Quick Start
FAQs
Service Level Agreement
Glossary

View Recently Used File List

PDF
Modo Foco
Tamanho da Fonte
Última atualização: 2026-01-07 14:15:08

Description

View recently used file list.
Note:
To use this feature, you need to enable the allowlist. If it is required, please contact us.
Required permissions: admin, space_admin. For details about permissions, see the Generate Access Token API.
Only file preview and file editing operations are recorded in the recently used file list.
The returned file list is sorted in reverse chronological order by operation time.

Request

Request Example

POST /api/v1/recent/{LibraryId}/{SpaceId}/recently-used-file?access_token={AccessToken}
Request parameters.
Description
Type
Required or Not
LibraryId
Media Library ID, obtained after creating a media library in the media hosting console. See Create Media Library
String
Yes
SpaceId
Space ID. If the media library is in single-tenant mode, this parameter is fixed as hyphen (`-`); if the media library is in multi-tenant mode, you must specify this parameter. See Create Tenant Space
String
No
AccessToken
Access token. For Public Read Media Library or tenant space, this parameter is not specified. Otherwise, you must specify this parameter. See Generate Access Token
String
Yes

Request Body

{
"marker":"NKJWNDkndkwjqndkqnwdkjnqwd=",
"limit":10,
"filterActionBy": "preview",
"type": [".doc", ".csv"],
"withPath": true
}

Request body field description:
Request parameters.
Description
Type
Required or Not
marker
Identifier for sequential page listing, default to first page if not passed
String
No
limit
Number of locally listed projects for sequential pagination, default to 20 if not passed
Int
No
filterActionBy
filterActionBy: filter operation method, return all if not passed, preview only returns preview operation, modify returns edit operation
String
No
type
Filter file type, currently supported types include:
Search all files. Defaults to all when type is not specified or empty.
Search all documents. Document types: ['pdf', 'powerpoint', 'excel', 'word', 'text']
pdf: Search PDF documents only. File extension: .pdf
powerpoint: Search presentations only, such as .ppt, .pptx, .pot, .potx.
excel: Search spreadsheet files only, such as .xls, .xlsx, .ett, .xltx, .csv.
word: Search documents only, such as .doc, .docx, .dot, .wps, .wpt.
text: Search text-only files, such as .txt, .asp, .htm.
doc, xls, or ppt: Search Word, Excel, or Powerpoint documents only, with file extensions .doc(x), .xls(x), or .ppt(x).
array of strings: can be an array of document suffixes, such as ['.ppt', '.doc', '.excel']; or an array of filter types, such as ['pdf', 'powerpoint', 'word']
String Array
/String
No
withPath
whether to return the file path, default to false
Boolean
No

Response

Response code

View recently used file list successfully, back HTTP 200 OK.

Response Body

application/json
Response body example:
{
"nextMarker": "xxx",
"contents": [
{
"name": "document.doc",
"spaceId": "spacexxx",
"inode": "xxxxx",
"size": "1111",
"actionType": "preview",
"operationTime": "2022-04-25T07:53:18.000Z",
"creationTime": "2022-04-23T07:53:18.000Z",
"crc64": "xxxxxx",
"path": ["folder1", "document.doc"]
}
]
}
Response body field description:
Response Parameters
Description
Type
nextMarker
Identifier for sequential page listing, return this field only when not the last page
String
contents
Recently used file list content
Array
The contents include the following parameters:
Response Parameters
Description
Type
name
File Name
String
spaceId
space ID
String
inode
File ID
String
size
File size, in string format to avoid digit precision issues
String
actionType
Operation type when adding to the recently used list, valid values are preview or modify
String
operationTime
ISO 8601 formatted date and time string, indicating the time when added to the recently used file list, such as 2020-10-14T10:17:57.953Z
String
creationTime
ISO 8601 formatted date and time string, indicating the file upload time, such as 2020-10-14T10:17:57.953Z
String
crc64
File CRC64-ECMA182 check value, in string format to avoid digit precision issues
String
path
File path, returned only when withPath is true
String Array

Error Codes

This request operation has no special error messages. For common error messages, see Error Codes.

Ajuda e Suporte

Esta página foi útil?

comentários