扫码入群

通过群二维码链接识别并加入微信群聊。

接口地址： POST /scanJoinRoom

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 已获得群二维码解析后的链接，并确认来源可信。
• 二维码可能存在有效期、人数限制或权限限制，是否能入群以微信侧结果为准。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
url	是	string	群二维码 URL，通常是二维码解析后的链接
type	否	int	操作类型：默认 0 进群；1 返回群名称及人数；10 返回原始 HTML 数据

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object/null	根据 type 不同返回入群结果、群信息或原始数据

请求示例

{
  "wId": "0000016f-a340-c2d7-0003-6ab83bc1e64a",
  "url": "https://weixin.qq.com/g/A1B2C3D4E5F6G7H8",
  "type": 0
}

成功响应

{
  "message": "成功",
  "code": "1000",
  "data": null
}

错误响应

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

使用建议

• 入群前可先用 type: 1 查询群名称和人数，确认无误后再执行入群。
• 不建议对来源不明的二维码自动入群，避免账号风险。
• 入群成功后可调用 获取群信息 或 获取群成员 做状态同步。