获取文件下载地址
用于获取已上传文件的下载地址。
请求说明
| 请求地址 | 配置域名+/o/woa/api/v1/developer/mime/download |
|---|---|
| 请求方法 | GET |
| 签名方式 | wps-4 |
| 支持应用类型 | 企业自建应用、第三方企业应用 |
| 权限要求 | 管理协作文件(kso.im.file.manage) |
请求头
| 名称 | 是否必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 固定为: application/json |
| Wps-Docs-Date | 是 | 取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT |
| Wps-Docs-Authorization | 是 | 计算方法参考签名说明 |
| Authorization | 是 | 授权token,格式:Bearer ${access_token},${access_token}需替换为从授权接口获取的access_token值 |
查询参数(Query)
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| file_id | string | 是 | 文件 id,需传从"获取上传文件授权"接口返回的store_key值 |
请求地址示例
http
[GET] 配置域名+/o/woa/api/v1/developer/mime/download响应体
| 名称 | 类型 | 说明 |
|---|---|---|
| result | integer | 状态码,非 0 表示失败,参照《状态码说明》 |
| url | string | 文件下载地址 |
响应体示例
json
{
"result": 0,
"url": "https://xiezuo-bucket.ks3-cn-beijing.ksyun.com/media%2F1b151dc38eb06e386e86a1a55648964d"
}出于安全考虑,文件的下载链接都有过期时间,链接失效后需要重新获取链接。