获取文件版本列表

适用版本>=v7.0.2311a.20231109

接口说明：获取文件历史版本列表

请求说明

请求地址	配置域名+/graph+/v7/drives/{drive_id}/files/{file_id}/versions
请求方法	GET
签名方式	WPS-4签名/WPS-4-GM签名（配置域名+/graph不参与签名）
权限要求	更新文件（用户授权） kso.file.write

请求头（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_id	string	是	驱动盘id，<= 1024 characters
file_id	string	是	文件id，<= 1024 characters

查询参数（Query）

名称	参数类型	是否必填	说明
page_size	int	是	分页大小，最大值：1024
page_token	string	否	分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回next_page_token作为新的page_token，下次遍历可采用该page_token获取查询结果
with_comment	bool	否	是否查询版本备注
with_ext_attrs	bool	否	是否查询版本扩展属性

响应体（Response）

名称	类型	说明
data	object	获取文件版本信息返回
∟ items	object	<= 1024 items
∟ ∟ comment	string	版本备注，<= 1024 characters
∟ ∟ created_by	object	创建者信息
∟ ∟ ∟ avatar	string	创建者头像，<= 1024 characters
∟ ∟ ∟ company_id	string	创建者企业id，<= 1024 characters
∟ ∟ ∟ id	string	创建者id，<= 1024 characters
∟ ∟ ∟ name	string	创建者名称，<= 1024 characters
∟ ∟ ∟ type	string	创建者身份类型，user：用户
∟ ∟ ctime	int	创建时间，时间戳，单位为秒
∟ ∟ ext_attrs	object	版本扩展属性
∟ ∟ file_id	string	文件id
∟ ∟ hash	object	哈希值
∟ ∟ ∟ sum	string	哈希结果
∟ ∟ ∟ type	string	哈希类型，固定为s2s
∟ ∟ id	int	id
∟ ∟ modified_by	object	修改者信息
∟ ∟ ∟ avatar	string	修改者头像，<= 1024 characters
∟ ∟ ∟ company_id	string	修改者企业id，<= 1024 characters
∟ ∟ ∟ id	string	修改者id，<= 1024 characters
∟ ∟ ∟ name	string	修改者名称，<= 1024 characters
∟ ∟ ∟ type	string	修改者身份类型，user：用户
∟ ∟ mtime	string	修改时间，时间戳，单位为秒
∟ ∟ size	int64	文件大小
∟ ∟ version	int64	文件版本
∟ next_page_token	string	下一页分页标记，<= 1024 characters；当查询结果中next_page_token为空或无该返回值时，代表无下一页
code	integer	错误码，参照《错误码说明》
msg	string	状态信息
detail	string	详细信息

响应体示例

{
  "data": {
    "items": [
      {
        "comment": "string",
        "created_by": {
          "avatar": "string",
          "company_id": "string",
          "id": "string",
          "name": "string",
          "type": "user"
        }，
        "ctime": 0,
        "ext_attrs": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "file_id": "string",
        "hash": {
          "sum": "string",
          "type": "s2s"
        }，
        "id": "string",
        "modified_by": {
          "avatar": "string",
          "company_id": "string",
          "id": "string",
          "name": "string",
          "type": "user"
        }，
        "mtime": 0,
        "size": 0,
        "version": 0
      }
    ],
    "next_page_token": "string"
  }，
  "code": 0,
  "detail": "string",
  "msg": "string"
}