获取文件操作记录 - getFileOperations
功能介绍
获取一个文件的操作记录列表
授权信息
当前API调用无需身份策略权限。
URI
GET /koodrive/ose/v1/files/{fileId}/operations
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| fileId | 是 | String | 文件ID |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| pageCursor | 否 | String | 参数解释: 当前页游标 约束限制: 从前一页响应的nextCursor获取,第一页不需要传游标 取值范围: 不涉及 默认值: 不涉及 |
| pageSize | 否 | Integer | 参数解释: 每页返回的个数 约束限制: 在到达最后的列表之前,实际有可能返回部分或者空结果 取值范围: 1-100 默认值: 100 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | String | 参数解释: 该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| X-User-Id | 是 | String | 参数解释: KooDrive侧用户id,用于app鉴权 约束限制: 不涉及 取值范围: 不涉及 默认值: 不涉及 |
| X-Date | 是 | String | 参数解释: 日期,用于app鉴权,格式为yyyyMMdd‘T’HHmmss‘Z’ 约束限制: 距当前时间15分钟以内,不能晚于当前时间 取值范围: 不涉及 默认值: 不涉及 |
| X-Traceid | 否 | String | 参数解释: 业务跟踪id(必须58位) 约束限制: 不涉及 取值范围: 长度为58位 默认值: 不涉及 |
| language | 否 | String | 参数解释: 国际化语言标识 约束限制: 符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语 取值范围: 符合i18n规范 默认取值: en-US |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | Integer | 响应码 |
| msg | String | 响应信息 |
| operations | Array of FileOperationLog objects | 文件操作列表 |
| nextCursor | String | 下一页游标 |
请求示例
获取文件FqNZrzGgSKHkfGmwjf7dLgLlGkwrLEU35的操作记录列表
POST /koodrive/ose/v1/files/FqNZrzGgSKHkfGmwjf7dLgLlGkwrLEU35/operations?pageCursor=MTg5MzQzMjI2NDE2ODI4NDgwMDsyMDI2LTAyLTAxVDAwOjAwOjAwWg Authorization:Bearer+10f88*********4791e9ff
响应示例
状态码:200
文件操作记录
{
"code" : 0,
"msg" : "SUCCESS",
"operations" : [ {
"id" : "1893432264168284800",
"operator" : "userId",
"operateType" : 1,
"operateTime" : "2026-02-27 17:55:43"
} ],
"nextCursor" : "nextCursor_9a9d3dc614e1"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 文件操作记录 |