# 获取群成员列表

获取群成员列表，每次最多返回 30 条，支持分页。

该能力正在内邀接入中，敬请期待

# 请求

# 基础信息

字段	值
HTTP URL	/v2/groups/{group_openid}/members
HTTP Method	GET
接口频率限制	60 QPM

# 路径参数

名称	类型	必填	描述
group_openid	string	是	群OpenID

# 请求体

名称	类型	必填	描述
cursor	string	否	分页游标，首次请求可不传或传空串；后续传上一次响应的 next_cursor

# 请求示例

GET /v2/groups/3E5D8A1F7B2C9E4D6A0F1B3C5D7E9F2A/members?cursor=

1
2

# 响应

# 响应体

名称	类型	描述
members	[]Member	成员列表，每次最多返回 30 条
next_cursor	string	下一页游标，空串表示已到末页

Member

名称	类型	描述
member_openid	string	成员 OpenID
username	string	用户昵称
member_role	string	群成员角色 member-普通成员，owner-群主，admin-管理员
bot	boolean	是否机器人
joined_at	string	入群时间戳（RFC3339格式）
union_openid	string	用户在应用/开放平台下的统一标识（如有）

# 响应示例

{
    "members": [
        {
            "member_openid": "7A3B9C1D5E2F4A6B8C0D1E3F5A7B9C2D",
            "username": "阳光小助手",
            "member_role": "member",
            "bot": false,
            "joined_at": "2025-08-20T09:15:00+08:00",
            "union_openid": "9F2E872045CCCC5948BEAF5B5FCCDF22"
        },
        {
            "member_openid": "EC58D87F598C8294A533B9D458DAAF33",
            "username": "T小不点101",
            "member_role": "member",
            "bot": false,
            "joined_at": "2025-07-01T10:30:00+08:00",
            "union_openid": "FE003FAF76C4817251FDC128A16753BB"
        }
    ],
    "next_cursor": "bG1fNmIxOTM1NTRjNy4zMA"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

# 错误码

错误码	描述	排查建议
11253	应用无接口访问权限	该接口仅白名单机器人可用，请联系平台运营申请权限

← 修改入群自动审批策略的白名单号码获取群成员信息 →