获取群二维码

获取指定微信群聊的二维码图片链接。

接口地址： POST /getGroupQrCode

前置条件

微信实例已登录，并已获得可用的 wId。
当前微信实例仍在目标群聊中，并已获得可用的 chatRoomId。
生成的二维码有效期通常为 7 天。
微信实例在线时间不足时，可能出现二维码已过期等微信侧提示；建议账号稳定在线后再调用。

请求参数

参数名	必选	类型	说明
`wId`	是	string	登录实例标识
`chatRoomId`	是	string	群 ID

响应参数

参数名	类型	说明
`code`	string	`1000` 成功，`1001` 失败
`message`	string	反馈信息
`data`	object/null	成功时返回二维码信息，失败时通常为空
`data.imgUrl`	string	群二维码图片链接

请求示例

json

{
  "wId": "349be9b5-8734-45ce-811d-4e10ca568c67",
  "chatRoomId": "24187765053@chatroom"
}

成功响应

json

{
  "message": "成功",
  "code": "1000",
  "data": {
    "imgUrl": "https://cdn.e-yun.example/qrcode/group-24187765053.png"
  }
}

错误响应

json

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

使用建议

群二维码属于可传播入口，建议只展示给有权限的业务角色。
不建议长期缓存二维码链接；过期后应重新调用接口获取。
如只是邀请已知好友进群，优先使用邀请成员相关接口，减少二维码外泄风险。