CDN

产品文档

CDN

帮助中心 > 产品文档 > CDN > 查询禁播流列表

查询禁播流列表

1. 描述

查询某段时间内禁播流列表(queryForbidden)

2. 请求参数

名称 类型 是否必填 描述
username String 京东用户名pin
signature String 用户签名,通过md5的方式校验用户的身份信息,保障信息安全。md5=日期+username+秘钥SecretKey; 日期:格式为 yyyymmdd; username:京东用户名pin; 秘钥:双方约定; 示例:比如当前日期2016-10-23,用户pin:jcloud_00,用户秘钥SecretKey:e7a31b1c5ea0efa9aa2f29c6559f7d61,那签名为MD5(20161023jcloud_00e7a31b1c5ea0efa9aa2f29c6559f7d61)
domain String 禁播域名,目前只支持单域名
app String 发布点,目前支持单发布点的查询,不支持同时查询多个,当不输入app,只输入域名时,查询结果为该域名下的所有禁播流
stream String 流名,支持多个流名的查询,以英文字母分割,如stream1, stream2;输入流名时必须输入app
start_time String 查询开始时间,时间格式:yyyy-mm-dd hh:mi;没有输入开始时间时默认为今天;有开始时间没有结束时间默认为开始时间到当前时间;无开始有结束时间,以结束时间的天单位的0点作为开始时间,如如结束时间是20180529 14:29,开始时间为20180529 00:00
end_time String 查询结束时间,时间格式:yyyy-mm-dd hh:mi;
pageNumber int 查询分页页码,不传默认为1
pageSize int 查询分页条数,不传默认10条

3. 返回参数

名称 描述
status 表示接口请求成功与否,成功用0表示,其他表示失败,
msg 提示信息
data 域名信息数组
total 该域名下禁播流总数
streams 禁播流列表
app 禁播app
stream 禁播stream
type 禁播类型[1:永久封禁,2:限时封禁]
typeDes 禁播类型描述
startTime 查询开始时间
endTime 查询结束时间
time 限时封禁时的禁播时长

4. 调用示例

  • 请求地址

https://opencdn.jcloud.com/api/live/queryForbidden

  • 请求示例

https://opencdn.jcloud.com/api/live/queryForbidden

{
    "username" :"jd_cdntest",
    "signature" :"5fdd933ad652298f9f0fd4c87883e283",
    "domain" :"wshplay-113.live.com",
    "app":"live",
    "stream":"shitest1",
    "pageNumber":1,
    "pageSize":"100",
    "start_time" :"2018-05-31 00:05",
    "end_time" :"2018-06-01 21:49"
 }
-
**返回示例**
  • json格式
{
    "status": 0,
    "msg": "成功",
    "data": {
        "total": 1,
        "streams": [
            {
                "app": "live",
                "stream": "shitest1",
                "type": 2,
                "typeDes": "限时封禁",
                "startTime": "2018-06-01 15:41:23",
                "endTime": "2018-06-01 15:46:23",
                "time": 5
            }
        ]
    }
}
更新时间:2019-05-28 11:29:17