列举指定文件的所有版本信息 - listRevision
功能介绍
列举指定文件的所有版本信息。
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/revision/listRevision
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Authorization |
是 |
String |
该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} |
|
X-User-Id |
是 |
String |
用户id，用于app鉴权 |
|
X-Date |
是 |
String |
日期，用于app鉴权 |
|
Host |
是 |
String |
地址，用于app鉴权 |
|
X-Traceid |
否 |
String |
消息日志跟踪标识（必须58位） |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
pageInfo |
否 |
PageInfo object |
分页信息 |
|
containerId |
是 |
String |
空间ID |
|
fileId |
是 |
String |
文件ID |
|
fields |
否 |
String |
当前只支持*，不传默认为* |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
revisionList |
Array of FileRevisionInfo objects |
文件版本信息列表默认按版本创建时间降序排序注：列举版本信息时FileRevisionInfo 不返回downloadUrl |
|
nextPageCursor |
String |
下一页起始游标，最后一页值为空 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
containerId |
String |
空间ID |
|
fileId |
String |
文件ID |
|
revisionId |
String |
版本ID（就是云空间返回的assetId+"."+versionId） |
|
revisionVersion |
Long |
版本号，唯一递增 |
|
keepForever |
Boolean |
是否永久保留 |
|
latestVersion |
Boolean |
是否为最新版本，对比版本id和files.get.metadata的版本id是否一致 |
|
createdAt |
Long |
创建时间，毫秒时间戳，云空间版本查询接口的createdTime |
|
createdBy |
String |
查询接口返回的attributes的createdBy |
|
updatedAt |
Long |
更新时间，毫秒时间戳，云空间版本查询接口的editedTime |
|
updatedBy |
String |
修改者ID，查询响应的lastEditor的userId可以解析出三方id |
|
name |
String |
文件名称（包含扩展名）禁止出现以下9 个非法字符：''、'/'、':'、'*'、'?'、'"'、'<'、'>'、'|' |
|
size |
Long |
文件大小单位：字节 |
|
extension |
String |
文件扩展名注：不区分大小写 |
|
fileType |
Integer |
查看接口的attributes的fileType |
|
description |
String |
描述，files.get.metadat获取description |
|
sha256 |
String |
文件内容Hash 值，十六进制字符串注：不区分大小写 |
|
downloadUrl |
String |
指定版本的文件下载地址 |
|
metadataAuditInfo |
FileAuditInfo object |
文件元信息审核信息 |
|
contentAuditInfo |
FileAuditInfo object |
文件内容审核信息注：仅普通文件返回 |
请求示例
列举指定文件的所有版本信息
POST /koodrive/ose/v1/revision/listRevision
Authorization:Bearer+10f88d07fa************44791e9ff
{
"containerId": "IAAAKIRZGifzJgncA1605122035640590977",
"fileId": "FkiferVNK5NwXck7XXBhPLIRhV1GayJPc",
"pageInfo": {
"pageSize": 100,
"pageCursor": null
}
}
响应示例
状态码：200
列举指定文件的所有版本信息
"revisionList"
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
列举指定文件的所有版本信息 |
