修改视频密码

接口URL

http://api.polyv.net/v2/video/{userid}/video-setting-save

接口说明

修改视频密码

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string POLYV用户ID,http://api.polyv.net/v2/data/{userid}/viewlog中的{userid}需要替换为POLYV用户ID的值
describ false string 视频描述
password false string 视频密码
ptime true string 当前时间的毫秒级时间戳(13位),3分钟内有效
publishUrl false string 首发外链
tag false string 视频标签
title false string 视频标题
vids true string 视频ID
sign true string 签名,为40位大写的SHA1值

注意事项

sign的拼接规则是:describ=参数&password=参数&ptime=参数&publishUrl=参数&tag=参数&title=参数&vids=参数secretkey,再经过SHA-1加密并大写化。

这里要注意,如果这些参数的值为空串,则sign里就不用拼上这些变量

 

PHP示例代码

<?php
$userid="9f1e0689e1";
$describ="描述";
$password="123456";
$ptime=time()*1000;//13位
$publishUrl="my.polyv.net";
$tag="标签";
$title="标题";
$vids="9f1e0689e10f2630f8fa8a6a2ae15771_9";
$post_data = array (
    "describ" => $describ,
    "password" => $password,
    "ptime" => $ptime,
    "publishUrl" => $publishUrl,
    "tag" => $tag,
    "title" => $title,
    "vids" => $vids
);
$str="";
foreach ($post_data as $key => $value){
    // 这里要注意,如果这些参数的值为空串,则sign里就不用拼上这些变量
    if (!empty($value)) {
        $str.=$key."=".$value."&";
    }else{
        unset($post_data[$key]); 
    }
}
$str=substr($str, 0,strlen($str)-1);
$secretkey="AkDipaULWw";
$str.=$secretkey;
// echo $str;
// exit();
$hash=strtoupper(sha1($str));
$post_data["sign"] = $hash;
// var_dump($post_data);
// exit();
$url="http://api.polyv.net/v2/video/{$userid}/video-setting-save";
$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);
?>

返回结果

正确返回

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

错误返回

{"code":400,"status":"error","message":"the sign is not right.","data":""}

字段说明

字段 说明
code 返回状态码
status 返回状态值
message 返回信息
data 返回数据
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

查询视频密码

接口URL

http://api.polyv.net/v2/video/{userid}/video-setting-page

接口说明

查询视频密码

支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

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

注意事项

sign的拼接规则是:ptime=参数&vids=参数secretkey,再经过SHA-1加密并大写化。
这里要注意,如果这些参数的值为空串,则sign里就不用拼上这些变量

返回错误列表

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

返回结果

// 密码存在data.videoPool.videoPoolExt.password,如果data.videoPool.videoPoolExt不存在密码,则表明密码为空

JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": {
    "questionnaire": {
      "qid": "20160407103005"
    },
    "isShowPassword": false,
    "vids": "9f1e0689e10f2630f8fa8a6a2ae15771_9",
    "videoPool": {
      "describ": "描述",
      "videoPoolExt": {
        "password": "123456"
      },
      "tag": "标签",
      "title": "标题",
      "publishUrl": "my.polyv.net"
    },
    "qid": ""
  }
}

PHP示例代码

<?php
$userid="9f1e0689e1";//必选
$ptime=time()*1000;//13位必选
$vids="9f1e0689e10f2630f8fa8a6a2ae15771_9";//必选
$secretkey="AkDipaULWw";//必选
$str="ptime=".$ptime."&vids=".$vids.$secretkey;
$hash=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/video/{$userid}/video-setting-page"."?ptime=$ptime&vids=$vids&sign=$hash";//只能get
$content=file_get_contents($url);
echo $content;
?>

字段说明

字段 说明
code 返回状态码
status 返回状态值
message 返回信息
isShowPassword 是否显示密码
vids 视频id
describ 视频描述
password 视频密码
tag 视频标签
title 视频标题
publishUrl 首发外链
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

新建视频分类

点击这里查看旧版

接口URL

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

接口说明

新建视频分类

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户ID(在post的时候不需要提交,只用在接口的url中)
cataname true string 分类名称
catatype false string 分类类型
cataurl false string 分类链接
parentid true string 新建的分类目录的上一级目录,值为1时表示根目录
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
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: {
    catatree: "1,1493347765680",
    cataid: 1493347765680
  }
}

返回错误json

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

PHP示例代码

<?php
  $userid="2d939377c2";
  $cataname="新建分类测试";
  $catatype="0";
  $cataurl="分类链接";
  $parentid="1";
  $ptime=time()*1000;
  $secretkey="3OmoLbTlHu";
  $str="cataname=$cataname&catatype=$catatype&cataurl=$cataurl&parentid=$parentid&ptime=$ptime".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/addCata";
  $post_data = array (
   "cataname" => $cataname,
   "catatype" => $catatype,
   "cataurl" => $cataurl,
   "parentid" => $parentid,
   "ptime" => $ptime,
   "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_POSTFIELDS, $post_data);
  $output = curl_exec($ch);
  curl_close($ch);
  print_r($output);
?>

签名规则:

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

1、请求参数为

"cataname" = "新建分类测试"
"catatype" = "0"
"cataurl" = "分类链接"
"parentid" = "1"
"ptime" = "1493370776000"

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

"cataname" = "新建分类测试"
"catatype" = "0"
"cataurl" = "分类链接"
"parentid" = "1"
"ptime" = "1493370776000"

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

cataname=新建分类测试&catatype=0&cataurl=分类链接&parentid=1&ptime=14933707760003OmoLbTlHu

4、生成签名sign

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

批量获取视频的时长和大小

接口URL

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

接口说明

获取多个视频的时长和大小

请求方式

GET

支持格式

JSON

请求参数

参数名 必选 类型及范围 说明
vids 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: [
{
vid: "2d939377c23a37d2b0a2428006755627_2",
duration: "00:09:40",
filesize1: 9714032,
filesize2: 9415768
},
{
vid: "2d939377c23ebcfe8b4ff3dadcabfbbf_2",
duration: "00:00:14",
filesize1: 574357,
filesize2: 1092671
}
]
}

返回错误json

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

PHP示例代码

<?php
$userid="2d939377c2";
$vids="2d939377c23a37d2b0a2428006755627_2,2d939377c23ebcfe8b4ff3dadcabfbbf_2";
$ptime=time()*1000;
$secretkey="3OmoLbTlHu";
$str="ptime=$ptime&vids=$vids".$secretkey;
$sign=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/video/$userid/info?ptime=$ptime&sign=$sign&vids=$vids";
$content = file_get_contents($url);
echo $content;
?>

签名规则:

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

  • 请求参数为
"ptime" = "1493344799000"
"vids" = "2d939377c23a37d2b0a2428006755627_2,2d939377c23ebcfe8b4ff3dadcabfbbf_2"
  • 将请求参数按照参数名字典顺序排列
"ptime" = "1493344799000"
"vids" = "2d939377c23a37d2b0a2428006755627_2,2d939377c23ebcfe8b4ff3dadcabfbbf_2"
  • 连接字符串
    连接参数名与参数值,并在尾部加上secretkey(secretkey的值为3OmoLbTlHu),如下:
ptime=1493344799000&vids=2d939377c23a37d2b0a2428006755627_2,2d939377c23ebcfe8b4ff3dadcabfbbf_23OmoLbTlHu
  • 生成签名sign
66A7000F442DB7D701533C69F44053521D17C7D0
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

获取单个视频的问答题目

点击这里查看旧版

接口URL

http://api.polyv.net/v2/video/{userid}/get-video-exam

接口说明

获取单个视频的问答题目

支持格式

JSON

HTTP请求方式

POST, GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户ID
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: [
  {
    examId: "1569b537dcf",
    userid: "2d939377c2",
    videoPoolId: "2d939377c23a37d2b0a2428006755627_2",
    showTime: "0:0:5",
    hours: 0,
    minutes: 0,
    seconds: 5,
    question: "66x6=?",
    choices: "[{"answer":"396","right_answer":1},{"answer":"366"},{"answer":"436"},{"answer":"296"}]",
    answer: "66x6=396",
    wrongTime: -1,
    wrongShow: 1,
    status: 1,
    createdTime: 1493343206000,
    skip: "true",
    type: 0,
    mp3url: ""
  }
  ]
}

返回错误json

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

字段说明

字段 说明
examId 问答题目的id
userid 用户的id
videoPoolId 视频的id
showTime 问答题目开始显示的时间
hours
minute
seconds
questions 问题
choices 选项
answer 答案
skip 能否跳过问答
wrongTime 回答错误后跳回到第几秒,-1指不退回
wrongShow 回答错误是否提示
createdTime 创建问答题目的时间

PHP示例代码

<?php
  $userid="2d939377c2";
  $vid="2d939377c23a37d2b0a2428006755627_2";
  $ptime=time()*1000;
  $secretkey="3OmoLbTlHu";
  $str="ptime=$ptime&vid=$vid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/get-video-exam?ptime=$ptime&sign=$sign&vid=$vid";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则:

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

上传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://api.polyv.net/v2/video/{userid}/get-del-list

接口说明

获取用户回收站视频的列表

支持格式

XML/JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户的id
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{"code":200,…,data[]},加jsonp=a后返回/* */a({"code":200,…,data[]})
numPerPage false int 平均每页取多少条数据
pageNum true int 取第几页
ptime true float 13位的当前时间毫秒级时间戳
sign true string 签名

返回结果

<xml>
  <code>200</code>
  <status>success</status>
  <message/>
  <data>
    <video>
    <title/>
    <times>0</times>
    <vid>0l82oo5m7u400796609a2b346d5708b7_0</vid>
    <tag/>
    <duration>00:00:29.33</duration>
    <swf_link>http://player.polyv.net/videos/0l82oo5m7u400796609a2b346d5708b7_0.swf</swf_link>
    <first_image>0l82oo5m7u/7/0l82oo5m7u400796609a2b346d5708b7_0.jpg</first_image>
    <context/>
    <ptime>1351584068574</ptime>
    </video>
    <video>
    <title/>
    <times>0</times>
    <vid>0l82oo5m7ua20033346de7fad9c64318_0</vid>
    <tag/>
    <duration>00:00:29.33</duration>
    <swf_link>http://player.polyv.net/videos/0l82oo5m7ua20033346de7fad9c64318_0.swf</swf_link>
    <first_image>0l82oo5m7u/8/0l82oo5m7ua20033346de7fad9c64318_0.jpg</first_image>
    <context/>
    <ptime>1350616738583</ptime>
    </video>
  </data>
</xml>

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: [
  {
    tag: "未加密、有水印、课件优化",
    mp4: "http://mpv.videocc.net/7d26575efe/b/7d26575efe955e64a0026943001fb16b_1.mp4",
    title: "通过API编辑的视频",
    df: 3,
    times: "72",
    vid: "7d26575efe955e64a0026943001fb16b_7",
    mp4_1: "http://mpv.videocc.net/7d26575efe/b/7d26575efe955e64a0026943001fb16b_1.mp4",
    mp4_2: "http://mpv.videocc.net/7d26575efe/b/7d26575efe955e64a0026943001fb16b_2.mp4",
    mp4_3: "http://mpv.videocc.net/7d26575efe/b/7d26575efe955e64a0026943001fb16b_3.mp4",
    cataid: "1491449655546",
    swf_link: "http://player.polyv.net/videos/7d26575efe955e64a0026943001fb16b_7.swf",
    status: "-1",
    seed: 0,
    playerwidth: "600",
    duration: "00:00:30",
    first_image: "http://img.videocc.net/uimage/7/7d26575efe/b/7d26575efe955e64a0026943001fb16b_5.jpg",
    original_definition: "1280x720",
    context: "234",
    playerheight: "337",
    ptime: "2017-04-06 11:37:22",
    source_filesize: 26246026,
    filesize: [
      1270450,
      2274196,
      5176044
    ],
    md5checksum: "d8c2eafd90c266e19ab9dcacc479f8af",
    hls: [
      "http://hls.videocc.net/7d26575efe/7/7d26575efe955e64a0026943001fb16b_1.m3u8",
      "http://hls.videocc.net/7d26575efe/7/7d26575efe955e64a0026943001fb16b_2.m3u8",
      "http://hls.videocc.net/7d26575efe/7/7d26575efe955e64a0026943001fb16b_3.m3u8"
    ]
  }
  ],
  total: 1
}

请求失败返回json示例

{
  code: 400,
  status: "error",
  message: "the sign is not right.",
  data: ""
}

字段说明

字段 说明
code 请求返回状态码
status 请求返回状态
message 请求返回信息
tag 视频标签
mp4 MP4源文件
title 标题
df 视频码率数
times 播放次数
vid 视频id
mp4_1 流畅码率mp4格式视频地址
mp4_2 高清码率mp4格式视频地址
mp4_3 超清码率mp4格式视频地址
cataid 分类id, 如1为根目录
swf_link 返回视频flash链接
status 视频状态码(data中的status)
seed 加密视频为1,非加密为0
playerwidth 视频宽度
duration 时长
first_image 视频首图
original_definition 最佳分辨率
context 视频描述
playerheight 视频高度
ptime 视频上传日期
source_filesize 源视频文件大小
md5checksum 上传到POLYV云平台的视频源文件的MD5值,可以用来校验是否上传错误或完整
hls 流畅、高清、超清清晰度的m3u8
total 视频总数
视频状态码 含义
60/61 已发布
10 等待编码
20 正在编码
50 等待审核
51 审核不通过
-1 已删除

sign的生成规则

format=参数&jsonp=参数&numPerPage=参数&pageNum=参数&ptime=参数secureKey经过SHA-1加密再经过大写化
(注意:参数为空时,则在生成sign的时候不需要添加此字段。如果这里没有jsonp,则不需要拼接&jsonp=参数)

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

获取单个视频的首图

点击这里查看旧版

接口URL

http://api.polyv.net/v2/video/{userid}/get-image

接口说明

获取单个视频的首图

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户的id(在请求时不需提交该参数,仅作为接口url中的变量)
ptime true float 13位的当前时间毫秒级时间戳
t false int 值为1时,表示获取视频首图的缩略图
vid true string 视频的id
sign true string 签名

请求成功返回json示例

{
  code: 200,
  status: "success",
  message: "success",
  data: "http://img.videocc.net/uimage/7/7d26575efe/6/7d26575efe7af7af4dcaa007d6298196_0.jpg"
}

请求失败返回json示例

{
  code: 400,
  status: "error",
  message: "the sign is not right.",
  data: ""
}

字段说明

字段 说明
code 请求返回的状态码
status 请求返回的状态
message 请求返回的信息
data 请求返回的数据

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8"); 
$userid="0c4b2b3748";
$ptime=time()*1000;//13位
$t=1;//值为1时,表示获取视频首图的缩略图 false 其他值是大图
$vid="0c4b2b37489e705c0d563cec816d5ab9_0";
$secretkey="l2b58rVt2b";
$str="ptime=".$ptime."&t=".$t."&vid=".$vid.$secretkey;
$hash=strtoupper(sha1($str));
$url="http://api.polyv.net/v2/video/{$userid}/get-image";
$post_data = array (
    "ptime" => $ptime,
    "t" => $t,
    "vid" => $vid,
    "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);
?>

sign的生成规则

ptime=参数&t=参数&vid=参数secretkey经过SHA-1加密再经过大写化
(注意:参数为空时,则在生成sign的时候不需要添加此字段。例如如果这里没有t,则不需要拼接&t=参数)

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

获取最新视频/全部视频列表

点击这里查看旧版

接口URL

http://api.polyv.net/v2/video/{userid}/get-new-list

接口说明

获取用户最新上传视频的列表

支持格式

XML/JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户的id
catatree false string 视频所在分类树,默认为1
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{"code":200,…,data[]},加jsonp=a后返回/* */a({"code":200,…,data[]})
numPerPage false int 平均每页取多少条数据
pageNum false int 取第几页
ptime true float 13位的当前时间毫秒级时间戳
startDate false string 开始日期,格式:yyyy-MM-dd
endDate false string 结束日期,格式:yyyy-MM-dd

附:可以添加参数catatree,来获取一个视频分类下的全部视频列表

请求成功返回JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: [
  {
    tag: "4545",
    mp4: "http://mpv.videocc.net/b6df8eaaa8/c/b6df8eaaa8cfd86d2fb7f5a7bc40bcec_1.mp4",
    title: "Wildlife",
    df: 3,
    times: "33",
    vid: "b6df8eaaa8cfd86d2fb7f5a7bc40bcec_b",
    mp4_1: "http://mpv.videocc.net/b6df8eaaa8/c/b6df8eaaa8cfd86d2fb7f5a7bc40bcec_1.mp4",
    mp4_2: "http://mpv.videocc.net/b6df8eaaa8/c/b6df8eaaa8cfd86d2fb7f5a7bc40bcec_2.mp4",
    mp4_3: "http://mpv.videocc.net/b6df8eaaa8/c/b6df8eaaa8cfd86d2fb7f5a7bc40bcec_3.mp4",
    cataid: "1491388002485",
    swf_link: "http://player.polyv.net/videos/b6df8eaaa8cfd86d2fb7f5a7bc40bcec_b.swf",
    status: "61",
    seed: 0,
    playerwidth: "600",
    duration: "00:00:30",
    first_image: "http://img.videocc.net/uimage/b/b6df8eaaa8/c/b6df8eaaa8cfd86d2fb7f5a7bc40bcec_2.jpg",
    original_definition: "1280x720",
    context: "dfdf45",
    playerheight: "337",
    ptime: "2017-04-05 14:15:52",
    source_filesize: 26246026,
    filesize: [
      1261737,
      2269400,
      5088952
    ],
    md5checksum: "d8c2eafd90c266e19ab9dcacc479f8af",
    hls: [
      "http://hls.videocc.net/b6df8eaaa8/b/b6df8eaaa8cfd86d2fb7f5a7bc40bcec_1.m3u8",
      "http://hls.videocc.net/b6df8eaaa8/b/b6df8eaaa8cfd86d2fb7f5a7bc40bcec_2.m3u8",
      "http://hls.videocc.net/b6df8eaaa8/b/b6df8eaaa8cfd86d2fb7f5a7bc40bcec_3.m3u8"
    ]
  }
  ],
  total: 1
}

请求失败返回json示例

{
  code: 400,
  status: "error",
  message: "the sign is not right.",
  data: ""
}

字段说明

字段 说明
code 请求返回状态码
status 请求返回状态
message 请求返回信息
tag 视频标签
mp4 MP4源文件
title 标题
df 视频码率数
times 播放次数
vid 视频id
mp4_1 流畅码率mp4格式视频地址
mp4_2 高清码率mp4格式视频地址
mp4_3 超清码率mp4格式视频地址
cataid 分类id, 如1为根目录
swf_link 返回视频flash链接
status 视频状态码(data中的status)
seed 加密视频为1,非加密为0
playerwidth 视频宽度
duration 时长
first_image 视频首图
original_definition 最佳分辨率
context 视频描述
playerheight 视频高度
ptime 视频上传日期
source_filesize 源视频文件大小
md5checksum 上传到POLYV云平台的视频源文件的MD5值,可以用来校验是否上传错误或完整
hls 流畅、高清、超清清晰度的m3u8
total 视频总数
视频状态码 含义
60/61 已发布
10 等待编码
20 正在编码
50 等待审核
51 审核不通过
-1 已删除

PHP示例代码

<?php
  header("Content-type: text/html; charset=utf-8");
  $userid="7d26575efe";
  $catatree="1";
  $format="json";
  $jsonp="";
  $numPerPage=10000;
  $pageNum=1;
  $ptime=time()*1000;
  $secretkey="ABIEn1UJht";
  $startDate="2017-08-19";
  $endDate="2017-08-28";
  $post_data = array (
      "catatree" => $catatree,
      "endDate" => $endDate,
      "format" => $format,
      "jsonp" => $jsonp,
      "numPerPage" => $numPerPage,
      "pageNum" => $pageNum,
      "ptime" => $ptime,
      "startDate" => $startDate, 
  );
  $str="";
  foreach ($post_data as $key => $value) {
   if (empty($value)) {
      unset($post_data[$key]);
  }
   else $str.=$key."=".$value."&";
  }
  $str=substr($str,0,(strlen($str)-1));
  $str.=$secretkey;
  $hash=strtoupper(sha1($str));
  $post_data["sign"]=$hash;
  $url="http://api.polyv.net/v2/video/{$userid}/get-new-list";
  $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);
?>

js示例代码

<script type="text/ecmascript" src="http://demo.polyv.net/xieyp/sha1.js"></script>
<script type="text/ecmascript" src="http://demo.polyv.net/xieyp/jquery-3.2.1.min.js"></script>
<script type="text/javascript">
var userid="7d26575efe";
var date = new Date();
var timestamp=date.getTime();
var catatree="1";
var startDate="2017-08-19";
var endDate="2017-08-28";
var secrectKey = "ABIEn1UJht";
var str='catatree='+catatree+'&endDate='+endDate+'&ptime='+timestamp+'&startDate='+startDate+secrectKey;
var sign = hex_sha1(str).toUpperCase();
$.ajax({ 
    url: "http://api.polyv.net/v2/video/"+userid+"/get-new-list?catatree="+catatree+"&endDate="+endDate+"&ptime="+timestamp+"&startDate="+startDate+"&sign="+sign,
    type: 'GET',
    dataType: 'json',
    success:function(data){
      console.log(data);  
   } 
});
</script>

js文件下载

1、sha1.js下载
2、jquery-3.2.1.min.js下载

获取全部最新视频信息

如果想获取全部视频的信息,可以将进行如下设置:pageNum=1;numPerPage=10000其中&pageNum=1&numPerPage=10000表示把所有视频弄到一页来获取,这一页的集合里面的视频数有10000个。

sign的生成规则

catatree=参数&endDate=参数&format=参数&jsonp=参数&numPerPage=参数&pageNum=参数&ptime=参数&startDate=参数secureKey经过SHA-1加密再经过大写化
(注意:参数为空时,则在生成sign的时候不需要添加此字段。例如如果这里没有jsonp,则不需要拼接&jsonp=参数)

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

按标题查找视频

点击这里查看旧版

接口URL

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

接口说明

按视频标题查询视频列表

支持格式

XML/JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户的id
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})
keyword false string 视频标题
numPerPage false int 每页显示数量
pageNum false int 页码
ptime true string 13位当前时间的毫秒级时间戳

返回结果

<xml>
    <code>200</code>
    <status>success</status>
    <message>success</message>
    <data>
        <tag></tag>
        <mp4>http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_1.mp4</mp4>
        <title>Wildlife</title>
        <df>3</df>
        <times>30</times>
        <vid>7d26575efe097ad66523d19b094c8a8f_7</vid>
        <mp4_1>http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_1.mp4</mp4_1>
        <mp4_2>http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_2.mp4</mp4_2>
        <mp4_3>http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_3.mp4</mp4_3>
        <cataid>1491449370131</cataid>
        <swf_link>http://player.polyv.net/videos/7d26575efe097ad66523d19b094c8a8f_7.swf</swf_link>
        <status>61</status>
        <seed>1</seed>
        <playerwidth>600</playerwidth>
        <duration>00:00:30</duration>
        <first_image>http://img.videocc.net/uimage/7/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_5.jpg</first_image>
        <original_definition>1280x720</original_definition>
        <context></context>
        <playerheight>337</playerheight>
        <ptime>2017-04-06 15:23:36</ptime>
        <source_filesize>26246026</source_filesize>
        <filesize>1272725</filesize>
        <filesize>2279413</filesize>
        <filesize>5108761</filesize>
        <md5checksum>d8c2eafd90c266e19ab9dcacc479f8af</md5checksum>
        <hls>http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_1.m3u8</hls>
        <hls>http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_2.m3u8</hls>
        <hls>http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_3.m3u8</hls>
    </data>
</xml>

JSON示例

{
    code: 200,
    status: "success",
    message: "success",
    data: [{
        tag: "",
        mp4: "http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_1.mp4",
        title: "Wildlife",
        df: 3,
        times: "30",
        vid: "7d26575efe097ad66523d19b094c8a8f_7",
        mp4_1: "http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_1.mp4",
        mp4_2: "http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_2.mp4",
        mp4_3: "http://mpv.videocc.net/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_3.mp4",
        cataid: "1491449370131",
        swf_link: "http://player.polyv.net/videos/7d26575efe097ad66523d19b094c8a8f_7.swf",
        status: "61",
        seed: 1,
        playerwidth: "600",
        duration: "00:00:30",
        first_image: "http://img.videocc.net/uimage/7/7d26575efe/f/7d26575efe097ad66523d19b094c8a8f_5.jpg",
        original_definition: "1280x720",
        context: "",
        playerheight: "337",
        ptime: "2017-04-06 15:23:36",
        source_filesize: 26246026,
        filesize: [
            1272725,
            2279413,
            5108761
        ],
        md5checksum: "d8c2eafd90c266e19ab9dcacc479f8af",
        hls: [
            "http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_1.m3u8",
            "http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_2.m3u8",
            "http://hls.videocc.net/7d26575efe/7/7d26575efe097ad66523d19b094c8a8f_3.m3u8"
        ]
        }]
}

请求失败返回json示例

{
    code: 400,
    status: "error",
    message: "the sign is not right.",
    data: ""
}

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="efbb4ae8ac";//必选
$format="";
$jsonp="";
$numPerPage=100;
$pageNum=1;
$ptime=time()*1000;//必选
$keyword="测试";
$secretkey="hbjCVBhnth";
$post_data = array (
    "format" => $format,
    "jsonp" => $jsonp,
    "keyword"=>$keyword,
    "numPerPage" => $numPerPage,
    "pageNum" => $pageNum,
    "ptime" => $ptime,
);
$str="";
foreach ($post_data as $key => $value){
    if (!empty($value)) {
        $str.=$key."=".$value."&";
    }else{
        unset($post_data[$key]);
    }
}
$str=substr($str, 0,strlen($str)-1);
$str.=$secretkey;
// echo $str;
// die();
$hash=strtoupper(sha1($str));
$post_data["sign"] = $hash;
// var_dump($post_data);
// exit();
$url="http://api.polyv.net/v2/video/{$userid}/search";
$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);
?>

字段说明

字段 说明
code 请求返回状态码
status 请求返回状态
message 请求返回信息
tag 视频标签
mp4 MP4源文件
title 标题
df 视频码率数
times 播放次数
vid 视频id
mp4_1 流畅码率mp4格式视频地址
mp4_2 高清码率mp4格式视频地址
mp4_3 超清码率mp4格式视频地址
cataid 分类id, 如1为根目录
swf_link 返回视频flash链接
status 视频状态码(data中的status)
seed 加密视频为1,非加密为0
playerwidth 视频宽度
duration 时长
first_image 视频首图
original_definition 最佳分辨率
context 视频描述
playerheight 视频高度
ptime 视频上传日期
source_filesize 源视频文件大小
md5checksum 上传到POLYV云平台的视频源文件的MD5值,可以用来校验是否上传错误或完整
hls 流畅、高清、超清清晰度的m3u8
total 视频总数

 

视频状态码 含义
60/61 已发布
10 等待编码
20 正在编码
50 等待审核
51 审核不通过
-1 已删除

sign的生成规则

format=参数&jsonp=参数&keyword=参数&numPerPage=参数&pageNum=参数&ptime=参数secureKey经过SHA-1加密再经过大写化
(注意:参数为空时,则在生成sign的时候不需要添加此字段。例如如果这里没有t,则不需要拼接&t=参数)

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