SetForbidUserRule
https://rtc-api.zego.im/
设置用户封禁规则以封禁某些用户。设置成功后，您可以 查询用户封禁规则 或 删除用户封禁规则。
-
假设需要封禁的用户是 user1，未登录房间 room1：
- RuleType 取值为 1、DisabledPrivilege[] 取值为 1 时，表示该 IP 地址对应的用户无法登录任何房间。
- RuleType 取值为 2、DisabledPrivilege[] 取值为 1 时，表示任何用户都无法登录 room1。
- RuleType 取值为 3、DisabledPrivilege[] 取值为 2 时，表示 user1 可以正常登录到任何房间，但无法在任何房间内推流。
- RuleType 取值为 4、DisabledPrivilege[] 取值为 2 时，表示 user1 可以正常登录到 room1，但无法在 room1 内推流。
-
假设需要封禁的用户是 user1，且已登录房间 room1，无论 RuleType 取值如何：
- DisabledPrivilege[] 取值为 1 或 1&2 时，user1 仍在 room1 内、但无法正常推流，需要调用 踢出房间用户 接口踢出用户。
- DisabledPrivilege[] 取值为 2 时，user1 无法在 room1 内推流。
Request
Query Parameters
- 1：通过 IP 地址封禁用户，最多可设置 100 条；
- 2：通过 RoomId 封禁用户，最多可设置 200 条；
- 3：通过 UserId 封禁用户，最多可设置 200 条；
- 4：通过 RoomId 和 UserId 封禁用户，最多可设置 200 条。
Possible values: [SetForbidUserRule]
接口原型参数
https://rtc-api.zego.im?Action=SetForbidUserRule
💡公共参数。AppId，ZEGO 分配的用户唯一凭证。
💡公共参数。随机字符串。
💡公共参数。Unix 时间戳，单位为秒。最多允许 10 分钟的误差。
💡公共参数。签名，用于验证请求的合法性。
Possible values: [2.0]
Default value: 2.0
💡公共参数。签名版本号。
Possible values: [true, false]
Default value: false
💡公共参数。是否为测试环境。设为 true 表示使用测试环境。2021-11-16 及之前在 ZEGO 控制台创建的项目默认是测试环境，可根据业务需求设置此参数；而之后创建的项目默认是正式环境。
Possible values: [1, 2, 3, 4]
封禁规则类型：
其中，最多可设置的规则条数，指同时在有效期内的规则条数，不包含已失效的规则。
如果您不需要某些规则，请及时调用 删除用户封禁规则 接口进行清理。
IP 地址。RuleType 为 1 时必填。
房间 ID。RuleType 为 2、4 时必填。
用户 ID。RuleType 为 3、4 时必填。
Possible values: [1, 2], >= 1
封禁用户所能使用的功能。1：登录。2：推流。
Possible values: >= 1 and <= 86400
封禁规则有效时长，单位：秒，取值范围 1 ～ 86400（1 天）。
Responses
- 200
- application/json
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
Click the "Send" button above and see the response here!