点击这里查看旧版
接口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 |
startTime | false | string | 开始时间,格式:yyyy-MM-dd HH:mm:ss |
endTime | false | string | 结束时间,格式:yyyy-MM-dd HH:mm:ss |
published | false | int | 1表示结果只包含已发布的视频,0或者不传为包含所有状态的视频 |
附:可以添加参数catatree,来获取一个视频分类下的全部视频列表
注意: 时间范围参数中startTime和endTime的优先级最高
参数值 | 时间范围结果 |
---|---|
startTime和endTime都不为空 | 则startTime<=时间区间<=endTime |
startTime为空,endTime不为空 | 则时间区间为<=endTime |
startTime不为空,endTime为空 | 则时间区间为>=startTime |
startTime和endTime都为空 | 则时间区间以startDate和endDate为准 |
请求成功返回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"
],
"uploader": {
"email": "test2@zzs.com",
"name": "test2",
"role": "上传者"
}
}
],
"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 | 视频总数 |
|uploader.email | 上传者邮箱|
|uploader.name| 上传者名称|
|uploader.role|上传者角色,如管理员,上传者,主账号|
视频状态码 | 含义 |
---|---|
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);
?>
获取全部最新视频信息
如果想获取全部视频的信息,可以将进行如下设置:pageNum=1;numPerPage=10000其中&pageNum=1&numPerPage=10000表示把所有视频弄到一页来获取,这一页的集合里面的视频数有10000个。
sign的生成规则
catatree=参数&endDate=参数&format=参数&jsonp=参数&numPerPage=参数&pageNum=参数&ptime=参数&startDate=参数secureKey经过SHA-1加密再经过大写化
(注意:参数为空时,则在生成sign的时候不需要添加此字段。例如如果这里没有jsonp,则不需要拼接&jsonp=参数)