Skip to content

2026-07-28-01 chatx 群成员列表关键字兜底

1. 变更摘要

新增 chatx 群成员列表接口,用于在不改 OpenIM 官方镜像的前提下,提供稳定可用的群成员关键字检索能力。

2. 接口变更

2.1 新增接口

  • POST /chatx/group/get_group_member_list

2.2 行为要点

  • keyword 为空:走稳定分页查询。
  • keyword 非空:chatx 侧执行本地过滤(nickname + userID,不区分大小写),再分页返回。
  • 普通用户仅允许查询自己所在群;管理员可查询任意群。

3. 兼容性

  • 新增接口,不影响既有 chat/group 与 open-im-server 原接口行为。
  • 对依赖关键词检索的调用方,建议优先切换到该 chatx 接口。

4. 动作等级

动作等级:建议改

  • 已使用群成员关键词检索且受 OpenIM keyword 问题影响的调用方,建议接入该接口。
  • 仅使用普通分页且无关键词检索需求的调用方,可暂不改。