上传多个视频的预览图

点击这里查看旧版

接口URL

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

接口说明

上传一张本地图片作为多个视频或多个分类的预览图

支持格式

JSON

请求方式

POST

请求参数

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

参数使用:

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

注意事项

所有有值的参数,按照字母排序方式以key=value&key=value的格式串起来,最后拼上secretkey,以SHA-1方式加密并全部大写化。(注意,当参数没有传递,或者传递了空值,sign不需要将此参数计算进去,图片参数也无需算入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.
410 图片不能为空且图片大小不能为0.
411 图片必须为gif,jpg,bmp,png格式.
412 vids不能为空.
413 上传失败. 上传到服务器出错
500 上传失败,请查看日志. 后台抛异常
200 success. 上传成功

表单上传示例:

<form action="http://api.polyv.net/v2/video/3828390191/uploadCoverImage" method="post" enctype='multipart/form-data' >
    vids:<input type="input" id="vids" name="vids" value="test1,test2">
    <!-- 当前毫秒级别的时间戳 -->
    ptime:<input type="input" id="ptime" name="ptime" value="">
    <!-- sign = hex_sha1("cataids="+cataids+"&ptime="+ptime+"&vids="+vids+secretkey).toUpperCase(); 具体规则请看下面的规则 -->
    sign<input type="input" name="sign" id="sign" value="">
    cataids:<input type="input" name="cataids" id="cataids" value="1514863632700">
    文件:<input type="file" name="image" id="image" /><br>
    <input type="submit" value="点击上传"/>
</form>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上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...