Eyun 文档

Appearance

异步发送视频朋友圈 ​

异步发布视频朋友圈，接口先返回 asynId，后续通过查询接口获取发布结果。

调用限制

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

接口地址： POST /asynSnsSendVideo

前置条件 ​

  • 微信实例已登录，并已获得可用的 wId。
  • 当前微信实例在线时间满足微信侧朋友圈发布要求。
  • videoPath 需要公网可访问，视频最大 20M 且 30 秒以内。
  • thumbPath 需要公网可访问，封面最大 2M。
  • 业务侧需要保存返回的 asynId，用于查询异步发布结果。

请求参数 ​

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

请求示例 ​

json
{
  "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"
}

响应参数 ​

参数名类型说明
codestring1000 成功，1001 失败
messagestring反馈信息
data.asynIdstring异步任务 ID，可用于查询发送视频朋友圈结果

成功响应 ​

json
{
 "code": "1000",
 "message": "处理成功",
 "data": {
 "asynId": "04d0af77-3877-4621-85ce-c8bee6a460e4"
 }
}

错误响应 ​

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

使用建议 ​

  • 视频发布建议优先使用异步接口，减少业务请求超时风险。
  • 获取 asynId 后应轮询「获取发送视频朋友圈结果」接口，直到得到明确结果。
  • 建议业务侧保存 asynId、发布参数和操作人，方便失败后重试或排查。