发送视频朋友圈

同步发送视频到朋友圈，支持可见/不可见分组。

接口地址： POST /snsSendVideo

调用限制

微信需在线三天后使用本接口，否则微信团队会提示不可使用副设备发送。

前置条件

• 微信实例已登录，并已获得可用 wId。
• 当前微信实例在线时间满足微信侧朋友圈发布要求。
• videoPath 需要公网可访问，视频最大 20M 且 30 秒以内。
• thumbPath 需要公网可访问，封面最大 2M。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
content	是	string	文本内容
videoPath	是	string	视频链接 URL，最大 20M 且 30 秒以内
thumbPath	是	string	视频封面 URL，最大 2M
groupUser	否	string	可见用户，多个微信 ID 用 , 分隔
blackList	否	string	不可见用户，多个微信 ID 用 , 分隔
groupUserLabelIds	否	string	可见标签，多个标签 ID 用 , 分隔
blackListLabelIds	否	string	不可见标签，多个标签 ID 用 , 分隔

请求示例

{
  "wId": "0000016e-68f9-99d5-0002-3a1cd9eaaa17",
  "content": "今天还是可以的",
  "videoPath": "https://wkgjonlines.oss-cn-shenzhen.aliyuncs.com/movies/20191113/d7c616569ac342ad1fa8e3301682844e.mp4",
  "thumbPath": "http://cdn.duitang.com/uploads/item/201412/21/20141221161645_2MSeA.jpeg"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data.status	int	发送状态
data.object.id	string	朋友圈 ID
data.object.userName	string	发送者微信 ID
data.object.createTime	long	发送时间戳
data.object.objectDesc	string	文本内容

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": {
    "status": 1,
    "object": {
      "id": "13367129656153944194",
      "userName": "wxid_gia1nwcgpobz22",
      "createTime": 1593486029,
      "objectDesc": "今天还是可以的"
    }
  }
}

错误响应

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

使用建议

• 同步发送会等待视频处理结果，接口耗时可能较长；耗时敏感场景建议使用异步发送视频接口。
• 发布前先检查视频大小、时长和封面大小，避免微信侧拒绝。
• 朋友圈视频更容易触发风控，建议控制频率并记录发布来源。