查询广告列表

接口描述

1、分页获取广告列表详情
2、接口URL中的{userid}为点播账号userid，具体参考菜单【使用须知】->【获取密钥】
3、接口支持https协议

接口URL

http://api.polyv.net/v2/advertising/{userid}/list

在线API调用

请求方式

GET

接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，详细请查看

请求参数描述

示例

http://api.polyv.net/v2/advertising/1b448be323/list?sign=06423AE4F3EE1959F29E5723A43F731897B0B6F8&pageSize=1&page=1&ptime=1617777684134

响应参数描述

Data参数描述

Contents参数描述

返回错误代码列表

Java请求示例

快速接入基础代码请下载相关依赖源码， 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 VodSignUtil.java 都包含在下载文件中。

强烈建议您使用点播Java SDK完成API的功能对接，点播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。

private static final Logger log = LoggerFactory.getLogger(VodVideoAdvertising.class);
/**
 *  查询广告列表
 */
@Test
public void testGetAdvertising() throws Exception, NoSuchAlgorithmException {
    //公共参数,填写自己的实际参数
    String secretKey = super.secretKey;
    String userid = super.userId;
    String ptime = String.valueOf(System.currentTimeMillis());
    //业务参数
    String url = String.format("http://api.polyv.net/v2/advertising/%s/list", userid);
    String page = "1";
    String pageSize = "2";

    Map<String, String> requestMap = new HashMap<>();
    requestMap.put("ptime", ptime);
    requestMap.put("page", page);
    requestMap.put("pageSize", pageSize);
    requestMap.put("sign", VodSignUtil.getSign(requestMap, secretKey));

    String response = HttpUtil.get(url, requestMap);
    log.debug("测试查询广告列表,{}", response);
    //do somethings

}

响应示例

系统全局错误说明详见全局错误说明

成功示例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": {
        "pageNumber": 1,
        "totalItems": 18,
        "contents": [{
            "adid": "ea7a04430dd04d01853d",
            "title": "测试广告(Junit测试,勿删)",
            "note": "测试广告描述",
            "userid": "1b448be323",
            "location": "1",
            "matterurl": "/1b448be323/html/adv/image/1/1b448be323/thumb/5439a04e5f6c40a290822eb4b2d3086c.jpg",
            "size": 2,
            "addrurl": "https://baidu.com",
            "isstatis": 2,
            "cpmplay": 0,
            "desccpmplay": 1200,
            "playnum": 0,
            "uptime": -28800000,
            "offtime": 57599000,
            "startdate": 1616342400000,
            "enddate": 1619020800000,
            "province": "all",
            "country": "",
            "ptime": 1619740895366,
            "status": 0,
            "width": 0,
            "height": 0,
            "doublenum": 0,
            "errornum": 0,
            "popuptime": null,
            "poplocation": -1,
            "cataids": "1",
            "skiptime": 1,
            "skipbutton": "跳过广告",
            "skipenabled": "Y",
            "cataname": "视频",
            "advurl": "http://img.videocc.net/1b448be323/html/adv/image/1/1b448be323/thumb/5439a04e5f6c40a290822eb4b2d3086c.jpg"
        }, {
            "adid": "db56c968c10e4c76a758",
            "title": "测试广告-弹窗",
            "note": "测试广告描述",
            "userid": "1b448be323",
            "location": "4",
            "matterurl": "/1b448be323/html/adv/image/1/1b448be323/thumb/2373551d8e4841be88a4860d8b52ea3d.jpg",
            "size": 2,
            "addrurl": null,
            "isstatis": 2,
            "cpmplay": -1,
            "desccpmplay": 0,
            "playnum": 0,
            "uptime": -28800000,
            "offtime": 57599000,
            "startdate": 1616342400000,
            "enddate": 1619020800000,
            "province": null,
            "country": null,
            "ptime": 1619418030516,
            "status": 10,
            "width": 0,
            "height": 0,
            "doublenum": 0,
            "errornum": 0,
            "popuptime": "2",
            "poplocation": 4,
            "cataids": "1",
            "skiptime": 1,
            "skipbutton": "跳过广告",
            "skipenabled": "N",
            "cataname": "视频",
            "advurl": "http://img.videocc.net/1b448be323/html/adv/image/1/1b448be323/thumb/2373551d8e4841be88a4860d8b52ea3d.jpg"
        }],
        "nextPageNumber": 2,
        "prePageNumber": 1,
        "startRow": 1,
        "activePageNum": 1,
        "firstPage": true,
        "lastPage": false,
        "totalPages": 9,
        "endRow": 2,
        "limit": 2,
        "offset": 0
    }
}

异常示例

{
  "code": 400,
  "status": "error",
  "message": "ptime is too old.",
  "data": ""
}