取得播放網域限制設定

更新時間：2022-05-23 19:02:59

介面URL

https://api.polyv.net/v2/play/{userid}/domain

介面說明

取得播放網域限制

支援格式

JSON

請求方式

GET

請求參數

參數名	必填	類型及範圍	說明
userid	是	string	使用者ID，需將實際的userid值替換url中的{userid}
ptime	是	long	當前時間的毫秒級時間戳（13位），3分鐘內有效
sign	是	String	簽名，為40位大寫的SHA1值【詳見簽名生成規則】

返回正確結果JSON範例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": {
        "userid": "a2dc4f2517",
        "settingType": 2,
        "enableHost": "a.com,b.com",
        "disableHost": "c.com,d.com"
    }
}

返回錯誤結果JSON範例

签名不正确
{
    "code":400,F
    "status":"error",
    "message":"the sign is not right",
    "data":""
}

时间戳过期
{
    "code":400,
    "status":"error",
    "message":"ptime is too old.",
    "data":""
}

欄位說明

欄位	類型	說明
code	int	回傳碼
status	string	回傳狀態
message	string	回傳資訊
data	object	操作結果
userid	string	使用者ID
settingType	int	限制類型，0：無網域限制，1：黑名單，2：白名單，3：白名單和黑名單複合限制
disableHost	string	禁止播放的網域（黑名單），多個網域以英文逗號分隔，在settingType = 1時有效
enableHost	string	可以播放的網域（白名單），多個網域以英文逗號分隔，在settingType = 2時有效

java請求範例：

    public void testGetPlayDomainLimitSetting() throws Exception {
        String url = "/v2/play/{userid}/domain";
        Map<String, String> params = new HashMap<>();
        params.put("userid", userid);
        params.put("ptime", String.valueOf(System.currentTimeMillis()));
        params.put("sign", getSign(params, secretkey));
        String response = HttpClientUtil.getInstance().sendHttpGet(url + "?" + PolyvTool.mapJoinNotEncode(params));
        System.out.println(response);
    }