# 频道批量成员禁言

# 接口

PATCH /guilds/{guild_id}/mute
1

# 功能描述

用于将频道的指定批量成员(非管理员)禁言。

  • 需要使用的 token 对应的用户具备管理员权限。如果是机器人,要求被添加为管理员。

该接口同样可用于批量解除禁言,具体使用见批量解除禁言

# Content-Type

application/json
1

# 参数

字段名 类型 描述
mute_end_timestamp string 禁言到期时间戳,绝对时间戳,单位:秒(与 mute_seconds 字段同时赋值的话,以该字段为准)
mute_seconds string 禁言多少秒(两个字段二选一,默认以 mute_end_timestamp 为准)
user_ids string列表 禁言成员的user_id列表,即User的id

# 批量解除禁言

该接口同样支持批量解除禁言,将mute_end_timestampmute_seconds传值为字符串'0'即可,及需要批量解除禁言的成员的user_id 列表user_ids

# 返回

成功返回 HTTP 状态码 200,并返回设置成功的成员user_ids

# 错误码

详见错误码

# 示例

请求数据包

{
  "mute_end_timestamp": "1641916800",
  "mute_seconds": "120",
  "user_ids": ["1201318637970874066","1201318637970874067"]
}
1
2
3
4
5

响应数据包

{
  "user_ids": ["1201318637970874066"]
}
1
2
3
手机QQ扫码
开发者社区
加入官方频道开发者社区