上传多个视频的预览图URL

接口URL

http://api.polyv.net/v2/video/{userid}/uploadCoverImageUrl

接口说明

将url地址对应的图片更换到视频预览图上,图片资源不支持https的协议

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前时间的毫秒级时间戳(13位),30分钟内有效
userid true string 用户id(拼接在url,无需另外传参数)
sign true string 签名
vids false string 多个视频id用逗号隔开
cataids false string 多个分类id用逗号隔开
fileUrl true string 图片url地址

参数使用:

当传了vids参数,以vids为准,当vids不传,以cataids为准,两个参数不能同时为空。

注意事项

所有有值的参数,按照字母排序方式以key=value&key=value的格式串起来,最后拼上secretkey,以SHA-1方式加密并全部大写化。(注意,当参数没有传递,或者传递了空值,sign不需要将此参数计算进去)

例如:api传递了ptime,vid。ptime为1,vid为test1,userid对应用户的secretkey为test2
则sign的值为:ptime=1&vid=test1test2经过SHA-1加密后大写化为: C2B1558D697EA3AF4ED2FC90152751860C1E2163。

返回错误结果JSON示例

{
  "code": 400,
  "status": "error",
  "message": "ptime is too old.",
  "data": ""
}

返回正确结果JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": "上传成功."
}

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 操作结果

响应代码与响应信息对应

code message 说明
400 sign can not be empty.
400 ptime is too old.
400 ptime is illegal. ptime超出当前时间3分钟
400 Could not find user by userid.
400 the sign is not right.
412 vids不能为空.
413 上传失败. 上传到服务器出错
500 上传失败,请查看日志. 后台抛异常
200 success. 上传成功

php上传示例:

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
$vids="382839019131be68715e9455f8d0971a_3";
$fileUrl="http://test.jpg";
$ptime=time()*1000;//13位
$secretkey="tIQp4ATe9Z";
$str="fileUrl=".$fileUrl."&ptime=".$ptime."&vids=".$vids.$secretkey;
//echo $str.'';
$hash=strtoupper(sha1($str));
//echo $hash.'';
$url="http://api.polyv.net/v2/video/{$userid}/uploadCoverImageUrl";
$post_data = array (
    "vids" => $vids,
    "fileUrl" => $fileUrl,
    "ptime" => $ptime,
    "sign" => $hash,
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
// post数据
curl_setopt($ch, CURLOPT_POST, 1);
// post的变量
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上secretkey,生成40位大写SHA1值,作为sign。 以下是示例过程:

1、请求参数为

"ptime" = "1493188350000"
"vid" = "3828390191de2b3fd3467c36187aac08_3"

2、将请求参数按照参数名字典顺序排列

"ptime" = "1493188350000"
"vid" = "3828390191de2b3fd3467c36187aac08_3"

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(secretkey的值为tIQp4ATe9Z),如下:

ptime=1493188350000&vid=3828390191de2b3fd3467c36187aac08_3tIQp4ATe9Z

4、生成签名sign

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