获取单个视频信息

点击这里查看旧版

接口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...