上传视频的预览图

upFirstImage

    作用:上传并更改视频的预览图

URL

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

支持格式

    JSON

HTTP请求方式

    POST

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
writetokentruestring用户的上传钥匙
vidtruestring要修改的视频ID
Filedatafalsefile用户上传的图片文件:.jpg,.png
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 version="1.0" encoding="UTF-8"?>
<xml>
        <error>0</error>
        <data>true</data>    
</xml>

JSON示例

{"error":"0","data":true}

字段说明

字段说明
error错误提示
data返回成功或失败
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

上传问答

参数描述(以下参数除answer、wrongAnswer之外,其他参数都必须提交

1 writetoken 用户上传的钥匙 
2 vid 视频的id
3 seconds 问题出现的秒数(第seconds秒)
4 question 问题描述
5 choices  json格式备选选项,四个 ,正确答案需要加多一个"right_answer":1 例如:'[{"answer":"100"},{"answer":"22","right_answer":1},{"answer":"30"},{"answer":"45"}]'
6 answer 回答正确时候的解答详情
7 wrongAnswer 回答错误时候的解答详情
8 wrongShow 答错是否显示解答详情 1为显示,0不显示
9 wrongTime 答错退回秒数(第wrongTime秒),-1不回退
10 examId 测试问题Id,为空的时候新创建一个,不为空则修改这条问题
11 right_answer 类型为整型,1表示正确答案,0表示错误答案

 

在页面中加入

<script type="text/javascript">
function updateExam(){
  $.post("http://v.polyv.net/uc/services/rest", {
      method:"saveExam",
      writetoken:'Y07Q4yopIVXN83n-MPoIlirBKmrMPJu0',
      vid:'sl8da4jjbx02064017aff9989bfb824f_s',
      examId:'',//为空新增问题
      seconds:10,
      question:'10+12=?',
      choices:'[{"answer":"100"},{"answer":"22","right_answer":1},{"answer":"30"},{"answer":"45"}]',
      skip:"true",//设置是否可以跳过问答,true表示可以跳过,不添加这个参数默认没有跳过的功能
      answer:'第二个答案,解答',//回答正确时候的解答详情
      wrongAnswer:'答错了',//回答错误时候的解答详情
      wrongShow:1,//答错是否显示解答详情
      wrongTime:10//答错退回第十秒,-1不回退
   },function(result){
        var data = eval(result);     
        if(data.error==0){
            alert('成功,examId:'+data.examId);
        }else{
            alert('失败了');
        }
   });
}
</script>

<input type="button" onclick="javascript:updateExam()" value="点击"/>
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

上传视频字幕

参数描述

1 writetoken 用户上传的钥匙 
2 vid 视频的id
3 title srt显示名,为空则用文件名代替
4 Filedata srt文件

在页面中加入

link rel="stylesheet" type="text/css" href="/uploadify/uploadify.css">
<script type="text/javascript" src="/javascripts/libs/jquery.min.js"></script>
<script type="text/javascript" src="/uploadify/jquery.uploadify.min.js"></script>

<script type="text/javascript">
  $(function() {
        $.fileupload1 = $('#fileupload1').uploadify({
          'auto'     : false,
            'formData'     : {
                'writetoken' : 'Y07Q4yopIVXN83n-MPoIlirBKmrMPJu0',
                'vid'     : 'sl8da4jjbx7e220f1c15213f9f04782e_s',
              'title' : ''
            },
           'buttonText': '选择上传文件',
           'fileSizeLimit' : '10MB',//上传文件大小限制
           'fileTypeDesc' : '视频文件',
           'fileTypeExts' : '*.srt;',//文件类型过滤
            'swf'      : '/uploadify/uploadify.swf',
            'uploader' : 'http://v.polyv.net/uc/services/rest?method=uploadSRT',
            'onUploadSuccess':function(file,data,response){

              var jsonobj=eval('('+data+')');
              if(jsonobj.error==0){
                  alert("srt uploaded!");
              }

            }
        });
  });
</script>

<input type="file" name="Filedata" id="fileupload1" />
<input type="button" onclick="javascript:$('#fileupload1').uploadify('upload')" value="点击上传"/>

 

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

视频远程同步工具

对于远程服务器上的视频文件,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...