获取单个视频信息
接口描述
1、获取用户单条视频记录
2、接口支持https协议
接口URL
http://api.polyv.net/v2/video/{userid}/get-video-msg
请求方式
POST,GET
接口说明
支持格式
XML/JSON
请求数限制
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>
<videoDetail>
<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/>
<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/>
<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/>
<playerheight>337</playerheight>
<ptime>2017-04-25 11:35:06</ptime>
<source_filesize>22502693</source_filesize>
<filesize1>4755814</filesize1>
<filesize2>8694257</filesize2>
<filesize3>21784017</filesize3>
<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>
<uploader>
<email>test2@zzs.com</email>
<name>test2</name>
<role>上传者</role>
</uploader>
<keepsource>0<keepsource/>
<hlsLevel>open</hlsLevel>
<cataname>新建分类测试</cataname>
</videoDetail>
</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"
],
"aac_link": "http://mpv.videocc.net/28ac0f40b7/8/28ac0f40b7880cca2b03ea7a8f0a8723_7.mp3",
"tsfilesize1": "1459696",
"tsfilesize2": "2528832",
"tsfilesize3": "0",
"previewVid": "263c44pl69mnc04m6l6512ck4468m41cl_6",
"uploader": {
"email": "test2@zzs.com",
"name": "test2",
"role": "上传者"
},
"keepsource": "0",
"hlsLevel": "open",
"cataname": "新建分类测试"
}
]
}
失败返回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
视频上传日期
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格式视频地址
hls_1
流畅清晰度的m3u8
hls_2
高清清晰度的m3u8
hls_3
超清清晰度的m3u8
images_b
视频截图大图地址
imageUrls
视频截图小图url
seed
加密视频为1,非加密为0
status
视频状态
keepsource
是否为源文件,否:0,是:1
uploader.email
上传者邮箱
uploader.name
上传者名称
uploader.role
上传者角色,如管理员,上传者,主账号
hlsLevel
加密等级 open:非授权加密 web:web授权 app:app授权 wxa_app:小程序授权
cataname
分类名称
source_filesize
源视频文件大小,单位为:bytes
aac_link
音频地址,需开启音频切换才返回
md5checksum
上传到POLYV云平台的视频源文件的MD5值,可以用来校验是否上传错误或完整
sourcefile
暂无含义
60/61
已发布
10
等待编码
20
正在编码
40
编码失败
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
Last updated
Was this helpful?