获取文件版本列表

获取文件版本列表

请求说明

请求地址	https://openapi.wps.cn/v7/drives/{drive_id}/files/{file_id}/versions
请求方法	GET
签名方式	KSO-1
权限要求	查询和管理文档版本（应用授权） kso.file_version.readwrite 查询文档版本（应用授权） kso.file_version.read 查询和管理文档版本（用户授权） kso.file_version.readwrite 查询文档版本（用户授权） kso.file_version.read

请求头（Header）

Header 名称	参数类型	是否必填	说明
Content-Type	string	是	使用：application/json
X-Kso-Date	string	是	RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：Bearer {access_token}

路径参数（Path）

名称	参数类型	说明
drive_id	string	驱动盘 id
file_id	string	文件 id

查询参数（Query）

名称	参数类型	是否必填	说明
page_size	integer	是	分页大小
page_token	string	否	分页 token
with_comment	boolean	否	是否查询版本备注
with_ext_attrs	boolean	否	是否查询版本扩展属性

请求地址示例

[GET] https://openapi.wps.cn/v7/drives/{drive_id}/files/{file_id}/versions?page_size={integer}&page_token={string}&with_comment={boolean}&with_ext_attrs={boolean}

响应体

名称	参数类型	说明
code	integer	响应代码。非 0 表示失败，参照《状态码说明》
msg	string	响应信息
data	object	响应数据
∟ items	array[object]	数据集合
∟ ∟ comment	string	版本备注
∟ ∟ created_by	object	创建者
∟ ∟ ∟ avatar	string	创建者头像
∟ ∟ ∟ company_id	string	创建者企业 id
∟ ∟ ∟ id	string	创建者 id
∟ ∟ ∟ name	string	创建者名称
∟ ∟ ∟ type	string[enum]	身份类型 user：用户；sp：服务主体
∟ ∟ ctime	integer	创建时间
∟ ∟ ext_attrs	array[object]	版本扩展属性
∟ ∟ ∟ name	string	属性名
∟ ∟ ∟ value	string	属性值
∟ ∟ file_id	string	文件 id
∟ ∟ hash	object	哈希
∟ ∟ ∟ sum	string	哈希结果
∟ ∟ ∟ type	string[enum]	哈希类型 sha256；md5；sha1；s2s
∟ ∟ id	string	id
∟ ∟ modified_by	object	修改者
∟ ∟ ∟ avatar	string	修改者头像
∟ ∟ ∟ company_id	string	修改者企业 id
∟ ∟ ∟ id	string	修改者 id
∟ ∟ ∟ name	string	修改者名称
∟ ∟ ∟ type	string[enum]	身份类型 user：用户；sp：服务主体
∟ ∟ mtime	integer	修改时间
∟ ∟ size	integer	大小
∟ ∟ version	integer	版本
∟ next_page_token	string	下一页 token
more	object	更多的错误信息

响应体示例

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