文档中心
服务端 API v2
媒体服务接口
查询被禁止 CDN 推流的列表

查询被禁止 CDN 推流的列表

更新时间：2025-04-15 17:17

1 描述

调用本接口查询已被禁止推流到 CDN 的 URL 列表。

首次使用本接口，需要联系 ZEGO 技术支持进行配置。

2 接口原型

请求方法：GET
请求地址：https://rtc-api.zego.im/?Action=QueryForbidCDNLiveStream
传输协议：HTTPS
调用频率限制：20 次/秒

3 请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表请参考调用方式中的 “2.1 公共请求参数”。

参数	类型	是否必选	描述
Vendor	String	是	CDN 提供商，ws：网宿。

4 请求示例

https://rtc-api.zego.im/?Action=QueryForbidCDNLiveStream
&Vendor=ws
&<公共请求参数>

5 响应参数

参数	类型	描述
Code	Number	返回码。
Message	String	操作结果描述。
RequestId	String	请求 ID。
Data	Object	响应数据。
Ws	Object	网宿返回的查询结果。
ResultDetail	Array of Object	查询结果的集合。
Channel	String	加速域名。
Url	String	被禁止推流的 CDN 直播地址的完整 URL，例如，rtmp://publish-ws.zegotech.cn/test/流 ID。
StartTime	String	开始禁止推流的时间，UTC 时间。
EndTime	String	恢复推流的时间，UTC 时间。
Ip	String	禁止观看直播的用户 IP（已废弃）。

6 响应示例

{
    "Code": 0,
    "Message": "success",
    "RequestId": "",
    "Data": {
        "Ws": {
            "ResultDetail": [
                {
                    "Channel": "publish-ws.zegotech.cn",
                    "Url": "rtmp://publish-ws.zegotech.cn/test/stream001",
                    "StartTime": "2024-10-12T03:47:53Z",
                    "EndTime": "2024-11-11T03:47:53Z",
                    "Ip": ""
                },
                {
                    "Channel": "publish-ws.zegotech.cn",
                    "Url": "rtmp://publish-ws.zegotech.cn/test/steram002",
                    "StartTime": "2024-10-12T02:48:15Z",
                    "EndTime": "2024-10-14T02:22:00Z",
                    "Ip": ""
                }
            ]
        }
    }
}

7 返回码

以下仅列出了常见的接口业务逻辑相关的返回码，完整返回码请参考全局返回码。

返回码	说明	处理建议
0	请求成功。	-
1	请求失败。	-
2	参数错误。	-
3	鉴权失败。	请检查鉴权参数是否正确。