获取群成员

查询指定微信群聊的成员列表。

接口地址： POST /getChatRoomMember

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 当前微信实例仍在目标群聊中，并已获得可用的 chatRoomId。
• 群成员信息受微信侧权限和同步状态影响，刚入群或刚变更成员后可能需要等待再查询。

请求参数

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

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	array	群成员列表
data[].chatRoomId	string	群 ID
data[].userName	string	群成员微信 ID
data[].nickName	string	群成员默认昵称
data[].chatRoomOwner	string/null	群主 ID，可能为空
data[].bigHeadImgUrl	string	大头像 URL
data[].smallHeadImgUrl	string	小头像 URL
data[].v1	string/null	加好友凭证，可能为空
data[].memberCount	int	成员数，列表项中可能为 0
data[].displayName	string	群内昵称
data[].chatRoomMembers	array/null	嵌套成员信息，通常为空

请求示例

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

成功响应

{
  "message": "成功",
  "code": "1000",
  "data": [
    {
      "chatRoomId": "23282491030@chatroom",
      "userName": "wxid_wl9qchkanp9u22",
      "nickName": "E云通知小助手（微信实例）",
      "chatRoomOwner": null,
      "bigHeadImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/DEjvrt3YDnqggwzHj2LQTwY3K1y6TWVC615azPYb3RSWgeMvE5ny1kYQSBoNLgCicRMGa9LRp9dQJy2HHurNSYqqZNf5NTxicDMTNdjL3SrAI/0",
      "smallHeadImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/DEjvrt3YDnqggwzHj2LQTwY3K1y6TWVC615azPYb3RSWgeMvE5ny1kYQSBoNLgCicRMGa9LRp9dQJy2HHurNSYqqZNf5NTxicDMTNdjL3SrAI/132",
      "v1": null,
      "memberCount": 0,
      "displayName": "",
      "chatRoomMembers": null
    },
    {
      "chatRoomId": "23282491030@chatroom",
      "userName": "wxid_i6qsbbjenjuj22",
      "nickName": "E云Team_Mr Li",
      "chatRoomOwner": null,
      "bigHeadImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/licI98sKzmtB0BWmDGvVaqcvCmDMMbLsGku18zHpxoxYibXH2QhZibTIjOPhzlpAkQic8Tlhdk4lCAIlE0twxQnqng4M4CKcV3ps52wOfcMHemo/0",
      "smallHeadImgUrl": "http://wx.qlogo.cn/mmhead/ver_1/licI98sKzmtB0BWmDGvVaqcvCmDMMbLsGku18zHpxoxYibXH2QhZibTIjOPhzlpAkQic8Tlhdk4lCAIlE0twxQnqng4M4CKcV3ps52wOfcMHemo/132",
      "v1": null,
      "memberCount": 0,
      "displayName": "",
      "chatRoomMembers": null
    }
  ]
}

错误响应

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

使用建议

• 建议以 chatRoomId + userName 作为群成员唯一键。
• 如果需要成员更完整的资料，请继续调用 获取群成员详情。
• 群成员列表可能变化频繁，业务侧应按需刷新，不建议长期缓存。