Skip to content

获取指定文件版本下载地址

适用版本>=v7.0.2408a.20240808

接口说明:获取指定版本文件下载

请求说明

请求地址配置域名+/graph+/v7/drives/{drive_id}/files/{file_id}/versions/{version_num}/download
请求方法GET
签名方式WPS-4签名/WPS-4-GM签名(配置域名+/graph不参与签名)
权限要求查询文档版本(用户授权) kso.file_version.read

请求头(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 characters
file_idstring文件id,<= 1024 characters
version_numinteger文件版本

查询参数(Query)

名称类型是否必填说明
with_hashboolean是否返回校验值,默认不返回
internalboolean是否返回内部下载地址,默认为false

响应体(Response)

名称类型说明
dataobject文件下载信息返回体
hashesobject[]文件hash信息
sumstring哈希结果,长度不超过1024位
typestring哈希类型,固定为s2s
urlstring下载链接
codeinteger错误码,参照《错误码说明》
msgstring状态信息
detailstring详细信息

响应体示例

{
  "data": {
    "hashes": [
      {
        "sum": "string",
        "type": "s2s"
      }
    ],
    "url": "string"
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}