发送图片朋友圈消息

发布图文朋友圈。

调用限制

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

接口地址： POST /snsSendImage

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 当前微信实例在线时间满足微信侧朋友圈发布要求。
• paths 中的图片 URL 需要公网可访问，多个图片用英文分号分隔。
• 单张图片建议控制在 3M 以内，并使用 PNG 格式。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
content	是	string	文本内容
paths	是	string	图片 URL，多个用英文分号分隔
groupUser	否	string	可见用户微信 ID，多个用英文逗号分隔
blackList	否	string	不可见用户微信 ID，多个用英文逗号分隔
groupUserLabelIds	否	string	可见标签 ID，多个用英文逗号分隔
blackListLabelIds	否	string	不可见标签 ID，多个用英文逗号分隔

请求示例

{
 "wId": "0000016e-6382-4be4-0001-e6b4e3cd1bbd",
 "content": "这是一条图文朋友圈消息",
 "paths": "http://1563240615548.jpg;http://1563253424796.png"
}

响应参数

参数名	类型	说明
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	朋友圈内容

成功响应

{
 "message": "成功",
 "code": "1000",
 "data": {
 "status": 1,
 "object": {
 "id": "13367129656153944194",
 "userName": "wxid_gia1nwcgpobz22",
 "createTime": 1593486029,
 "objectDesc": "这是一条图文朋友圈消息"
 }
 }
}

错误响应

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

使用建议

• 发布图片前建议先校验图片 URL 是否可公网访问，避免微信端上传失败。
• 多图发布时建议控制图片数量和大小，避免请求耗时过长。
• 可见范围涉及用户隐私，建议后台明确展示本次朋友圈的可见/不可见配置。