接口URL
http://api.polyv.net/live/v3/channel/advert/list
接口说明
1、提供获取频道轮播广告列表信息,频道广告为空时,获取全局广告
2、支持https
支持格式
JSON
请求方式
GET
请求参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
appId | 是 | string | 账号应用下的appId |
timestamp | 是 | string | 当前时间的秒级时间戳(13位) |
sign | 是 | string | 签名,为32位大写的MD5值 |
channelId | 是 | int | 频道号 |
操作成功响应示例
{
"code": 200,
"status": "success",
"message": "",
"data": [
{
"text": "",
"img": "//liveimages.videocc.net/uploaded/images/2019/09/ffmgstpk58.png",
"href": ""
},
{
"text": "123445",
"img": "",
"href": ""
}
]
}
操作失败响应示例
签名错误
{
"code": 403,
"status": "error",
"message": "invalid signature.",
"data": ""
}
缺少参数 channelId
{
"code": 400,
"status": "error"
"message": "param should not be empty: channelId",
"data": ""
}
响应字段说明
名称 | 类型 | 说明 |
---|---|---|
code | string | 响应代码,成功为200,失败为400,签名错误为403,异常错误500 |
status | string | 成功为success,失败为error |
message | string | 错误时为错误提示消息 |
data | object[] | 成功响应数据 |
text | string | 文本广告内容 |
img | string | 图片广告链接 |
href | string | 跳转链接 |
php请求示例
<?php
//引用config.php
include 'config.php';
$params = array(
'appId' => $appId,
'timestamp' => $timestamp,
'channelId' => 206204
);
//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;
//接口请求url
$url = "https://api.polyv.net/live/v3/channel/advert/list?appId=".$appId."&sign=".$sign."×tamp=".$timestamp."&channelId=".$channelId;
//输出接口请求结果
echo file_get_contents($url);
?>