列举指定文件的所有版本信息 - listRevision

功能介绍

列举指定文件的所有版本信息。

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/revision/listRevision

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
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位）

表2 请求Body参数
参数	是否必选	参数类型	描述
pageInfo	否	PageInfo object	分页信息
containerId	是	String	空间ID
fileId	是	String	文件ID
fields	否	String	当前只支持，不传默认为

表3 PageInfo
参数	是否必选	参数类型	描述
pageSize	否	Integer	每页文件数量，默认100
pageCursor	否	String	分页起始游标

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
revisionList	Array of FileRevisionInfo objects	文件版本信息列表默认按版本创建时间降序排序注：列举版本信息时FileRevisionInfo 不返回downloadUrl
nextPageCursor	String	下一页起始游标，最后一页值为空

表5 FileRevisionInfo
参数	参数类型	描述
containerId	String	空间ID
fileId	String	文件ID
revisionId	String	版本ID（就是云空间返回的assetId+"."+versionId）
revisionVersion	Long	版本号，唯一递增
keepForever	Boolean	是否永久保留
latestVersion	Boolean	是否为最新版本，对比版本id和files.get.metadata的版本id是否一致
createReason	Integer	版本创建缘由详见枚举类型RevisionCreateReason，1 创建文件；2 历史版本恢复
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	文件内容审核信息注：仅普通文件返回

表6 FileAuditInfo
参数	参数类型	描述
auditLevel	Integer	审核级别详见枚举类型AuditLevel
auditResult	Integer	审核结果详见枚举类型AuditResult 对于文件元信息审核结果，仅支持 1、4；对于文件内容审核结果，仅支持 1、2、3。
auditDetail	String	审核结果详情注：JSON 字符串格式，仅支持存取

请求示例

列举指定文件的所有版本信息

POST /koodrive/ose/v1/revision/listRevision

Authorization:Bearer+10f88d07fa************44791e9ff
{
  "containerId": "IAAAKIRZGifzJgncA1605122035640590977",
  "fileId": "FkiferVNK5NwXck7XXBhPLIRhV1GayJPc",
    "pageInfo": {
        "pageSize": 100,
        "pageCursor": null
    }
}