设置播放域名黑白名单

更新时间：2022-09-02 18:08:07

接口描述

1、设置播放域名为黑名单或者白名单
2、接口支持https协议

接口URL

http://v.polyv.net/uc/services/rest?method=saveHostUrl

在线API调用

请求方式

POST

接口约束

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

请求参数描述

参数名	必选	类型	说明
writetoken	true	String	POLYV用户的点播写密钥，和保利威官网一致，获取路径：官网->登录->云点播（api接口）
host	true	String	host字符串，用英文逗号隔开，例如：`www.baidu.com,www.163.com`
settingType	true	String	设置类型 1：黑名单 2：白名单

示例

http://v.polyv.net/uc/services/rest?method=saveHostUrl

表单参数：

writetoken=f9810825-7512-476d-95ec-9ff2968df5de&host=www.baidu.com&settingType=2

响应参数描述

参数名	类型	说明
error	String	请求成功返回0，请求失败返回错误代码【详见返回错误代码列表】

返回错误代码列表

返回	说明
0	无错误
1	找不到writetoken关联的user
2	文件为空或者writetoken为空
3	提交的json名字JSONRPC为null
4	提交文件格式不正确
5	readtoken为空
6	分页输入出错
7	vid不能为空
8	找不到方法名

Java请求示例

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

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

private static final Logger log = LoggerFactory.getLogger(VodVideoDomainRestrictTest.class);

/**
 * 设置播放域名黑白名单
 */
@Test
public void testSetDomainRestrict() throws Exception, NoSuchAlgorithmException {
        //业务参数
        String url = "http://v.polyv.net/uc/services/rest?method=saveHostUrl";
        String writeToken = super.writeToken;
        String host = "www.baidu.com";
        String settingType = "2";

        Map<String, String> requestMap = new HashMap<>();
        requestMap.put("writetoken", writeToken);
        requestMap.put("host", host);
        requestMap.put("settingType", settingType);
        String response = HttpUtil.postFormBody(url, requestMap);
        log.debug("测试设置播放域名黑白名单,{}", response);
        //do somethings
}

响应示例

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

成功示例

{
  "error": "0"
}

异常示例

{
    "error": "2"
}

点播服务器 API