接口URL
https://api.polyv.net/v2/video/{userid}/forbidden
接口说明
(接口调用有频率限制，详细请查看)
用于禁止、解禁播放视频，禁播后会将视频状态（status）设置成53，一次最多只能操作500个vid
支持https
注意点：
只能修改“已发布”状态的视频为禁播状态，
只能修改“已禁播”状态的视频为已发布状态，
当请求中的vid包含多种状态时，只对符合条件的vid进行状态修改操作，并返回成功；若没有符合条件的vid则返回错误。
返回结果支持格式
JSON
请求方式
POST,GET
请求数限制
TRUE
请求参数
| 参数名 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| ptime | true | long | 13位的当前时间毫秒级时间戳 |
| sign | true | string | 签名 |
| userId | true | string | userId，路径参数 |
| vids | true | string | 视频vid，多个视频以英文逗号分隔，如xxx,xxx，一次最多只能传500个vid |
| forbidden | true | int | 1：禁播，0：解禁 |
返回结果
{
"code": 200,
"status": "success",
"message": "success",
"data": ""
}
请求失败返回json示例
签名错误
{
"code": 400,
"status": "error",
"message": "the sign is not right.",
"data": ""
}
时间戳过期
{
"code": 400,
"status": "error",
"message": "ptime is too old",
"data": ""
}
一次最多只能操作500个vid
{
"code": 400,
"status": "error",
"message": "vid count can't over 500",
"data": ""
}
只能修改“已发布”状态的视频为禁播状态
{
"code": 400,
"status": "error",
"message": "只能修改“已发布”状态的视频为禁播状态",
"data": ""
}
只能修改“已禁播”状态的视频为已发布状态
{
"code": 400,
"status": "error",
"message": "只能修改“已禁播”状态的视频为已发布状态",
"data": ""
}
字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 请求返回状态码 |
| status | string | 请求返回状态 |
| message | string | 请求返回信息 |
| data | string | 请求返回数据 |
Java示例代码
public class Test {
public static void main(String[] args) throws Exception {
String userId = "xxxxxx";
String secretkey = "xxxxxxx";
String url = "https://api.polyv.net/v2/video/%s/forbidden";
Map<String, String> maps = new HashMap<>();
maps.put("vids", "xxxxxx,xxxxxx");
maps.put("forbidden", String.valueOf(1));
maps.put("sign", getSign(maps, secretkey));
url += "?" + buildUrl(maps);
url = String.format(url, userId);
HttpClient client = new HttpClient();
GetMethod getMethod = new GetMethod(url);
client.executeMethod(getMethod);
System.out.println(url);
System.out.println(getMethod.getResponseBodyAsString());
}
public static String buildUrl(Map<String, String> maps) {
List<String> tmp = new ArrayList<>();
for (Map.Entry<String, String> key : maps.entrySet()) {
tmp.add(key.getKey() + "=" + key.getValue());
}
return String.join("&", tmp);
}
}
Loading...