接口URL
http://api.polyv.net/v2/video/{userid}/updateCataProfile
接口说明
(接口调用有频率限制,详细请查看)
设置某一级分类的分类属性
返回结果支持格式
JSON
请求方式
GET,POST
请求数限制
TRUE
请求参数
参数名 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
ptime | true | string | 当前13位毫秒级时间戳,3分钟内有效 |
sign | true | string | 签名,40位大写的sha1值 |
cataid | true | string | 分类ID,仅能设置一级分类的属性 |
isSettings | false | string | 是否启用设置,Y为开启,N为关闭 |
keepSource | false | string | 源文件播放,1为开启,0为关闭;开启时不对视频进行转码(仅对新上传视频有效) |
encrypt | true | string | 视频加密设置开关(仅对新上传视频有效), "1"为打开,"0"为关闭 |
hlslevel | false | string | 移动端加密设置,有效取值为 open: 非加密授权;web: WEB授权;app: APP授权;wxa_app:小程序授权 |
isEdu | false | string | 视频优化,1为开启,0为关闭(仅对新上传视频生效) |
encode_aac | false | string | 生成音频文件,1为开启,0为关闭(该功能只对部分有权限用户开放,且只对新上传视频生效) |
JSON示例
{
code: 200,
status: "success",
message: "success",
data: true
}
返回错误json
{
"code":400,
"status":"error",
"message":"sign can not be empty.",
"data":""
}
PHP示例代码
<?php
$userid="efbb4ae8ac";
$secretkey= "hbjCVBhnth";
$cataid="1524732771473";
$ptime=time()*1000;
$isSettings="Y";
$encrypt="0";
$keepSource="1";
$hlslevel="open";
$isEdu="1";
$encode_aac="1";
$str="encrypt=$encrypt&cataid=$cataid&encode_aac=$encode_aac&hlslevel=$hlslevel&isEdu=$isEdu&isSettings=$isSettings&keepSource=$keepSource&ptime=$ptime".$secretkey;
$url="http://api.polyv.net/v2/video/$userid/updateCataProfile?ptime=$ptime&sign=$sign&encrypt=$encrypt&cataid=$cataid&encode_aac=$encode_aac&hlslevel=$hlslevel&isEdu=$isEdu&isSettings=$isSettings&keepSource=$keepSource";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$output = curl_exec($ch);
curl_close($ch);
print_r($output);
?>
签名规则:
将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上secretkey,生成40位大写SHA1值,作为sign。 以下是示例过程:
1、请求参数为
"cataid"="1458806129324";
"ptime"=time()*1000;
"encrypt"="0";
"keepSource"="1";
2、将请求参数按照参数名字典顺序排列
"encrypt"="0";
"cataid"="1458806129324";
"keepSource"="1";
"ptime"=time()*1000;
3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(secretkey的值为3OmoLbTlHu),如下:
encrypt=0&cataid=1458806129324&keepSource=1&ptime=15271306190003OmoLbTlHu
4、生成签名sign
46AB1D55BA562AE7E573820EEB7E33BC2F1A7374