# 管理频道和用户 (/zh-CN/realtime-media/rtc/build/security-and-auth/channel-management)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
为方便开发者从服务端管理实时音视频频道,声网提供了集成简单、安全可靠的服务端 RESTful API。
具体的功能和适用场景如下:
| 主要功能 | 功能描述 | 典型适用场景 |
| --- | --- | --- |
| 管理用户权限 | 通过调用 RESTful API 管理用户的权限,包括将指定用户移出频道、禁止指定用户发送音频流、禁止指定用户发送视频流。 | [channel-management-restful-html-0-1-2 details](#table-slot-channel-management-restful-html-0-1-2) |
| 查询在线频道信息 | 通过调用 RESTful API 查询在线频道列表、频道内的用户列表、指定用户的状态。 | [channel-management-restful-html-0-2-2 details](#table-slot-channel-management-restful-html-0-2-2) |
**channel-management-restful-html-0-1-2 details**
需要在业务服务端管理用户权限的场景,例如:
- 直播中出现未经认证的用户。
- 直播中出现炸房捣乱的用户。
- 向客户端下发的信令消息被劫持。
- 用户异常掉线,导致用户列表无法及时更新。
**channel-management-restful-html-0-2-2 details**
- 在频道并发量不大的场景下,直接查询项目下的频道列表以同步频道状态。
- 在同步实时性要求不高的场景下,查询并同步频道内的用户列表和状态。
## 前提条件 [#前提条件]
- 有效的声网开发者账号和声网控制台项目。详见[开通 RTC 服务](/zh-CN/realtime-media/rtc/build/setup-and-access/enable-service)。
- 已经[实现 HTTP 基本认证](/zh-CN/realtime-media/rtc/build/setup-and-access/http-basic-auth)。
## 实现方法 [#实现方法]
所有频道管理 RESTful API 都通过 `http://api.sd-rtn.com` 访问。以[查询项目的频道列表](/zh-CN/api-reference/api-ref/rtc/query-channel-list)为例,在实现 HTTP 基本认证后,添加以下高亮区域的代码即可发送一个简单的请求,获取频道总数和每个频道内的用户人数:
```java
public class Base64Encoding {
public static void main(String[] args) throws IOException, InterruptedException {
// 客户 ID
// 需要设置环境变量 AGORA_CUSTOMER_KEY
final String customerKey = System.getenv("AGORA_CUSTOMER_KEY");
// 客户密钥
// 需要设置环境变量 AGORA_CUSTOMER_SECRET
final String customerSecret = System.getenv("AGORA_CUSTOMER_SECRET");
// App ID
// 需要设置环境变量 AGORA_APP_ID
final String appid = System.getenv("AGORA_APP_ID");
// 拼接客户 ID 和客户密钥并使用 base64 编码
String plainCredentials = customerKey + ":" + customerSecret;
String base64Credentials = new String(Base64.getEncoder().encode(plainCredentials.getBytes()));
// 创建 authorization header
String authorizationHeader = "Basic " + base64Credentials;
// highlight-start
HttpClient client = HttpClient.newHttpClient();
// 创建 HTTP 请求对象
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("http://api.sd-rtn.com/dev/v1/channel/" + appid))
.GET()
.header("Authorization", authorizationHeader)
.header("Content-Type", "application/json")
.build();
// 发送 HTTP 请求
HttpResponse response = client.send(request,
HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
// 添加后续对响应内容的处理逻辑
// highlight-end
}
}
```
你可以参考 API 文档查看每个频道管理 RESTful API 的详情,其中包含了多种语言的示例代码:
- [封禁用户权限](/zh-CN/api-reference/api-ref/rtc/create-ban-rule)
- [查询在线频道消息](/zh-CN/api-reference/api-ref/rtc/query-user-status)
## 更多功能 [#更多功能]
你可以根据业务需求,将频道管理 RESTful API 和[消息通知服务](/zh-CN/realtime-media/rtc/build/optimize-and-operate/receive_webhook)结合使用,实现稳定可靠、实时有效的频道管理和状态同步。
## 相关文档 [#相关文档]
- [封禁用户权限](/zh-CN/realtime-media/rtc/build/security-and-auth/user-privilege):了解封禁用户权限 API 的使用原则、适用场景、不适用场景以及接口调用异常处理的最佳实践。
- [保障 REST 服务高可用](/zh-CN/realtime-media/rtc/build/optimize-and-operate/rest-availability):如何避免因区域网络故障造成的服务不可用。