获取单个视频信息

接口描述

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:””})

参数名

必选

类型及范围

说明

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	暂无含义

字段

说明

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

用户默认播放视频

视频码率数

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

PreviousSearch Next搜索视频

Last updated 18 days ago