Skip to content

获取文件下载信息

适用版本>=v7.0.2307b.20230720

接口说明:获取文件下载信息

请求说明

请求地址配置域名+/graph+/v7/drives/{drive_id}/files/{file_id}/download
请求方法GET
签名方式WPS-4签名/WPS-4-GM签名(配置域名+/graph不参与签名)
权限要求以用户身份管理文档(用户授权) kso.drive.as_user.manage 更新文件(用户授权) kso.file.write 应用查询文件(应用授权) kso.appdrive.file.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

查询参数(Query)

名称参数类型是否必填说明
with_hashbool是否返回校验值
internalbool是否返回内部下载地址,默认为false

响应体(Response)

名称类型说明
dataobject获取文件下载信息信息返回
urlstring文件下载链接
hashesobject[]哈希值
sumstring哈希结果
typestring哈希类型,固定为s2s
codeinteger错误码,参照《错误码说明》
msgstring状态信息
detailstring详细信息

响应体示例

{
    "code": 0,
    "data": {
        "url": "http://encs-pri-minio/wpsfile/yundoc/HwJM1uTKTJIaQKhnN5r1jIUxmR2189140190625792?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=LTAIf5lqDRk6W4Mf%2F20230703%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230703T084847Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%2A%3Dutf-8%27%27%25E5%25B7%25A5%25E4%25BD%259C%25E7%25B0%25BF.xlsx&X-Amz-Signature=4aa157324796242505d64850c33cc70bdc3ddbc12c8cc7b529bfced37b955666",
        "hashes": [
            {
                "type": "s2s",
                "sum": "NEaWrWiYV9Npn5jqnBNK3tEpyirtdD/UTAio+SYJcdQ="
            }
        ]
    },
    "detail": "",
    "msg": "ok"
}