视频远程同步工具

对于远程服务器上的视频文件,Polyv有一个远程抓取接口, 不过批量视频抓取,可以采用视频远程同步工具。

导入任务

先用文本编辑器创建文件,整理好视频的链接和对应的标题逗号分隔,每一行一条列表,保存为csv格式文件,如下图:csv在同步工具界面右上方按钮点击“导入任务”,选择视频要导入的分类目录,上传刚刚创建的csv文件。
(注:csv文件内容有中文,需要把csv文件保存为utf-8的编码格式,如下所示)
1

同步任务

上传完毕之后,软件会分析任务总数,剩下就是等待同步工具完成任务了。 grab

导出任务

等到任务同步全部完成,点击右侧导出按钮,可以导出抓取后的结果列表,文件格式为csv,每个视频一行,格式为”标题,vid,完成时间”用逗号隔开。export

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

新建播放列表

createPlayList

    作用:创建播放列表

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选是否必须类型说明
writetokentruestring用户的写密钥
tagfalsestring视频标签
titletruestring标题
descfalsestring 描述

返回结果

<xml>
<error>0</error>
<total/>
</xml>

JSON示例

{
id: 1456889162568,
error: "0"
}

字段说明

字段说明
id播放列表的id
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

修改播放列表

modifyPlayList

    作用:修改播放列表

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选是否必须类型说明
idtruelong播放列表id
writetokentruestring用户的写密钥
tagfalsestring视频标签
titletruestring标题
descfalsestring 描述
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

移动视频到播放列表

addToPlayList

    作用:创建播放列表

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型说明
idtruelong播放列表的id,在“视频管理”——“播放列表”中可以获取,如下图所示
writetokentruestring用户的写密钥
vidtruelong视频id
1

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

将视频从播放列表移除

removeFromPlayList

    作用:将视频从播放列表移除

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型说明
idtruelong播放列表的id,在“视频管理”——“播放列表”中可以获取,如下图所示
writetokentruestring用户的写密钥
vidtruelong视频id
1

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

视频播放设置

editFlashPlay

    作用:视频播放设置

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
writetokentruestring用户的上传钥匙
vidtruestring视频ID
my_brfalseint码率1.普通,2.清晰3.高清
widthfalseintflash宽度
heightfalseintflash高度
videoautofalseintflash自动播放,1自动播放,0取消自动播放
formatfalsestring默认返回json格式,如果format=xml返回xml格式
jsonpfalsestring 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})

返回错误提示

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

返回结果

    <xml>
    <error>0</error>
    <data>
    <videoplay><height>"300"</height><definition>"1"</definition>    <width>"400"</width><videoauto>"1"</videoauto></videoplay>
    </data>
    </xml>

JSON示例

{"error":"0","data:{"height":"300","definition":"1","width":"400","videoauto":"1"}}

字段说明

字段说明
error错误提示
heightflash高度
definition视频码率
width视频宽度
videoauto是否自动播放

注意事项

该接口对应的是POLYV管理系统中视频设置里面的播放设置板块,需要注意的是,此项设置只对新上传视频有效。

QQ截图20160920182053

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

删除分类

接口URL

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

接口说明

删除分类

支持格式

JSON

HTTP请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
cataid string 该分类id
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写SHA1值
userid string POLYV用户ID,http://api.polyv.net/v2/video/{userid}/updateCata中的{userid}需要替换为POLYV用户ID的值

返回结果

{
  code: "200",
  status: "success",
  message: "",
  data: true
}

字段说明

参数 类型 说明
code int 成功/失败代码
status string 成功/失败状态
message string 成功/失败信息
data boolean 成功响应的数据

php请求示例

<?php
  $userid="9f1e0689e1";
  $cataid="1469603317481";
  $ptime=time()*1000;
  $secretkey="AkDipaULWw";
  $str="cataid=$cataid&ptime=$ptime&userid=$userid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/deleteCata?cataid=$cataid&ptime=$ptime&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign。

以下是示例过程:

1. 将请求参数按照参数名字典顺序排列为:

userid="9f1e0689e1";
cataid="1469603317481";
ptime="1469603573000";

2. 连接字符串
用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign(本示例的值为AkDipaULWw),如下:

cataid=1469603317481&ptime=1469603573000&userid=9f1e0689e1AkDipaULWw

3. 生成签名sign

sign为40位大写SHA1值:

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

修改分类名称

接口URL

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

接口说明

修改视频分类的名称

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
cataname string 修改后的分类名称
cataid string 该分类id
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写的SHA值
userid string POLYV用户ID,http://api.polyv.net/v2/video/{userid}/updateCata中的{userid}需要替换为POLYV用户ID的值

返回结果

{
  code: 200,
  status: "success",
  message: "",
  data: true
}

字段说明

参数 类型 说明
code int 成功/失败代码
status string 成功/失败状态
message string 成功/失败信息
data boolean 成功响应的数据

php请求示例

<?php
  $userid="3828390191";
  $cataname="polyv";
  $cataid="1466567123649";
  $ptime=time()*1000;
  $secretkey="tIQp4ATe9Z";
  $str="cataid=$cataid&cataname=$cataname&ptime=$ptime&userid=$userid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/updateCata?cataid=$cataid&cataname=$cataname&ptime=$ptime&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

1. 将请求参数按照参数名字典顺序排列为:

userid="3828390191";
cataname="polyv";
cataid="1466567123649";
ptime="1469599842000";

2. 连接字符串
用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign(本示例的值为tIQp4ATe9Z),如下:

cataid=1466567123649&cataname=polyv&ptime=1469599842000&userid=3828390191tIQp4ATe9Z

3. 生成签名sign

sign为40位大写的SHA1值:

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

移动视频到指定分类

接口URL

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

接口说明

将某些视频移动到某个分类下

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string POLYV用户ID,http://api.polyv.net/v2/video/{userid}/changeCata中的{userid}需要替换为POLYV用户ID的值
vids string 视频的ID,可以选择多个视频,如“e2e84a7383e275772f277359d70d7038_e,e2e84a73830123ca5a368ec61bde2d8b_e,...”
cataid string 视频将要移动到的目标分类ID
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写的SHA1值

注意事项

    vids参数如果有多个的话请用英文输入法的逗号“,”分割开

响应参数

参数名 类型 说明
code int 成功/失败代码
status string 成功/失败状态
message string 成功/失败信息
data string 成功响应的数据

JSON示例

{
  code: 200,
  status: "success",
  message: "",
  data: true
}

code值说明

code值 说明
200 视频成功移动到目标分类
400 视频移动到目标分类失败,具体信息可以参照message

php请求示例

<?php
  $userid="e2e84a7383";
  $vids="e2e84a7383e275772f277359d70d7038_e,e2e84a73830123ca5a368ec61bde2d8b_e,e2e84a73831dcd96b512ea236a35d1b9_e";
  $cataid="1462440513084";
  $ptime=time()*1000;
  $secretkey="7UagtQOq2A";
  $str="cataid=$cataid&ptime=$ptime&userid=$userid&vids=$vids".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/changeCata?cataid=$cataid&ptime=$ptime&vids=$vids&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

1. 请求参数为:

userid="e2e84a7383"
vids="e2e84a7383e275772f277359d70d7038_e,e2e84a73830123ca5a368ec61bde2d8b_e,e2e84a73831dcd96b512ea236a35d1b9_e"
ptime="1512984445000"
cataid="1462440513084"
secretkey="7UagtQOq2A"

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

cataid="1462440513084"
ptime="1512984445000"
userid="e2e84a7383"
vids="e2e84a7383e275772f277359d70d7038_e,e2e84a73830123ca5a368ec61bde2d8b_e,e2e84a73831dcd96b512ea236a35d1b9_e"
secretkey="7UagtQOq2A"

3. 连接字符串

连接参数名与参数值,并在首尾加上secretkey的值(本示例的值为7UagtQOq2A),如下:

cataid=1462440513084&ptime=1512984445000&userid=e2e84a7383&vids=e2e84a7383e275772f277359d70d7038_e,e2e84a73830123ca5a368ec61bde2d8b_e,e2e84a73831dcd96b512ea236a35d1b9_e7UagtQOq2A

4. 生成签名sign

sign为40位大写的SHA1值:

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

设置视频的播放器id

changePlayer

    作用:设置视频的播放器id

URL

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

支持格式

    JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
writetokentruestring用户的写钥匙
vidtruestring视频的id
playeridtruestring播放器的id,在POLYV后台——播放器设置界面上可以找到;当playerid的值为其他非法值时,视频的播放器id则会设置为默认播放器的id
jsonpfalsestring 例如,正常情况{error:0,data:""},加jsonp=a后返回a({error:0,data:""})

注意事项

    返回错误列表

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

JSON示例

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