设置分类属性

接口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为关闭;开启时不对视频进行转码(仅对新上传视频有效)
adownload false string 视频加密设置(仅对新上传视频有效)
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";
  $adownload="0";
  $keepSource="1";
  $hlslevel="open";
  $isEdu="1";
  $encode_aac="1";
  $str="adownload=$adownload&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&adownload=$adownload&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;
  "adownload"="0";
  "keepSource"="1";

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

"adownload"="0";
"cataid"="1458806129324";
"keepSource"="1";
"ptime"=time()*1000;

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

adownload=0&cataid=1458806129324&keepSource=1&ptime=15271306190003OmoLbTlHu

4、生成签名sign

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

上传某一级分类的视频水印

接口URL

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

接口说明

上传某一级分类的视频水印

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
image true File 上传的图片
cataid true 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
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

上传多个视频的预览图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...

上传多个视频的预览图

点击这里查看旧版

接口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...

远程批量上传视频

接口URL

http://api.polyv.net/v2/video/grab/{userid}/upload/multi

接口说明

批量上传远程视频(异步上传)

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前13位毫秒级时间戳,3分钟内有效
fileUrl true string 远程文件的http连接(带http://),多个地址间使用英文逗号隔开
title true string 标题,多个标题使用逗号隔开,**标题数量必须和文件地址数量一致 **
cataid false long 设定上传视频的分类,分类的id可以在“视频管理”——“内容分类”中获取,如下图所示。cataid为catatree的最后一个long型的整数,catatree由cataid组成。当cataid值为1时,表示用户上传空间的根目录。
sign true string 签名

JSON示例

{
    code: 200,
    status: "success",
    message: "success",
    data: "成功!"
}

返回错误json

// 文件url不能为空
{
  "code":400,
  "status":"error",
  "message":"FileUrl is null!",
  "data":""
}
// 文件标题不能为空
{
  "code":400,
  "status":"error",
  "message":"Title is null!",
  "data":""
}
// 文件的url个数必须和title个数相同
{
  "code":400,
  "status":"error",
  "message":"FileUrl and title are inconsistent!",
  "data":""
}

PHP示例代码

<?php
  $userid="8205ac89d3";
  $secretkey = "kXmHMLeX6M";
  $ptime=time()*1000;
  $fileUrl="http://a.mp4,http://b.mp4";
  $title="aaa,bbb";
  $cataid="131313";
  $str="cataid=$cataid&fileUrl=$fileUrl&ptime=$ptime&title=$title".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/grab/$userid/upload/multi?cataid=$cataid&fileUrl=$fileUrl&ptime=$ptime&title=$title&sign=$sign";
  $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_CUSTOMREQUEST, "POST");
  $output = curl_exec($ch);
  curl_close($ch);
  print_r($output);
?>

签名规则:

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

1、请求参数为

  "cataid"="131313";
  "fileUrl"="http://a.mp4,http://b.mp4";
  "title"="aaa,bbb";
  "ptime"=1527228607000;

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

  "cataid"="131313";
  "fileUrl"="http://a.mp4,http://b.mp4";
  "ptime"=1527228607000;
  "title"="aaa,bbb";

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

cataid=131313&fileUrl=http://a.mp4,http://b.mp4&ptime=1527228607000&title=aaa,bbbkXmHMLeX6M

4、生成签名sign
生成40位大写SHA1值

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

POLYV Web上传插件(V2.0)

说明:
1. 本文档从用户角度简单概述了polyv web上传插件的使用方法。
2. V2.0 版本的使用与 V1.0 版本完全一致,因此无需更改原有的接口调用及逻辑,只要更换polyv-upload.js的调用地址即可。(推荐使用 V2.0 版本

一、功能:

  1. 上传文件
    1). 上传前可以进行选择分类、添加标签、选择视频优化处理、修改文件名及文件说明等操作
    2). 可选择默认的上传目录
    3). 可设置是否对源文件进行编码
    4). 支持断点续传。中途断网或浏览器因故障等原因重启后同个文件可以实现从断点续传。(仅在浏览器版本>=IE11及主流浏览器下支持实现该功能)
    5). 同时选择多个文件、上传过程显示进度
  2. 查看视频
    1). 查看视频列表
    2). 根据标题关键字搜索视频
    3). 获取具体的视频信息
    4). 更换封面
      a.上传新图片作为封面
      b.选择视频截图作为封面
      c.选择最近上传的图片作为封面
  3. 可选择只显示“上传列表”或“视频列表”或显示全部
  4. 可调用接口(response、uploadSuccess、uploadFail)返回视频信息
  5. 提供打开、关闭插件的方法

二、浏览器支持

  • 支持大部分主流浏览器,IE浏览器兼容IE9及IE9以上。
  • 在支持HTML5新特性的浏览器中,支持断点续传,最大可上传30GB的文件。
  • 反之,在不支持HTML5新特性的浏览器中(如IE9),不支持断点续传功能,最大可上传2GB的文件。

三、入门教程:

1、首先在调用该插件的页面上添加一个按钮:

<input type="button" id="upload" value="上传"></input>

2、引入POLYV上传插件的js文件

<script src="//v.polyv.net/file/plug-in-v2/polyv-upload.js"></script>

3、添加脚本,初始化上传参数并新建一个上传实例。

var obj = {
    uploadButtton: 'upload',
    userid: data.userid,
    ts: data.ts,
    hash: data.hash,
    sign: data.sign,
    component: 'all', 
    cataid: 1499657507273, 
    luping: 1,
    extra: {
        keepsource: 1,
    }
};
upload = new PolyvUpload(obj);

4、上传参数解释:

  • uploadButtton:打开上传控件按钮的id
  • userid:可以在“云点播”后台->“设置”->“API接口”页面中找到您的userid
  • ts:13位的毫秒级时间戳
  • hash:是根据将ts和writeToken按照顺序拼凑起来的字符串进行MD5计算得到的值
  • sign:是根据将secretkey和ts按照顺序拼凑起来的字符串进行MD5计算得到的值
  • component(可选):可以设置为videoList(只显示视频列表)、 uploadList(只显示上传列表)、all(默认值,显示上传列表和视频列表)
  • cataid(可选):上传目录id,默认值为1
  • luping(可选):开启视频课件优化处理,对于上传录屏类视频清晰度有所优化。可设置为01,默认值为0,表示不开启课件优化
  • keepsource(可选):源文件播放(不对源文件进行编码)。可设置为0(对源文件进行编码)或1(源文件播放)

5、获取用户信息的代码示例(PHP):

/* 
说明:以下的userid、secretkey、writeToken、readToken可以在“云点播”后台->“设置”->“API接口”页面中找到。
*/
$userid = "your userid";
$secretkey = "your sercrety";
$writeToken = "your writeToken";
$readToken = "your readToken";

$ts = time() * 1000;
$hash = md5($ts . $writeToken);
$sign = md5($secretkey . $ts);

四、使用文档

1.上传参数options

  • uploadButtton:打开上传控件按钮的id
  • userid
  • ts:13位的毫秒级时间戳
  • hash:是根据将ts和writeToken按照顺序拼凑起来的字符串进行MD5计算得到的值
  • sign:是根据将secretkey和ts按照顺序拼凑起来的字符串进行MD5计算得到的值
  • component(可选):可以设置为videoList(只显示视频列表)、 uploadList(只显示上传列表)、all(默认值,显示上传列表和视频列表)
  • cataid(可选):上传目录id,默认值为1
  • luping(可选):开启视频课件优化处理,对于上传录屏类视频清晰度有所优化。可设置为01,默认值为0,表示不开启课件优化
  • defaultTagPlaceholder(可选):自定义标签输入框占位符
  • defaultDescPlaceholder(可选):自定义视频描述输入框占位符
  • extra(可选): object
    可添加的属性为keepsource:源文件播放(不对源文件进行编码)。可设置为0(对源文件进行编码)或1(源文件播放)
    javascript
    {
    keepsource: 1, // 源文件播放(不对源文件进行编码)
    }
  • response(可选): function,返回指定视频的信息时的回调函数
  • uploadSuccess(fileData)(可选):function,当前文件上传完毕时触发的回调函数
  • uploadFail(err)(可选):function,当前文件上传失败时触发的回调函数

2.方法

  • update(data): 用于更新ts、hash、sign3个信息
  • closeWrap(): 关闭插件
  • openWrap(): 打开插件

五、demo演示和下载

demo演示:POLYV Web上传插件演示
demo下载:POLYV Web上传插件源码

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

上传PPT文件

点击这里查看旧版

接口URL

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

接口说明

上传PPT文件

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
vid true string 视频ID
sign true string 签名,40位大写的sha1值
ptime true string 当前13位毫秒级时间戳,3分钟内有效
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})

JSON示例

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

返回错误json

{
"code":400,
"status":"error",
"message":"sign can not be empty.",
"data":""
}

PHP示例代码

<?php
$userid="2d939377c2";
$vid="2d939377c272967efcdb812a1dad8c5c_2";
$ptime=time()*1000;
$secretkey="3OmoLbTlHu";
$str="ptime=$ptime&vid=$vid".$secretkey;
$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; ?>/uploadPPT" 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="ppt" id="fileupload1" /><br>
     txt:<input type="file" name="txt" id="fileupload2" /><br>
   <input type="submit" value="点击上传"/>
 </form>
</body>
</html>
txt文件格式示例如下,每一行为:“秒数”+“:”+“标题” (注:txt文件必须是UTF-8的编码格式,否则课件的章节标题会显示为乱码)
10:第十秒出现标题
21:第二十秒出现标题
30:第三十秒出现标题

签名规则

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

上传视频

接口URL

http://v.polyv.net/uc/services/rest?method=uploadfile

接口说明

作用:上传本地视频

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
writetoken true string 用户的上传钥匙
JSONRPC true string json格式,{"title": "标题", "tag":"标签","desc":"描述"}
Filedata true file file类型,支持的文件格式为:.flv,.avi,.mpg,.mp4,.wmv,.mov,.3gp,.asf等
fcharset flase string 当fcharset设为'ISO-8859-1'时,可以避免视频的文件名乱码
cataid false long 设定上传视频的分类,分类的id可以在“视频管理”——“内容分类”中获取,如下图所示。cataid为catatree的最后一个long型的整数,catatree由cataid组成。当cataid值为1时,表示用户上传空间的根目录。
watermark false string 水印图片的URL,图片格式必须是png格式
luping false int 是否录屏优化。当值为1时,上传的视频不再采取默认的压缩编码机制,视频尺寸不再压缩,保证视频的清晰度。默认值为0
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})

2

注意事项

    返回错误列表

返回 说明
0 无错误
1 找不到writetoken关联的user
2 文件为空或者writetoken为空
3 提交的json名字JSONRPC为null
4 提交文件格式不正确
5 readtoken为空
6 分页输入出错
7 vid不能为空
8 找不到方法名

返回结果

<xml>
<error>0</error>
<total/>
<data>
<video>
<md5checksum>
<![CDATA[ 44b145c6bea7dd826191990dfb38d1fd ]]>
</md5checksum>
<tag>
<![CDATA[ 标签 ]]>
</tag>
<mp4>
<![CDATA[http://mpv.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_1.mp4]]>
</mp4>
<title>
<![CDATA[ upload上传视频 ]]>
</title>
<df>2</df>
<times>
<![CDATA[ 0 ]]>
</times>
<mp4_1>
<![CDATA[http://mpv.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_1.mp4]]>
</mp4_1>
<vid>
<![CDATA[ 36e77ba39cc4768ab541cb6bf4f775a0_3 ]]>
</vid>
<mp4_2>
<![CDATA[http://mpv.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_2.mp4]]>
</mp4_2>
<cataid>
<![CDATA[ 1 ]]>
</cataid>
<swf_link>
<![CDATA[http://player.polyv.net/videos/36e77ba39cc4768ab541cb6bf4f775a0_3.swf]]>
</swf_link>
<status>
<![CDATA[ 10 ]]>
</status>
<seed>1</seed>
<flv2>
<![CDATA[http://plvod01.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_2.flv]]>
</flv2>
<flv1>
<![CDATA[http://plvod01.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_1.flv]]>
</flv1>
<sourcefile>
<![CDATA[ ]]>
</sourcefile>
<playerwidth>
<![CDATA[ 600 ]]>
</playerwidth>
<hls/>
<default_video>
<![CDATA[http://plvod01.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_1.flv]]>
</default_video>
<duration>
<![CDATA[ 00:00:33 ]]>
</duration>
<filesize/>
<first_image>
<![CDATA[http://img.videocc.net/uimage/3/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_0.jpg]]>
</first_image>
<original_definition>
<![CDATA[ 672x378 ]]>
</original_definition>
<context>
<![CDATA[ 视频文档描述 ]]>
</context>
<previewVid>
<![CDATA[ m63c44pl69mm7435lp871mp3pn7n448l0_6 ]]>
</previewVid>
<playerheight>
<![CDATA[ 490 ]]>
</playerheight>
<ptime>
<![CDATA[ 2017-12-04 10:36:18 ]]>
</ptime>
</video>
</data>
</xml>

JSON示例

{
error: "0",
data: [
{
images_b: [
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_0_b.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1_b.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_2_b.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_3_b.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_4_b.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_5_b.jpg"
],
md5checksum: "44b145c6bea7dd826191990dfb38d1fd",
tag: "鏍囩",
mp4: "http://mpv.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1.mp4",
title: "upload涓婁紶瑙嗛",
df: 2,
times: "0",
mp4_1: "http://mpv.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1.mp4",
vid: "36e77ba39c0e5dac84dba418d81a793d_3",
mp4_2: "http://mpv.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_2.mp4",
cataid: "1",
swf_link: "http://player.polyv.net/videos/36e77ba39c0e5dac84dba418d81a793d_3.swf",
source_filesize: 2295887,
status: "10",
seed: 1,
flv2: "http://plvod01.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_2.flv",
flv1: "http://plvod01.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1.flv",
sourcefile: "",
playerwidth: "600",
hls: [
"http://hls.videocc.net/36e77ba39c/3/36e77ba39c0e5dac84dba418d81a793d_1.m3u8",
"http://hls.videocc.net/36e77ba39c/3/36e77ba39c0e5dac84dba418d81a793d_2.m3u8"
],
default_video: "http://plvod01.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1.flv",
duration: "00:00:33",
filesize: [
0,
0
],
first_image: "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_0.jpg",
original_definition: "672x378",
context: "瑙嗛鏂囨。鎻忚堪",
images: [
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_0.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_2.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_3.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_4.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_5.jpg"
],
previewVid: "363c44pl69m0c8klm57kpl715k51l496k_6",
playerheight: "490",
ptime: "2017-12-04 11:12:50"
}
]
}

字段说明

字段 说明
swf_link Flash链接地址
tag 标签
mp4 视频地址
playerwidth 视频宽度
title 视频标题
duration 视频时长
first_image 视频截图
times 点击次数
context 视频描述
images 所有截图
previewVid 预览视频VID
playerheight 视频高度
ptime 上传时间
vid 视频id
cataid 分类id, 如1为根目录
default_video 用户默认播放视频
df 视频码率数
flv1 流畅码率flv格式视频地址
flv2 高清码率flv格式视频地址
flv3 超清码率flv格式视频地址
mp4_1 流畅码率mp4格式视频地址
mp4_2 高清码率mp4格式视频地址
mp4_3 超清码率mp4格式视频地址
hls1 流畅码率hls格式视频地址
hls2 高清码率hls格式视频地址
hls3 超清码率hls格式视频地址
hlsIndex 自适应码率hls播放地址
images_b 视频截图大图地址
seed 加密视频为1,非加密为0
status 视频状态
md5checksum 上传到POLYV云平台的视频源文件的MD5值,可以用来校验是否上传错误或完整
视频状态码 含义
60/61 已发布
10 等待编码
20 正在编码
50 等待审核
51 审核不通过
-1 已删除

如果API想调用签名,可参考http://dev.polyv.net/2015/09/apisign/ 按参数签名顺序拼凑字符串为cataid=$(cataid)&JSONRPC=$(JSONRPC)&writetoken=$(writetoken)$(secretkey),并进行sha1计算,得到sign。

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

上传远程视频

接口URL

http://v.polyv.net/uc/services/rest?method=uploadUrlFile

接口说明

作用:上传远程视频

支持格式

JSON,XML

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
writetoken true string 用户的上传钥匙
fileUrl true file 远程文件的http连接(带http://)
async false string 是否异步处理,取值为true/false,默认值为false
title false string 标题
tag false string 标签
desc false string 描述
cataid false long 设定上传视频的分类,分类的id可以在“视频管理”——“内容分类”中获取,如下图所示。cataid为catatree的最后一个long型的整数,catatree由cataid组成。当cataid值为1时,表示用户上传空间的根目录。
luping false int 是否录屏优化。当值为1时,上传的视频不再采取默认的压缩编码机制,视频尺寸不再压缩,保证视频的清晰度。默认值为0

2

注意事项

返回错误列表

返回 说明
0 无错误
1 找不到writetoken关联的user
2 文件为空或者writetoken为空
3 提交的json名字JSONRPC为null
4 提交文件格式不正确
5 readtoken为空
6 分页输入出错
7 vid不能为空
8 找不到方法名

JSON示例

同步上传返回结果:

{
    "error":"0","data":[{"vid":"********"}]
}

异步上传返回结果:

{
    "error":"0"
}

字段说明

字段 说明
vid 视频ID

如果API想调用签名,可参考
http://dev.polyv.net/2015/09/apisign/ 按参数签名顺序拼凑字符串为desc=$(desc)&fileUrl=$(fileUrl)&tag=$(tag)&title=$(title)&writetoken=$(writetoken)$(secretkey),并进行sha1计算,得到sign。

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

上传远程视频代码示例

首选需要一个非本地视频,一个视频链接,然后通过writetoken,执行API的uploadUrlFile方法,即可把视频直接上传到视频云端,并返回视频信息。

代码

视频文件链接: <input type="text" id="fileUrl" value="http://112.90.246.23/plvod01.videocc.net/sl8da4jjbx/2/sl8da4jjbx692db9d494a9986ab8c7a2.mp4" size="100">
writetoken: <input type="text" id="writetoken" value="Y07Q4yopIVXN83n-MPoIlirBKmrMPJu0" size="40">
<input type="button" id="button" value="点击抓取">
 标题 <input id="title" size="70">
 首图 <input id="first_image" size="70"><img src="" id="first_image_img" style="display:none">
 播放链接 <input id="swf_link" size="70">
<script>
$("#button").click(function(){
  $("#button").val("正在抓取,请稍后");
  $.get("http://v.polyv.net/uc/services/rest", {
    method:"uploadUrlFile",
    fileName:"remotefile title",
    writetoken:$("#writetoken").val(),
    fileUrl:$("#fileUrl").val()
      },function(video){
      $("#button").val("抓取完成");
          $("#title").val(video.data[0].title);
          $("#first_image").val(video.data[0].first_image);
          $("#first_image_img").attr("src",video.data[0].first_image);
          $("#first_image_img").css({display:"block"});
          $("#swf_link").val(video.data[0].swf_link);
  });
});
</script>
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...