视频禁播与解禁

接口URL

https://api.polyv.net/v2/video/{userid}/forbidden

接口说明

(接口调用有频率限制,详细请查看)

用于禁止、解禁播放视频,禁播后会将视频状态(status)设置成53,一次最多只能操作500个vid
支持https
注意点:
  只能修改“已发布”状态的视频为禁播状态,
  只能修改“已禁播”状态的视频为已发布状态,
  当请求中的vid包含多种状态时,只对符合条件的vid进行状态修改操作,并返回成功;若没有符合条件的vid则返回错误。

返回结果支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
ptime true long 13位的当前时间毫秒级时间戳
sign true string 签名
userId true string userId,路径参数
vids true string 视频vid,多个视频以英文逗号分隔,如a2dc4f25179499d6586362672838cc2d_a,a2dc4f25179499d6586362672838cc2d_a 一次最多只能传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";
        url = String.format(url, userId);
        Map<String, String> params = new HashMap<>();
        params.put("vids", "xxxxxx,xxxxxx");
        long ptime = System.currentTimeMillis();
        params.put("ptime", String.valueOf(ptime));
        params.put("forbidden", "1");
        params.put("sign", getSign(params, secretkey));
        String response = HttpClientUtil.getInstance().sendHttpPost(url, params);
        System.out.println(response);
    }
}

点播API签名规则

https://dev.polyv.net/2020/videoproduct/v-api/v-api-signs/vod-sign/

通用工具类

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...