封禁指定的直播流。
PATCH https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points/{entry_point}/admin/banned_streams/{stream_name}
参数 | 类型 | 描述 |
---|---|---|
appid |
String | 必填。在声网控制台获取的 App ID。 |
entry_point |
String | 必填。发布点名称。 |
stream_name |
String | 必填。要封禁的直播流名称。 |
请求包体为 JSON Object 类型,包含以下字段:
resumeTime
:String 型,选填。恢复流的时间,RFC3339 格式,例如:2018-1129T19:00:00+08:00
。默认恢复时间为封禁后 7 天。如果返回的 HTTP 状态码为 200,表示请求成功。
如果返回的 HTTP 状态码非 200,表示请求失败。你可以参考 HTTP 状态码了解可能的原因。
请求行
PATCH https://api.sd-rtn.com/v1/projects/{your_appid}/fls/entry_points/live/admin/banned_streams/{your_stream_name} HTTP/1.1
请求 body
{
"resumeTime": "2021-11-29T19:00:00+08:00"
}
响应行
HTTP/1.1 200 OK
取消封禁指定的直播流。
DELETE https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points/{entry_point}/admin/banned_streams/{stream_name}
参数 | 类型 | 描述 |
---|---|---|
appid |
String | 必填。在声网控制台获取的 App ID。 |
entry_point |
String | 必填。发布点名称。 |
stream_name |
String | 必填。要取消封禁的直播流名称。 |
如果返回的 HTTP 状态码为 200,表示请求成功。
如果返回的 HTTP 状态码非 200,表示请求失败。你可以参考 HTTP 状态码了解可能的原因。
请求行
DELETE https://api.sd-rtn.com/v1/projects/{your_appid}/fls/entry_points/live/admin/banned_streams/{your_stream_name} HTTP/1.1
响应行
HTTP/1.1 200 OK
获取指定发布点下所有被封禁的直播流的列表。
GET https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points/{entry_point}/admin/banned_streams
参数 | 类型 | 描述 |
---|---|---|
appid |
String | 必填。在声网控制台获取的 App ID。 |
entry_point |
String | 必填。发布点名称。 |
如果返回的 HTTP 状态码为 200,表示请求成功。响应包体中包含以下字段:
bannedStreamList
:JSON Array 型,已被封禁的直播流列表。一个直播流对应一个 JSON Object,包含以下字段:
字段 | 类型 | 描述 |
---|---|---|
name |
String | 流的名称。 |
resumeTime |
String | 恢复流的时间。 |
如果返回的 HTTP 状态码非 200,表示请求失败。你可以参考 HTTP 状态码了解可能的原因。
请求行
GET https://api.sd-rtn.com/v1/projects/{appid}/fls/entry_points/live/admin/banned_streams HTTP/1.1
响应行
HTTP/1.1 200 OK
响应 body
{
"bannedStreamList": [
{
"name": "{your_stream_namename1}",
"resumeTime": "2021-11-29T19:00:00+08:00"
},
{
"name": "{your_stream_name2}",
"resumeTime": "2021-11-28T19:00:00+08:00"
}
]
}
状态码 | 描述 |
---|---|
200 | 请求成功。 |
400 | appid 或者 entry_point 为空。 |
401 | 未经授权的(客户 ID/客户密钥匹配错误)。 |
404 | 服务器无法根据请求找到资源,即请求的发布点不存在,或者请求的 URI 路径非法。 |
500 | 服务器内部错误,无法完成请求。 |
504 | 服务器内部错误。充当网关或代理的服务器未从远端服务器获取请求。 |