获取封面图下载链接
通过封面图的store_key获取下载URL及哈希校验值
请求说明
| 请求地址 | https://openapi.wps.cn/v7/announce/announces/{announce_id}/download |
|---|---|
| 请求方法 | GET |
| 签名方式 | KSO-1 |
| 权限要求 | 查询公告（应用授权） kso.announce.read 查询公告（用户授权） kso.announce.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）
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| announce_id | string | 是 | <= 1024 characters,公告id |
查询参数（Query）
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| store_key | string | 是 | <= 1024 characters，封面图存储标识store_key |
| with_hash | bool | 否 | 是否返回校验值,对应响应里的hashes(暂不支持) |
请求地址示例
[GET] https://openapi.wps.cn/v7/announce/announces/23367/download?store_key=5A51FBBANDAwMDMyNTA1MTpkb1ZKNVUyWkIxTXJ4dmVnakNROHJ4R0Nnb0dhRVRVS3U%3D响应体（Response）
| 名称 | 类型 | 说明 |
|---|---|---|
| code | integer | code |
| more | object | 更多的错误信息 |
| msg | string | msg |
| data | object | 信息返回 |
| ∟ url | string | 封面图http链接 |
| ∟ hashes | object[] | 文件散列值，with_hash=true时返回（暂不支持） |
| ∟∟ type | string | 哈希类型（公网可能返回md5/sha1/sha256中的一个或多个） |
| ∟∟ sum | string | 哈希值 |
响应体示例
json
{
"data": {
"url": "https://ksc-bj-beta.ag.kdocs.cn/api/object/2_1f4fa5efb1fb428bb9c0a921df987795/compatible?response-content-disposition=attachment%3Bfilename%2A%3Dutf-8%27%27cover%25285%2529.png&KSSAccessKeyId=AKLTXqKLY7ITAA8roIvJnY2w&Expires=1742547928&Signature=7Gkt7d%2BKGlbXj4VnxRYC09QG2F8%3D"
},
"code": 0,
"more": {},
"msg": "string"
}