Skip to content

CDN 视频上传

将视频和封面上传到微信 CDN,返回发送视频消息或后续业务处理需要的 CDN 参数。

接口地址: POST /sendCdnVideo

前置条件

  • 当前 wId 已完成登录,并且账号状态正常。
  • path 为接口服务可访问的视频链接。
  • thumbPath 为接口服务可访问的视频封面图片链接。

请求参数

参数名必选类型说明
wIdstring登录实例标识
pathstring视频 URL
thumbPathstring视频封面图片 URL

请求示例

json
{
  "wId": "{{wId}}",
  "path": "https://cdn.e-yun.example/video/customer-case.mp4",
  "thumbPath": "https://cdn.e-yun.example/video/customer-case-cover.png"
}

响应参数

参数名类型说明
codestring1000 成功,1001 失败
messagestring反馈信息
dataobjectCDN 视频信息
data.cdnUrlstring视频 CDN 信息
data.aesKeystring视频 aesKey
data.lengthnumber视频文件大小或长度字段,按接口返回值使用

成功响应

json
{
  "code": "1000",
  "message": "发送视频消息成功",
  "data": {
    "cdnUrl": "30670201000460305e02010002041b9042eb02033d14b90204...",
    "aesKey": "1a8e3941e3cc233e6f151430088eec6e",
    "length": 3124240
  }
}

错误响应

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

使用建议

  • 上传前确认视频和封面链接都能被接口服务访问。
  • 返回的 cdnUrlaesKeylength 建议按原样保存。
  • 若用于发送视频消息,应与对应发送接口要求的字段保持一致。