Help Center/ KooDrive/ API Reference(Carrier)/ API/ Related to Me/ Listing Recently Visited Files
Updated on 2026-04-16 GMT+08:00

Listing Recently Visited Files

Function

List files that you recently visited.

URI

GET /koodrive/ose/v1/access

Table 1 Query Parameters

Parameter

Mandatory

Type

Description

imageProcess

No

String

Definition:

Image operation, which can be used to specify the thumbnail size. For details, see https://support.huaweicloud.com/en-us/usermanual-obs/obs_01_0430.html.

Constraints:

N/A

Range:

N/A

Default Value:

image/resize,m_lfit,h_128,w_128

usage

No

String

Definition:

Document and video thumbnail formats.

Constraints:

The maximum length is 100.

Range:

minThumbnail, midThumbnail, largeThumbnail, and superLargeThumbnail

Default Value:

N/A

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Traceid

No

String

Definition:

Service trace ID, which contains 58 bits.

Constraints:

N/A

Range:

The value contains 58 bits.

Default Value:

N/A

Authorization

Yes

String

Definition:

Access token. Token authentication is used to call KooDrive APIs. A token indicates the permission. When an API is called, the token is added to the request header to obtain the operation permission. For details about how to obtain an access token, see the corresponding developer guide. The format is Bearer+{access_token}.

Constraints:

N/A

Range:

N/A

Default Value:

N/A

language

No

String

Definition:

Language code.

Constraints:

The value must comply with the internationalization specifications. For example, en_us indicates English (United States).

Range:

N/A

Default Value:

en-US

X-User-Id

Yes

String

Definition:

User ID on KooDrive, which is used for app authentication.

Constraints:

N/A

Range:

N/A

Default Value:

N/A

X-Date

Yes

String

Definition:

Date, which is used for app authentication. The format is yyyyMMdd'T'HHmmss'Z'.

Constraints:

The value must be within 15 minutes from the current time and cannot be later than the current time.

Range:

N/A

Default Value:

N/A

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

code

String

Response code.

msg

String

Response information.

list

Array of RecentlyAccess objects

List of recently visited files.

Table 4 RecentlyAccess

Parameter

Type

Description

operateTime

String

Operation time.

operateType

Integer

Operation type.

  • 1: view.

  • 3: share.

  • 4: copy and dump.

  • 5: create (whitelist).

  • 6: dump the shared files that are received (whitelist).

  • 7: rename (whitelist).

  • 8: move (whitelist).

  • 10: restore (whitelist).

file

AccessiFileInfo object

Basic file information.

status

Integer

Status. 1: The file has been deleted. 2: The space has expired (the space has been disabled or deleted or you do not have the space permission).

Table 5 AccessiFileInfo

Parameter

Type

Description

id

String

File ID.

containerId

String

Space ID.

containerName

String

Personal space: null department space: department name

containerType

Integer

0: department space 1: personal space

teamId

String

Personal space: null department space: department ID

name

String

File name.

collaboratorId

String

Co-author ID.

collaborator

String

Co-author name.

collaborateTime

String

Collaboration time.

collaborateType

String

Collaboration type. 2: editing; 3: sharing; 4: saving to the individual space.

fileType

String

File type. /**

* Folder

/ FOLDER = "10", /*

* Image

/ PICTURE = "15", /*

* Video

/ VIDEO = "20", /*

* Word file

/ WORD = "26", /*

* Excel file

/ EXCEL = "27", /*

* PowerPoint file

/ PPT = "28", /*

* Audio

/ AUDIO = "30", /*

* Compressed file

/ ARCHIVE = "35", /*

* Application

/ APPLICATION = "40", /*

* Other

*/

OTHER = "45",

fileSuffix

String

File name extension.

mimeType

String

File type.

downLoadLinks

Array of DownloadLink objects

Required by the image type (when fileType is set to 15).

favorite

Boolean

true: The file is added to favorites. false: The file is not added to favorites.

capabilities

Capabilities object

Permission template.

Table 7 Capabilities

Parameter

Type

Description

addChildNodePermission

Boolean

Whether the user can add sub-directories or sub-files.

writerHasChangeCopyPermission

Boolean

Whether the write permission is required for change and replication.

commentPermission

Boolean

Whether comments can be made.

copyPermission

Boolean

Whether the user can copy files.

deletePermission

Boolean

Whether the user can delete files.

downloadPermission

Boolean

Whether the use can download content.

editPermission

Boolean

Whether the user can edit files.

listChildNodePermission

Boolean

Whether the user can list sub-directories or sub-files.

editContentPermission

Boolean

Whether the content can be modified.

readHistoryVersionPermission

Boolean

Whether a backup can be read.

removeChildNodePermission

Boolean

Whether the user can move sub-directories.

renameFilePermission

Boolean

Whether the user can rename files.

shareFilePermission

Boolean

Whether the user can share files.

recyclePermission

Boolean

Whether the file can be moved to the recycle bin.

unrecyclePermission

Boolean

Whether moving a sub-file to the recycle bin can be withdrawn.

Example Requests

GET /koodrive/ose/v1/access

Example Responses

Status code: 200

OK

{
  "code" : "string",
  "msg" : "string",
  "list" : [ {
    "operateTime" : "2024-06-03T02:26:45.897Z",
    "operType" : 0,
    "file" : {
      "id" : "string",
      "containerId" : "string",
      "name" : "string",
      "collaboratorId" : "string",
      "collaborator" : "string",
      "collaborateTime" : "2024-06-03T02:26:45.897Z",
      "collaborateType" : "string",
      "fileType" : "string",
      "owner" : "string",
      "containerName" : "string",
      "containerType" : 0,
      "favorite" : true,
      "teamId" : "string"
    },
    "status" : 0
  } ]
}

Status Codes

Status Code

Description

200

OK