获取频道成员列表

获取频道下的成员列表。

使用示例

  1. async function demo() {
  2. let { data } = await client.guildApi.guildMembers(guildId, queryParams);
  3. }

参数说明

字段名 必填 类型 描述
guildId string 频道 ID
queryParams QueryParams 查询参数

QueryParams

字段名 必填 类型 描述
after string 上一次回包中最大的用户 ID, 如果是第一次请求填 0,默认为 0
limit number 分页大小,1-1000,默认是 1

返回说明

返回 Member 对象。

Member

字段名 类型 描述
user User 用户的频道基础信息,只有成员相关接口中会填充此信息
nick string 用户在频道内的昵称
roles string[] 用户在频道内的身份组 ID,默认值可参考DefaultRoleIDs
joined_at string 用户加入频道的时间,是个 ISO8601 timestamp 字符串,例:”2021-11-23T15:16:48+08:00”

User

字段名 类型 描述
id string 用户 ID
username string 用户名
avatar string 用户头像地址
bot boolean 是否是机器人

返回示例

data

  1. [
  2. {
  3. user: {
  4. id: 'USERID',
  5. username: '机器人管家-ostwindli',
  6. avatar: 'http://thirdqq.qlogo.cn/g?b=oidb&k=oPicoPIg01ujpSr8oosudkQ&s=0&t=1637218059',
  7. bot: false,
  8. public_flags: 0,
  9. system: false,
  10. },
  11. nick: '阿青',
  12. roles: ['4'],
  13. joined_at: '2021-11-23T15:16:48+08:00',
  14. deaf: false,
  15. mute: false,
  16. pending: false,
  17. },
  18. ];