設定播放網域名稱黑白名單

更新時間：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"
}