频道用户相关接口列表

本文档主要列出频道用户相关接口。

本文档中的接口均符合接口规范，如有疑问，建议先查阅接口引言。

接口 接口说明 维护状态
/api/v3/channel-user/get-joined-channel 根据用户id和服务器id获取用户所在语音频道 正常

根据用户id和服务器id获取用户所在语音频道

接口说明

地址 请求方式 说明
/api/v3/channel-user/get-joined-channel GET

参数列表

参数名 位置 类型 必需 说明
page query integer false 目标页数
page_size query integer false 每页数据数量
guild_id query string true 服务器 id
user_id query string true 用户id

返回参数说明

参数名 类型 说明
id string 频道 id
guild_id string 父分组频道 id
master_id string 频道创建者 id
parent_id string 父分组频道 id
user_id string 用户id
name string 频道名称
topic string 频道简介
type int 频道类型
level int 频道排序
slow_mode int 慢速限制，单位秒。用户发送消息之后再次发送消息的等待时间。
limit_amount int 人数限制
is_category boolean 是否为分组类型
permission_overwrites Array 频道权限覆写的角色列表, 详情见频道角色权限详情
permission_users Array 频道权限覆写的用户列表, 详情见频道角色权限详情
permission_sync int 是否同步分组的权限

返回示例

  1. {
  2.     "code": 0,
  3.     "message": "操作成功",
  4.     "data": {
  5.         "items": [
  6.             {
  7.                 "id": "100000000000000",
  8.                 "guild_id": "1111111111111111",
  9.                 "master_id": "1111111111",
  10.                 "parent_id": "",
  11.                 "user_id": "1111111111",
  12.                 "name": "测试",
  13.                 "topic": "",
  14.                 "type": 2,
  15.                 "level": 200,
  16.                 "slow_mode": 0,
  17.                 "limit_amount": 50,
  18.                 "is_category": false,
  19.                 "permission_sync": 0,
  20.                 "permission_overwrites": [
  21.                     {
  22.                         "role_id": 0,
  23.                         "allow": 0,
  24.                         "deny": 0
  25.                     }
  26.                 ],
  27.                 "permission_users": []
  28.             }
  29.         ],
  30.         "meta": {
  31.             "page": 1,
  32.             "page_total": 1,
  33.             "page_size": 50,
  34.             "total": 1
  35.         },
  36.         "sort": {}
  37.     }
  38. }