获取指定文件、指定版本 ID 的版本信息 - getRevision

功能介绍

获取指定文件、指定版本 ID 的版本信息

授权信息

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

URI

POST /koodrive/ose/v1/revision/getRevision

请求参数

表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参数
参数	是否必选	参数类型	描述
containerId	是	String	空间ID
fileId	是	String	文件ID
revisionId	是	String	文件的assetId+versionId
urlType	否	Integer	下载地址类型缺省默认返回外网访问地址。详见枚举类型UrlType（1外网地址；2内网地址）
fields	否	String	当前只支持，不传默认为

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
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	文件内容审核信息注：仅普通文件返回

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

请求示例

获取指定文件、指定版本 ID 的版本信息

POST /koodrive/ose/v1/revision/getRevision

Authorization:Bearer+10f88d07fa************44791e9ff
{
    "containerId": "IAAFotBZGfP8nAncA1605108881422443136",
    "fileId": "Fk_LAN-LIgbxjFdH_YvJKoYW0vMjFyva8",
    "revisionId": "1605664519244256128.1605664519244256129"
}

响应示例

状态码：200

获取指定文件、指定版本 ID 的版本信息响应

{
  "containerId" : "IAAFotBZGfP8nAncA1605108881422443136",
  "fileId" : "Fk_LAN-LIgbxjFdH_YvJKoYW0vMjFyva8",
  "revisionId" : "1605664519244256128.1605664519244256129",
  "revisionVersion" : 512,
  "keepForever" : false,
  "latestVersion" : true,
  "createdAt" : 1737682127312,
  "createdBy" : "ee33a28d0f454801b4532233258822e4",
  "updatedAt" : 1737682130017,
  "updatedBy" : "ZWUzM2EyOGQwZjQ1NDgwMWI0NTMyMjMzMjU4ODIyZTQtZWUzM2EyOGQwZjQ1NDgwMWI0NTMyMjMzMjU4ODIyZTQ",
  "name" : "ee33a28d0f454801b4532233258822e4",
  "size" : 1872637,
  "extension" : "AgAALVN-3Z5V2NASBMxH6L0DsLh7cKjg.jpeg",
  "fileType" : 15,
  "sha256" : "fb426b18ebc6ed393564f47371ab55e8f8e2b1336b195a877da1b7e7218a78fe",
  "downloadUrl" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/5debce8cf8074c7",
  "code" : 0,
  "msg" : "success"
}