> For the complete documentation index, see [llms.txt](https://polyv.gitbook.io/document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://polyv.gitbook.io/document/docs/unclassified/2021/b8181d9fea4220a3e907e55805565623.md).

# 修改播放域名限制设置

### 接口URL

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

### 接口说明

```
修改播放域名限制
```

### 支持格式

```
JSON
```

### 请求方式

```
POST
```

### 请求参数

| 参数名         | 必选 | 类型及范围  | 说明                                                                                                                       |
| ----------- | -- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
| userid      | 是  | string | 用户ID，需把实际的userid值替换url中的{userid}                                                                                         |
| ptime       | 是  | long   | 当前时间的毫秒级时间戳（13位），3分钟内有效                                                                                                  |
| sign        | 是  | String | 签名，为40位大写的SHA1值【详见[签名生成规则](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/buildSign/README.md)】 |
| settingType | 是  | int    | 限制类型，0：无域名限制，1：黑名单，2：白名单，3：白名单和黑名单复合限制                                                                                   |
| host        | 否  | string | 域名配置，多个域名以英文逗号分隔，此参数仅在settingType值为1和2时且不为null时有效，最多配置5个域名                                                               |

### 返回正确结果JSON示例

```json
{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": "修改成功."
}
```

### 返回错误结果JSON示例

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

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

### 字段说明

| 字段      | 类型     | 说明   |
| ------- | ------ | ---- |
| code    | int    | 返回码  |
| status  | string | 返回状态 |
| message | string | 返回信息 |
| data    | object | 操作结果 |

#### java请求示例：

```java
    public void testUpdatePlayDomainLimitSetting() throws Exception {
	String url = "https://api.polyv.net/v2/play/{userid}/domain";
        Map<String, String> params = new HashMap<>();
        params.put("userid", userid);
        params.put("ptime", String.valueOf(System.currentTimeMillis()));
        int settingType = 1;
        params.put("settingType", String.valueOf(settingType));
        params.put("host", "a.com,b.com");
        params.put("sign", getSign(params, secretkey));
        String response = HttpClientUtil.getInstance().sendHttpPost(url, params);
        System.out.println(response);
    }
```