CDN 资源下载

根据消息 XML 或接口返回中的 CDN 参数下载图片、视频或文件资源，并返回可访问的下载地址。

接口地址： POST /cdnDownFile

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• 已从消息 XML 或相关接口中获取 cdnUrl、aeskey、totalSize。
• 下载图片失败时，可尝试切换 fileType，因为并非所有图片都同时存在高清图、常规图和缩略图。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
cdnUrl	是	string	CDN 资源地址，通常从 XML 获取
aeskey	是	string	资源 aesKey，通常从 XML 获取
fileType	是	int	文件类型：1 高清图片，2 常规图片，3 缩略图，4 视频，5 文件
fileName	是	string	保存后的资源全名，例如 test.png
totalSize	是	int	XML 中的资源大小

请求示例

{
  "wId": "{{wId}}",
  "cdnUrl": "307f02010004783076020100020464e5eb6502033d14b90204...",
  "aeskey": "4eddfc10-a37b-4498-9947-d1f203637b7d",
  "fileType": 3,
  "fileName": "test.jpg",
  "totalSize": 206249
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	下载结果
data.url	string	下载后的资源访问地址

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "url": "https://cdn.e-yun.example/20210812/customer-service.jpg?Expires=1629350242"
  }
}

错误响应

{
  "code": "1001",
  "message": "失败",
  "data": null
}

使用建议

• 图片下载失败时，先尝试切换 fileType=1/2/3。
• fileName 建议包含正确扩展名，便于后续展示和下载。
• 下载返回的 url 可能有有效期，业务侧需要及时转存或消费。