保利威文档中心

帮助中心

获取播放域名限制设置

更新时间: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);
    }
联系客服,在线咨询