获取指定文件、指定版本 ID 的版本信息 - getRevision
功能介绍
获取指定文件、指定版本 ID 的版本信息
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/revision/getRevision
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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位） |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
containerId |
是 |
String |
空间ID |
|
fileId |
是 |
String |
文件ID |
|
revisionId |
是 |
String |
文件的assetId+versionId |
|
urlType |
否 |
Integer |
下载地址类型缺省默认返回外网访问地址。详见枚举类型UrlType（1外网地址；2内网地址） |
|
fields |
否 |
String |
当前只支持*，不传默认为* |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
文件内容审核信息注：仅普通文件返回 |
请求示例
获取指定文件、指定版本 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"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
获取指定文件、指定版本 ID 的版本信息响应 |
