获取单个视频信息

点击这里查看旧版

接口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> 
    <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>
    </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"
            ],
            "tsfilesize1": "1459696", 
            "tsfilesize2": "2528832", 
            "tsfilesize3": "0", 
            "previewVid": "263c44pl69mnc04m6l6512ck4468m41cl_6", 
            "uploader": {
                "email": "test2@zzs.com", 
                "name": "test2", 
                "role": "上传者"
            },
            "keepsource": "0",
            "hlsLevel": "open"
        }
    ]
}

失败返回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 视频状态
keepsource 是否为源文件,否:0,是:1
uploader.email 上传者邮箱
uploader.name 上传者名称
uploader.role 上传者角色,如管理员,上传者,主账号
hlsLevel 加密等级 open:非授权加密 web:web授权 app:app授权 wxa_app:小程序授权
视频状态码 含义
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...