---
title: "获取小组成员列表"
method: GET
path: "/p1/groups/{groupName}/members"
tags: ["group"]
---

# 获取小组成员列表

`GET /p1/groups/{groupName}/members`

## Path parameters

- `groupName` string, required

## Query parameters

- `role` -2 | -1 | 0 | 1 | 2 | 3 — 小组成员角色 - -2 = 访客 - -1 = 游客 - 0 = 小组成员 - 1 = 小组长 - 2 = 小组管理员 - 3 = 禁言成员
- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` GroupMember[], required
    - `joinedAt` integer, required
    - `role` -2 | -1 | 0 | 1 | 2 | 3, required — 小组成员角色 - -2 = 访客 - -1 = 游客 - 0 = 小组成员 - 1 = 小组长 - 2 = 小组管理员 - 3 = 禁言成员
    - `uid` integer, required
    - `user` SlimUser
      - `avatar` Avatar, required
        - `large` string, required
        - `medium` string, required
        - `small` string, required
      - `group` integer, required
      - `id` integer, required
      - `joinedAt` integer, required
      - `nickname` string, required
      - `sign` string, required
      - `username` string, required
  - `total` integer, required — limit+offset 为参数的请求表示总条数，page 为参数的请求表示总页数

## Other responses

- `500` — 意料之外的服务器错误

---

[API](https://skmtc.net/bangumi/apis/bangumi-private-api.md) · [All operations](https://skmtc.net/bangumi/apis/bangumi-private-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bangumi/bangumi-private-api/versions/79dbcbd374a3/schema)