接口URL
http://api.polyv.net/v2/video/{userid}/watermarkSetting
接口说明
(接口调用有频率限制,详细请查看)
上传某一级分类或用户级别的视频水印
返回结果支持格式
JSON
请求方式
POST
请求数限制
TRUE
请求参数
参数名 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
image | true | File | 上传的图片 |
cataid | false | string | 分类ID,仅一级分类能设置水印。不传为设置用户级别的水印 |
watermarkLocation | false | string | 水印显示的位置:1:左上角;2:右上角;3:左下角;4:右下角;0:不显示水印 |
sign | true | string | 签名,40位大写的sha1值 |
ptime | true | string | 当前13位毫秒级时间戳,3分钟内有效 |
JSON示例
{
code: 200,
status: "success",
message: "success",
data: true
}
返回错误json
{
"code":400,
"status":"error",
"message":"sign can not be empty.",
"data":""
}
PHP示例代码
<?php
$userid="2d939377c2";
$cataid="1458806129324";
$watermarkLocation="1";
$ptime=time()*1000;
$secretkey="3OmoLbTlHu";
$str="cataid=$cataid&ptime=$ptime&watermarkLocation=$watermarkLocation".$secretkey;
echo $str;
$sign=strtoupper(sha1($str));
?>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>上传PPT</title>
</head>
<body>
<form action="http://api.polyv.net/v2/video/<?php echo $userid; ?>/watermarkSetting" method="post" enctype='multipart/form-data'>
<input type="hidden" name="ptime" value="<?php echo $ptime; ?>">
<input type="hidden" name="vid" value="<?php echo $vid; ?>">
<input type="hidden" name="sign" value="<?php echo $sign; ?>">
ppt:<input type="file" name="image" id="fileupload1" /><br>
<input type="submit" value="点击上传"/>
</form>
</body>
</html>
签名规则
将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上secretkey,生成40位大写SHA1值,作为sign。 以下是示例过程:
1、请求参数为
"ptime" = "1493188350000"
"cataid" = "3828390191de2b3fd3467c36187aac08_3"
"watermarkLocation"="1"
2、将请求参数按照参数名字典顺序排列
"cataid" = "3828390191de2b3fd3467c36187aac08_3"
"ptime" = "1493188350000"
"watermarkLocation"="1"
3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(secretkey的值为3OmoLbTlHu),如下:
cataid=1458806129324&ptime=1527144074000&watermarkLocation=13OmoLbTlHu
4、生成签名sign
4B3AA5AF743DD3D4A0D2978225A5CA4BBE2F957A