Skip to content

获取文件版本列表

适用版本>=v7.0.2404b.20240425

接口说明:获取文件版本列表

请求说明

请求地址配置域名+/graph+/v7/drives/{drive_id}/files/{file_id}/versions
请求方法GET
签名方式WPS-4签名/WPS-4-GM签名(配置域名+/graph不参与签名)
权限要求应用身份管理文档(应用授权) kso.appfile.readwrite

请求头(Header)

名称是否必填说明
Content-Type固定为: application/json
Wps-Docs-Date取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization计算方法参考签名说明
Authorization授权凭证,格式为: Bearer {access_token}

路径参数(Path)

名称类型是否必填说明
drive_idstring驱动盘id,长度不超过1024位
file_idstring文件id,长度不超过1024位

查询参数(Query)

名称类型是否必填说明
page_sizeinteger分页大小,[1,1024]
page_tokenstring分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回next_page_token作为新的page_token,下次遍历可采用该page_token获取查询结果
page_offsetstring查询偏移量,存量版本兼容
with_ext_attrsboolean是否查询版本扩展属性
with_commentboolean是否查询版本备注(应用文档:忽略此参数)

响应体(Response)

名称类型说明
dataobject
itemsobject[]应用文档文件版本信息返回
commentstring版本备注,长度不超过1024位
created_byobject创建者信息
idstring身份ID
typestringEnum: "user" "sp",身份类型
ctimeinteger创建时间,时间戳,单位为秒
file_idstring文件id
idstring序号
modified_byobject修改者信息
idstring身份ID
typestringEnum: "user" "sp",身份类型
mtimeinteger修改时间,时间戳,单位为秒
sizeinteger文件大小
versioninteger文件版本号
next_page_tokenstring下一页分页标记,<= 1024 characters;当查询结果中next_page_token为空或无该返回值时,代表无下一页
codeinteger错误码,参照《错误码说明》
msgstring状态信息
detailstring详细信息

响应体示例

{
  "data": {
    "items": [
      {
        "comment": "string",
        "created_by": {
          "id": "string",
          "type": "sp"
        },
        "ctime": 0,
        "file_id": "string",
        "id": "string",
        "modified_by": {
          "id": "string",
          "type": "sp"
        },
        "mtime": 0,
        "size": 0,
        "version": 0
      }
    ],
    "next_page_token": "string"
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}