获取单个视频信息

点击这里查看旧版

接口URL

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

接口说明

获取用户单条视频记录

支持格式

XML/JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
vid true string 视频ID
userid true string 用户id(在url中使用,请求的时候不需要提交)
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:””})

返回结果

<xml>
    <code>200</code>
    <status>success</status>
    <message>success</message>
    <data>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_0_b.jpg</images_b>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_1_b.jpg</images_b>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_2_b.jpg</images_b>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_3_b.jpg</images_b>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_4_b.jpg</images_b>
        <images_b>3828390191/5/38283901913ea95224af2bbd9e990ea5_5_b.jpg</images_b>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_0.jpg</images>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_1.jpg</images>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_2.jpg</images>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_3.jpg</images>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_4.jpg</images>
        <images>3828390191/5/38283901913ea95224af2bbd9e990ea5_5.jpg</images>
        <tag></tag>
        <mp4>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_1.mp4</mp4>
        <title>0001.优酷网-【经典回顾】加州旅馆 2004版 中英字幕 老鹰乐队[超清版]-0003</title>
        <df>3</df>
        <times>0</times>
        <vid>38283901913ea95224af2bbd9e990ea5_3</vid>

        <mp4_1>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_1.mp4</mp4_1>
        <mp4_2>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_2.mp4</mp4_2>
        <mp4_3>http://mpv.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_3.mp4</mp4_3>
        <cataid>1</cataid>
        <swf_link>http://player.polyv.net/videos/38283901913ea95224af2bbd9e990ea5_3.swf</swf_link>
        <status>61</status>
        <seed>0</seed>
        <flv1>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_1.flv</flv1>
        <flv2>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_2.flv</flv2>
        <flv3>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_3.flv</flv3>
        <sourcefile></sourcefile>
        <playerwidth>600</playerwidth>
        <default_video>http://plvod01.videocc.net/3828390191/5/38283901913ea95224af2bbd9e990ea5_3.flv</default_video>
        <duration>00:02:01</duration>
        <first_image>http://img.videocc.net/uimage/3/3828390191/first_image/a15c4fe5-9fdc-4a38-adc0-2e6097757fbb_s.jpg</first_image>
        <original_definition>1104x622</original_definition>
        <context></context>
        <playerheight>337</playerheight>
        <ptime>2017-04-25 11:35:06</ptime>
        <source_filesize>22502693</source_filesize>
        <filesize>4755814</filesize>
        <filesize>8694257</filesize>
        <filesize>21784017</filesize>
        <md5checksum>8c6a35b5e92f84437c56de6f40b39973</md5checksum>
        <hls>http://hls.videocc.net/3828390191/3/38283901913ea95224af2bbd9e990ea5_1.m3u8</hls>
        <hls>http://hls.videocc.net/3828390191/3/38283901913ea95224af2bbd9e990ea5_2.m3u8</hls>
        <hls>http://hls.videocc.net/3828390191/3/38283901913ea95224af2bbd9e990ea5_3.m3u8</hls>
        <previewVid>v63c44pl69mnc04m6l6512ck4468m41cl_6</previewVid>
    </data>
</xml>

JSON示例

{
code: 200,
status: "success",
message: "success",
data: [
{
images_b: [
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0_b.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1_b.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2_b.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_3_b.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_4_b.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_5_b.jpg"
],
images: [
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_3.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_4.jpg",
"36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_5.jpg"
],
imageUrls: [
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_3.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_4.jpg",
"http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_5.jpg"
],
tag: "标签",
mp4: "http://mpv.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.mp4",
title: "upload上传视频",
df: 2,
times: "0",
vid: "36e77ba39cfe07c3a3812ed7735c71ea_3",
mp4_1: "http://mpv.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.mp4",
mp4_2: "http://mpv.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.mp4",
cataid: "1",
swf_link: "http://player.polyv.net/videos/36e77ba39cfe07c3a3812ed7735c71ea_3.swf",
status: "61",
seed: 1,
flv1: "http://plvod01.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.plv",
flv2: "http://plvod01.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_2.plv",
sourcefile: "",
playerwidth: "600",
default_video: "http://plvod01.videocc.net/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_1.plv",
duration: "00:00:33",
first_image: "http://img.videocc.net/uimage/3/36e77ba39c/a/36e77ba39cfe07c3a3812ed7735c71ea_0.jpg",
original_definition: "672x378",
context: "视频文档描述",
playerheight: "490",
ptime: "2017-12-04 09:41:10",
source_filesize: 2295887,
filesize: [
1273674,
2262596
],
md5checksum: "44b145c6bea7dd826191990dfb38d1fd",
hls: [
"http://hls.videocc.net/36e77ba39c/3/36e77ba39cfe07c3a3812ed7735c71ea_1.m3u8",
"http://hls.videocc.net/36e77ba39c/3/36e77ba39cfe07c3a3812ed7735c71ea_2.m3u8"
],
tsfilesize1: "1459696",
tsfilesize2: "2528832",
tsfilesize3: "0",
previewVid: "263c44pl69mnc04m6l6512ck4468m41cl_6"
}
]
}
)

失败返回json(不带jsonp)

{
    code: 400,
    status: "error",
    message: "ptime is too old.",
    data: ""
}

字段说明

字段 说明
error 错误提示
swf_link 返回flash连接
tag 视频标签
mp4 MP4源文件
playerwidth 视频宽度
title 标题
duration 时长
filesize 编码后各个清晰度视频的文件大小(单位:字节),类型为array
first_image 视频首图
times 播放次数
context 视频描述
original_definition 最佳分辨率
images 视频截图
playerheight 视频高度
ptime 视频上传日期
context 内容
ptime 上传时间
vid 视频id
previewVid 预览视频id
cataid 分类id, 如1为根目录
default_video 用户默认播放视频
df 视频码率数
flv1 流畅码率flv格式视频地址
flv2 高清码率flv格式视频地址
flv3 超清码率flv格式视频地址
mp4_1 流畅码率mp4格式视频地址
mp4_2 高清码率mp4格式视频地址
mp4_3 超清码率mp4格式视频地址
hlsIndex 索引文件,记录每个清晰度的m3u8的链接
hls_1 流畅清晰度的m3u8
hls_2 高清清晰度的m3u8
hls_3 超清清晰度的m3u8
images_b 视频截图大图地址
seed 加密视频为1,非加密为0
status 视频状态
视频状态码 含义
60/61 已发布
10 等待编码
20 正在编码
50 等待审核
51 审核不通过
-1 已删除

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
$format="json";
$jsonp="";//(注意如果这里如果没有jsonp,则不需要拼接&jsonp=参数)
$ptime=time()*1000;//13位
$vid="382839019131be68715e9455f8d0971a_3";
$secretkey="tIQp4ATe9Z";
if (empty($jsonp)) {
    $str="format=".$format."&ptime=".$ptime."&vid=".$vid.$secretkey;
}else{
    $str="format=".$format."&jsonp=".$jsonp."&ptime=".$ptime."&vid=".$vid.$secretkey;
}
//echo $str.'';
$hash=strtoupper(sha1($str));
//echo $hash.'';
$url="http://api.polyv.net/v2/video/{$userid}/get-video-msg";
$post_data = array (
    "format" => $format,
    "jsonp" => $jsonp,
    "ptime" => $ptime,
    "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);
?>

签名规则:

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

1、请求参数为

ptime = "1492591990000"
vid = "382839019131be68715e9455f8d0971a_3"
format = "json"

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

format = "json"
ptime = "1492591990000"
vid = "382839019131be68715e9455f8d0971a_3"

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(从点播后台获取,假设secretkey的值为tIQp4ATe9Z),如下:

format=json&ptime=1492591990000&vid=382839019131be68715e9455f8d0971a_3tIQp4ATe9Z

4、生成签名sign

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

删除视频的全部打点信息

接口URL

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

接口说明

通过API删除视频的全部视频打点信息

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string 用户ID
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
vid string 视频ID
sign string 签名,为40位大写的SHA1值

JSON示例

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

字段说明

字段 说明
status 成功/失败状态
code 成功/失败代码
message 成功/失败信息
data 成功/失败数据

php请求示例

<?php
  $userid="8f8482aaab";
  $secretkey="AiDQw1mAmi";
  $vid="8f8482aaab8fe7ea12e3314a11a061fc_8";
  $ptime=time()*1000;
  $str="ptime=$ptime&vid=$vid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/deleteKeyFrame?ptime=$ptime&vid=$vid&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

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

以下是示例过程:

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

ptime="1476753635000";
vid="8f8482aaab8fe7ea12e3314a11a061fc_8";

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

ptime=1476753635000&vid=8f8482aaab8fe7ea12e3314a11a061fc_8AiDQw1mAmi

3. 生成签名sign

sign为40位大写的SHA1值:

B2E2D7AAB9DFCC8CBFE7EDC919B5F8F6F4E104BC
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
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...

获取单个视频的答题日志

接口URL

http://v.polyv.net/uc/examlog/list?vid=$vid

接口说明

获取单个视频的答题日志

支持格式

JSON

HTTP请求方式

POST, GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
vid true string 视频ID

返回错误列表

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

JSON示例

[
{
"logid": 119381,
"examId": "1487c38a9a2",
"userid": "d81a899efa",
"videoPoolId": "d81a899efacff6e71492cd4eaaff5e73_d",
"question": "阅读理解的第一个步骤是?",
"answer": "[\"B.速读短文\"]",
"isCorrect": 1,
"playId": "1411791245147629321",
"ipAddress": "14.18.236.66",
"province": "广东省",
"isp": "电信",
"operatingSystem": "Windows 7",
"browser": "Chrome",
"dateAdded": 1411796209000
},
{
"logid": 119409,
"examId": "1487c38a9a2",
"userid": "d81a899efa",
"videoPoolId": "d81a899efacff6e71492cd4eaaff5e73_d",
"question": "阅读理解的第一个步骤是?",
"answer": "[\"B.速读短文\"]",
"isCorrect": 1,
"playId": "1411799817614676332",
"ipAddress": "14.18.236.66",
"province": "广东省",
"isp": "电信",
"operatingSystem": "Windows 7",
"browser": "Chrome",
"dateAdded": 1411799888000
}
]

字段说明

字段 说明
logid 日志的id
examId 问答题目的id
userid 用户的id
videoPoolId 视频的id
question 问题
answer 答案
isCorrect 回答是否正确
playId 播放视频时产生的播放session的id
ipAddress IP地址
province 省份
isp 互联网服务提供商
operationSystem 操作系统
browser 浏览器
dateAdded 日志创建时间
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

获取不通过视频列表

点击这里查看旧版

接口URL

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

接口说明

获取用户不能通过审核的视频列表

支持格式

XML/JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前13位毫秒级时间戳,3分钟内有效
userid true string 用户id
pageNum true int 取第几页
numPerPage true int 平均每页多少条数据
sign true string 非业务参数,签名,40位大写SHA1值
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})

返回结果xml示例

<xml>
  <code>200</code>
  <status>success</status>
  <message></message>
  <total>1</total>
  <data>
    <videodetail>
    <tag></tag>
    <mp4>http://mpv.videocc.net/3828390191/0/382839019120b4ec44ca42b354b660d0_1.mp4</mp4>
    <df>1</df>
    <times>0</times>
    <vid>382839019120b4ec44ca42b354b660d0_3</vid>
    <mp4_1>http://mpv.videocc.net/3828390191/0/382839019120b4ec44ca42b354b660d0_1.mp4</mp4_1>
    <cataid>1</cataid>
    <swf_link>http://player.polyv.net/videos/382839019120b4ec44ca42b354b660d0_3.swf</swf_link>
    <status>51</status>
    <seed>0</seed>
    <playerwidth>600</playerwidth>
    <duration>00:04:05</duration>
    <first_image>http://img.videocc.net/uimage/3/3828390191/0/382839019120b4ec44ca42b354b660d0_0.jpg</first_image>
    <original_definition>512x288</original_definition>
    <context></context>
    <playerheight>337</playerheight>
    <ptime>2017-04-26 10:48:50</ptime>
    <source_filesize>8747234</source_filesize>
    <filesize>9294215</filesize>
    <md5checksum>dd504186e1d3ab072ac844e9174355f9</md5checksum>
    <hls>http://hls.videocc.net/3828390191/3/382839019120b4ec44ca42b354b660d0_1.m3u8</hls>
    </videodetail>
  </data>
</xml>

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: [
  {
    tag: "",
    mp4: "http://mpv.videocc.net/3828390191/0/382839019120b4ec44ca42b354b660d0_1.mp4",
    title: "1221",
    df: 1,
    times: "0",
    vid: "382839019120b4ec44ca42b354b660d0_3",
    mp4_1: "http://mpv.videocc.net/3828390191/0/382839019120b4ec44ca42b354b660d0_1.mp4",
    cataid: "1",
    swf_link: "http://player.polyv.net/videos/382839019120b4ec44ca42b354b660d0_3.swf",
    status: "51",
    seed: 0,
    playerwidth: "600",
    duration: "00:04:05",
    first_image: "http://img.videocc.net/uimage/3/3828390191/0/382839019120b4ec44ca42b354b660d0_0.jpg",
    original_definition: "512x288",
    context: "",
    playerheight: "337",
    ptime: "2017-04-26 10:48:50",
    source_filesize: 8747234,
    filesize: [
      9294215
    ],
    md5checksum: "dd504186e1d3ab072ac844e9174355f9",
    hls: [
        "http://hls.videocc.net/3828390191/3/382839019120b4ec44ca42b354b660d0_1.m3u8"
    ]
  }
  ],
  total: 1
}

返回错误json

{
  "code":400,
  "status":"error",
  "message":"ptime is too old.",
  "data":""
}

字段说明

字段 说明
error 错误提示
swf_link 返回flash连接
duration 返回时长
title 标题
first_image 视频图片
times 点击次数
tag 标签
context 内容
ptime 上传时间
vid 视频id

PHP示例代码

<?php
  header("Content-type: text/html; charset=utf-8");
  $userid="3828390191";
  $format="json";
  $jsonp="";//(注意如果这里如果没有jsonp,则不需要拼接&jsonp=参数)
  $numPerPage=100;
  $pageNum=1;
  $ptime=time()*1000;//13位
  $secretkey="tIQp4ATe9Z";
  if (empty($jsonp)) {
      $str="format=".$format."&numPerPage=".$numPerPage."&pageNum=".$pageNum."&ptime=".$ptime.$secretkey;
  }else{
      $str="format=".$format."&jsonp=".$jsonp."&numPerPage=".$numPerPage."&pageNum=".$pageNum."&ptime=".$ptime.$secretkey;
  }
  //echo $str.'<br>';
  $hash=strtoupper(sha1($str));
  //echo $hash.'<br>';
  $url="http://api.polyv.net/v2/video/{$userid}/get-illegal-list";
  $post_data = array (
      "format" => $format,
      "jsonp" => $jsonp,
      "numPerPage" => $numPerPage,
      "pageNum" => $pageNum,
      "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" = "1493177403000"
"format" = "json"
"numPerPage" = "100"
"pageNum" = "1"

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

"format" = "json"
"numPerPage" = "100"
"pageNum" = "1"
"ptime" = "1493177403000"

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

format=json&numPerPage=100&pageNum=1&ptime=1493177403000tIQp4ATe9Z

4、生成签名sign

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

获取视频分类的信息

接口URL

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

接口说明

作用:获取视频分类

支持格式

JSON

HTTP请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
cataid string 视频分类的id
readtoken string 用户的读取钥匙
sign string 签名,为40位大写的SHA1值
format string 默认只返回json格式,无需format

返回结果

{
"error": "0",
"data": [
{
"articles": "1",
"cataename": "",
"userid": "e2e84a7383",
"templateid": "0",
"parentid": "1",
"catatype": "0",
"cataname": "测试1",
"ext": "",
"hostid": "e",
"cataurl": "",
"extype": "\u0000\u0000\u0000",
"lmodify": "1410230776538",
"isdel": "0",
"catasort": "",
"ptime": "1410230776538",
"catatree": "1,1410230776538",
"cataid": "1410230776538"
},
{
"articles": "0",
"cataename": "",
"userid": "e2e84a7383",
"templateid": "0",
"parentid": "1410230776538",
"catatype": "0",
"cataname": "测试1-1",
"ext": "",
"hostid": "e",
"cataurl": "",
"extype": "\u0000\u0000\u0000",
"lmodify": "1410431619199",
"isdel": "0",
"catasort": "",
"ptime": "1410431619199",
"catatree": "1,1410230776538,1410431619199",
"cataid": "1410431619199"
},
{
"articles": "0",
"cataename": "",
"userid": "e2e84a7383",
"templateid": "0",
"parentid": "1410230776538",
"catatype": "0",
"cataname": "测试1-2",
"ext": "",
"hostid": "e",
"cataurl": "",
"extype": "\u0000\u0000\u0000",
"lmodify": "1410431629027",
"isdel": "0",
"catasort": "",
"ptime": "1410431629027",
"catatree": "1,1410230776538,1410431629027",
"cataid": "1410431629027"
},
{
"articles": "1",
"cataename": "",
"userid": "e2e84a7383",
"templateid": "0",
"parentid": "1",
"catatype": "0",
"cataname": "测试2",
"ext": "",
"hostid": "e",
"cataurl": "",
"extype": "\u0000\u0000\u0000",
"lmodify": "1410230787507",
"isdel": "0",
"catasort": "",
"ptime": "1410230787507",
"catatree": "1,1410230787507",
"cataid": "1410230787507"
}
]
}

字段 说明
error 错误提示
articles 视频数目
userid 用户id
templateid 模板id
parentid 父分类id
catatype 分类类型
cataname 分类名称
hostid 主机id
extype 以前的类型
isdel 已经删除
catasort 分类排序
ptime 上传时间
catatree 视频所在分类
cataid 分类id, 如1为根目录

php请求示例

<?php
  $readtoken = "c89b576f-2abd-485f-81f9-245d5ba7807f";
  $cataid = "1499329701906";
  $format ="";
  $secretkey ="E8qVf7rCFo";
  $str = "cataid=".$cataid."&readtoken=".$readtoken.$secretkey;
  $sign = strtoupper(sha1($str));
  $url = "http://v.polyv.net/uc/services/rest?method=getCata&cataid=".$cataid."&readtoken=".$readtoken."&format=".$format."&sign=".$sign;
  $content = file_get_contents($url);
  echo $content;
?>

 

签名规则

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

以下是示例过程:

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

cataid="1499329701906";
readtoken="c89b576f-2abd-485f-81f9-245d5ba7807f"

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

cataid=1499329701906&readtoken=c89b576f-2abd-485f-81f9-245d5ba7807fE8qVf7rCFo

3. 生成签名sign

sign为40位大写SHA1值:

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

设置视频打点

接口URL

http://api.polyv.net/v2/video/{userId}/saveKeyFrame

接口说明

设置视频打点

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string POLYV用户ID,http://api.polyv.net/v2/video/{userId}/saveKeyFrame中的{userid}需要替换为POLYV用户ID的值
vid string 视频的ID
desc string 打点描述,如果上传多个打点用英文逗号","隔开
seconds string 打点秒数【第seconds秒】,如果上传多个打点用英文逗号","隔开
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写的SHA1值

注意事项

    seconds(打点秒数【第seconds秒】)必须要小于视频长度;

    dess(打点描述)的个数必须要和seconds的个数相同。

响应参数

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

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: "the key frame add successfully"
}

php请求示例

<?php
$desc = "第1个打点,第2个打点,第3个打点";
$seconds = "6,16,26";
$userid = "8205ac89d3";
$ptime = time()*1000;
$vid = "8205ac89d3ac2b9a7e72a71d16799803_8";
$secretkey = "kXmHMLeX6M";
$str = "ptime=$ptime"."&userid=$userid"."&vid=$vid".$secretkey;
$sign = strtoupper(sha1($str));
$url = "http://api.polyv.net/v2/video/$userid/saveKeyFrame?ptime=$ptime&desc=$desc&seconds=$seconds&vid=$vid&sign=$sign&";
$content = file_get_contents($url);
echo $content;
?>

签名规则

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

以下是示例过程:

1. 请求参数为:

userid="8205ac89d3"
ptime="1474160490000"
vid="8205ac89d39ad353f0350e5ce73a7244_8"

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

ptime="1474160490000"
userid="8205ac89d3"
vid="8205ac89d39ad353f0350e5ce73a7244_8"

3. 连接字符串

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

ptime=1474160490000&userid=8205ac89d3&vid=8205ac89d39ad353f0350e5ce73a7244_8kXmHMLeX6M

4. 生成签名sign

sign为40位大写的SHA1值:

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

获取视频分类目录

接口URL

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

接口说明

作用:获取视频分类目录

支持格式

JSON

HTTP请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
userid string POLYV用户ID, http://api.polyv.net/v2/user/{userid}/main中的{userid}需要替换为POLYV用户ID的值
cataid int 分类id,默认为根目录,获取该分类下的树结构json
sign string 签名,为40位大写的SHA1值

返回结果

{
    "code": 200, 
    "status": "success", 
    "message": "success", 
    "data": [
        {
            "text": "默认分类 (39) ", 
            "cataname": "默认分类", 
            "catatree": "1", 
            "cataid": 1, 
            "parentid": 0, 
            "videos": 39, 
            "nodes": [
                {
                    "text": "第一个分类 (5) ", 
                    "cataname": "第一个分类", 
                    "catatree": "1,1466071267861", 
                    "cataid": 1466071267861, 
                    "parentid": 1, 
                    "videos": 5, 
                    "nodes": [
                        {
                            "text": "1.1 (3) ", 
                            "cataname": "1.1", 
                            "catatree": "1,1466071267861,1474873773161", 
                            "cataid": 1474873773161, 
                            "parentid": 1466071267861, 
                            "videos": 3
                        }, 
                        {
                            "text": "1.2 (2) ", 
                            "cataname": "1.2", 
                            "catatree": "1,1466071267861,1474873783646", 
                            "cataid": 1474873783646, 
                            "parentid": 1466071267861, 
                            "videos": 2
                        }
                    ]
                }, 
                {
                    "text": "第二个分类 (2) ", 
                    "cataname": "第二个分类", 
                    "catatree": "1,1474873733364", 
                    "cataid": 1474873733364, 
                    "parentid": 1, 
                    "videos": 2
                }, 
                {
                    "text": "第三个分类 (9) ", 
                    "cataname": "第三个分类", 
                    "catatree": "1,1474873744871", 
                    "cataid": 1474873744871, 
                    "parentid": 1, 
                    "videos": 9, 
                    "nodes": [
                        {
                            "text": "3.1 (2) ", 
                            "cataname": "3.1", 
                            "catatree": "1,1474873744871,1474873792718", 
                            "cataid": 1474873792718, 
                            "parentid": 1474873744871, 
                            "videos": 2
                        }, 
                        {
                            "text": "3.2 (6) ", 
                            "cataname": "3.2", 
                            "catatree": "1,1474873744871,1474873800254", 
                            "cataid": 1474873800254, 
                            "parentid": 1474873744871, 
                            "videos": 6
                        }
                    ]
                }, 
                {
                    "text": "第四个分类 (4) ", 
                    "cataname": "第四个分类", 
                    "catatree": "1,1474873756622", 
                    "cataid": 1474873756622, 
                    "parentid": 1, 
                    "videos": 4
                }
            ]
        }
    ]
}

字段 说明
code 成功/失败代码
status 成功/失败代码
message 成功/失败信息
text 分类名和该分类下视频总数的组合
cataname 分类名
cataree 分类树,显示从根目录到该目录每一层的分类id
cataid 分类id,如果为1则是根目录
parentid 上一级分类id,根目录的上一级分类为0
videos 此分类及其子分类视频总数
nodes 该分类的子分类

php请求示例

<?php
  $userid = "4802b9bb81";
  $ptime = time()*1000;
  $secretkey = "fRJiHrsZzw";
  $cataid = "1499328808069";
  $str = "ptime=$ptime"."&userid=$userid".$secretkey;
  $sign = strtoupper(sha1($str));
  $url = "http://api.polyv.net/v2/video/$userid/cataJson?ptime=".$ptime."&cataid=".$cataid."&sign=".$sign;
  $content = file_get_contents($url);
  echo $content;
?>

示例Demo

下面“获取视频分类Demo.zip”提供了两种方法解析jsontree得到目录的demo
一种是使用bootstrap插件treeview
另一种是使用jquery插件treeview(这个方法中通过解析json然后拼凑页面的元素的方法,可以应用于不同插件,方便外部开发者参考调用)

获取视频分类Demo.zip

 

签名规则

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

以下是示例过程:

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

ptime="1470969330000";
userid="4802b9bb81";

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

ptime=1474882994000&userid=4802b9bb81fRJiHrsZzw

3. 生成签名sign

sign为40位大写SHA1值:

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