发布视频号

发布视频号视频。支持直接传视频与封面链接，也支持先调用“上传视频号视频”接口，再使用返回的 videoCdn 数据发布。

接口地址： POST /finderPublish

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• myUserName 为自己的视频号用户编码。
• 直发模式需要提供 videoUrl、videoThumbUrl；上传模式需要提供 videoCdn。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
myUserName	是	string	自己的视频号用户编码
myRoleType	否	int	自己的视频号角色类型，上传模式建议传入
videoUrl	否	string	视频链接，直发模式必传
videoThumbUrl	否	string	封面链接，直发模式必传
videoWidth	是	int	视频宽度
videoHeight	是	int	视频高度
videoPlayLen	是	int	视频播放时长，单位秒
title	是	string	视频标题或文案
topic	是	array	话题列表
videoCdn	否	object	上传视频号视频接口返回的数据，上传模式必传
videoCdn.fileUrl	是	string	上传后的视频文件地址
videoCdn.thumbUrl	是	string	上传后的封面地址
videoCdn.mp4Identify	是	string	视频文件标识
videoCdn.fileSize	是	int	视频文件大小
videoCdn.thumbMd5	是	string	封面 MD5
videoCdn.fileKey	是	string	上传文件 key

直发请求示例

{
  "wId": "{{wId}}",
  "myUserName": "v2_060000231003b20faec8c6e18f10c7d6c903ec3db0776955d3d97c6b329d6aa58693bcdb7ad1@finder",
  "videoUrl": "https://cdn.e-yun.example/feed/customer-case.mp4",
  "videoThumbUrl": "https://cdn.e-yun.example/feed/customer-case-cover.jpeg",
  "videoWidth": 1240,
  "videoHeight": 930,
  "videoPlayLen": 13,
  "title": "可爱吗？",
  "topic": ["#可爱", "#hhh"]
}

上传后发布示例

{
  "wId": "{{wId}}",
  "myUserName": "v2_060000231003b20faec8c6e18f10c7d6c903ec3db0776955d3d97c6b329d6aa58693bcdb7ad1@finder",
  "myRoleType": 3,
  "videoUrl": "",
  "videoThumbUrl": "",
  "videoWidth": 1240,
  "videoHeight": 930,
  "videoPlayLen": 13,
  "videoCdn": {
    "fileUrl": "http://wxapp.tc.qq.com/251/20302/stodownload?...",
    "thumbUrl": "http://wxapp.tc.qq.com/251/20350/stodownload?...",
    "mp4Identify": "f554da4964c2c64ad97dc9623f5daa5b",
    "fileSize": 1315979,
    "thumbMd5": "cc9a86fb446c70f5ed6c16ca7754f4c1",
    "fileKey": "finder_upload_8147263162_zhangchuan2288"
  },
  "title": "可爱吗？",
  "topic": ["#可爱", "#hhh"]
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object / null	发布成功时通常返回 null

成功响应

{
  "code": "1000",
  "message": "视频号发布成功",
  "data": null
}

错误响应

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

使用建议

• 更稳定的流程是先上传视频，再使用 videoCdn 发布。
• topic 建议传数组，每个话题保留 # 前缀。
• 发布前应校验视频尺寸、时长、封面和内容合规性。