上传视频号视频

上传视频文件和封面图片到视频号，返回发布视频时需要使用的文件信息。

接口地址： POST /finderUpload

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• videoUrl、imgUrl 必须是接口服务可访问的公网或内网可达链接。
• 上传成功后返回的 fileUrl、thumbUrl、fileKey 等字段会用于发布视频。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
videoUrl	是	string	视频文件链接
imgUrl	是	string	视频封面图片链接

请求示例

{
  "wId": "{{wId}}",
  "videoUrl": "https://cdn.e-yun.example/feed/customer-case.mp4",
  "imgUrl": "https://cdn.e-yun.example/feed/customer-case-cover.jpeg"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	上传后的文件信息
data.fileUrl	string	上传后的视频文件地址
data.thumbUrl	string	上传后的封面地址
data.mp4Identify	string	视频文件标识
data.fileSize	number	视频文件大小
data.thumbMd5	string	封面 MD5
data.fileKey	string	上传文件 key，发布视频时使用

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "fileUrl": "http://wxapp.tc.qq.com/251/20302/stodownload?...",
    "thumbUrl": "http://wxapp.tc.qq.com/251/20350/stodownload?...",
    "mp4Identify": "5118be81f2de929d3c79fc8777732b43",
    "fileSize": 1315979,
    "thumbMd5": "cc9a86fb446c70f5ed6c16ca7754f4c1",
    "fileKey": "finder_upload_6764713041_zhangchuan2288"
  }
}

错误响应

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

使用建议

• 上传成功后应保存完整 data，后续发布视频会用到其中多个字段。
• 视频和封面建议提前校验格式、大小和可访问性，减少微信侧上传失败。
• 上传返回的微信侧链接可能有时效，建议上传后尽快发布。