获取群成员详情

查询指定群聊中某个成员的详细资料信息。

接口地址： POST /getChatRoomMemberInfo

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 当前微信实例仍在目标群聊中，并已获得可用的 chatRoomId。
• 已知道目标群成员的微信 ID。
• 暂不支持批量查询多个群成员；如需获取多人信息，请间隔调用。

请求参数

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

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	array	成员详情列表
data[].userName	string	微信 ID
data[].nickName	string	昵称
data[].remark	string	备注
data[].signature	string	个性签名
data[].sex	int	性别
data[].aliasName	string	微信号
data[].country	string/null	国家
data[].bigHead	string	大头像 URL
data[].smallHead	string	小头像 URL
data[].labelList	string/null	标签列表
data[].v1	string	加好友凭证 1
data[].v2	string	加好友凭证 2

请求示例

{
  "wId": "4941c159-48dc-4271-b0d0-f94adea39127",
  "chatRoomId": "232323232@chatroom",
  "userList": "wxid_daydt60mc0ny22"
}

成功响应

{
  "message": "成功",
  "code": "1000",
  "data": [
    {
      "userName": "wxid_daydt6xx1c0ny22",
      "nickName": "北京123",
      "remark": "",
      "signature": "",
      "sex": 0,
      "aliasName": "example_alias",
      "country": null,
      "bigHead": "https://t8.182.40.194.50/it/u=1484500186,1503043093&fm=79&app=86&size=h300&n=0&g=4n&f=jpeg?sec=1593075215&t=4d1c7f8cab5417b9ebec450bb180d00e",
      "smallHead": "https://t8.182.40.194.50/it/u=1484500186,1503043093&fm=79&app=86&size=h300&n=0&g=4n&f=jpeg?sec=1593075215&t=4d1c7f8cab5417b9ebec450bb180d00e",
      "labelList": null,
      "v1": "v3_020b3826fd0301000009b4df5b5000000501ea9a3dba12f95f6b60a0536a1adb69d4c980f5186cb7f0dbb8ee9b5f0cdcf4a075737d607e1803aededdd3a719b452a84dbf83c12e07b110dae9260e6ac806c82f380ad6085660a9@stranger",
      "v2": ""
    }
  ]
}

错误响应

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

使用建议

• 建议用 chatRoomId + userName 关联群成员详情，避免同一成员在不同群中的群内信息混淆。
• 如果只需要群内昵称和头像，可先使用 获取群成员。
• 该接口不适合高频逐个扫全群成员；多人查询建议做队列和间隔控制。