暂停并延迟恢复

最近更新时间:2020-08-31 09:57:48

我的收藏

1.接口描述

接口channel_manager:暂停推流并延迟恢复接口。
地址 API 调用地址为:http://fcgi.video.qcloud.com/common_access
用途 当某些原因不允许主播推流时,可调用此接口。
说明 调用该接口可以暂停推某路流(即禁止推流),如果要恢复主播推流,可再次调用该接口或者设置一个恢复时间,到达指定时间后允许推流,最长禁止推流3个月,即禁止推流截止时间最长为当前时间往后3个月,如果超过3个月,则以3个月为准。

2.输入参数

参数名
参数含义
类型
备注
是否必需
appid
客户 ID
int
即直播 appid,用于区分不同客户的身份
Y
interface
接口名称
string
channel_manager
Y
t
int
UNIX 时间戳
Y
sign
string
MD5(key+t)
Y
Param.s.channel_id
直播码
string
-
Y
Param.n.abstime_end
禁播截止的时间戳
int
禁播截止的绝对时间,请填写 UNIX 时间戳(十进制),系统最多禁播三个月
Y
Param.s.action
动作
string
断流:forbid;恢复推流:resume
Y
Param.s.path
路径
string
多路径用户使用
N
Param.s.domain
域名
string
多域名用户使用
N

3.输出结果

参数名
参数含义
类型
备注
ret
返回码
int
0:成功;其他值:失败
message
错误信息
string
错误信息

4.调用示例

目标:考虑到直播码为 8888_test123 的直播流内容涉及违规内容,对其进行禁播操作。
组成部分
示例内容
接口 URL
http://fcgi.video.qcloud.com/common_access?
appid
1250000000
interface
channel_manager
Param.s.channel_id
8888_test123
Param.n.abstime_end
1499756910
t
1471850187
sign
b17971b51ba0fe5916ddcd96692e9fb3
Param.s.action
resume
// copy时请去掉美化排版用的不可见换行符,否则可能出现 “appid is invalid” 等url拼装错误
URL = http://fcgi.video.qcloud.com/common_access?
appid=1250000000
&interface=channel_manager
&Param.s.channel_id=8888_test123
&Param.n.abstime_end=1499756910
&t=1471850187
&sign=b17971b51ba0fe5916ddcd96692e9fb3
     &Param.s.action=resume