Eyun 文档

Appearance

获取群列表 ​

接口地址： POST /getChatRooms

获取当前微信实例已保存到通讯录的群聊 ID 列表。

前置条件 ​

  • 已完成微信登录，并保存当前登录返回的 wId。
  • 已调用 初始化群列表。
  • 本接口只返回群 ID，不返回群名、群成员、群公告等详情。

数据范围 ​

范围是否返回说明
已保存到通讯录的群返回本接口主要返回这类群聊
最近聊天但未保存的群不保证返回建议通过消息回调捕获后，再调用群详情接口入库
长期无消息且未保存的群通常不返回微信客户端本身也可能不展示在当前会话中

请求参数 ​

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

响应参数 ​

参数名类型说明
codestring1000 成功，1001 失败
messagestring反馈信息
dataarray群 ID 列表，群 ID 通常以 @chatroom 结尾

请求示例 ​

json
{
	"wId": "6a696578-16ea-4edc-ac8b-e609bca39c69"
}

成功响应 ​

json
{
 "message": "成功",
 "code": "1000",
 "data": [
 "2340848117@chatroom",
 "232916813@chatroom",
 "1954631131@chatroom",
 "2260665764@chatroom",
 "2465147705@chatroom",
 "2385536808@chatroom",
 "194134007282@chatroom",
 "2229123655359@chatroom",
 "243552364656@chatroom",
 "20250945708@chatroom",
 "2179315830@chatroom"
 ]
}

错误响应 ​

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

使用建议 ​

  • 将返回的群 ID 保存到业务数据库，并以群 ID 作为后续接口调用主键。
  • 如果通过消息回调收到新群消息，但本接口未返回该群，请调用 获取群详情 后自行入库。
  • 如需群成员列表，请调用 获取群成员列表。