按标签查找视频

接口URL

http://api.polyv.net/v2/video/{userid}/search

接口说明

按视频标签查找视频列表

支持格式

XML/JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名	必选	类型及范围	说明
userid	true	string	POLYV用户ID，http://api.polyv.net/v2/video/{userid}/search 中的{userid}需要替换为POLYV用户ID的值
format	false	string	默认返回json格式，如果format=xml返回xml格式
jsonp	false	string	例如，正常情况{error:0,data:””}，加 jsonp=a后返回a({error:0,data:””})
numPerPage	false	int	页数
pageNum	false	int	页码
ptime	true	string	当前时间的毫秒级时间戳（13位），3分钟内有效
tag	false	string	视频标签
sign	true	string	签名，为40位大写的SHA1值

PHP示例代码

<?php
$userid="9f1e0689e1";//必选
$format="";
$jsonp="";
$numPerPage=100;
$pageNum=1;
$ptime=time()*1000;//必选
$tag="刘诗昆";
$secretkey="AkDipaULWw";
$post_data = array (
    "format" => $format,
    "jsonp" => $jsonp,
    "numPerPage" => $numPerPage,
    "pageNum" => $pageNum,
    "ptime" => $ptime,
    "tag" => $tag
);
$str="";
foreach ($post_data as $key => $value){
    if (!empty($value)) {
        $str.=$key."=".$value."&";
    }else{
        unset($post_data[$key]); 
    }
}
$str=substr($str, 0,strlen($str)-1);
$str.=$secretkey;
// echo $str;
// die();
$hash=strtoupper(sha1($str));
$post_data["sign"] = $hash;
// var_dump($post_data);
// exit();
$url="http://api.polyv.net/v2/video/{$userid}/search";
$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);
?>

返回结果

<xml>
	<code>200</code>
	<status>success</status>
	<message>success</message>
	<data>
		<tag>刘诗昆,110435</tag>
		<mp4>http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4</mp4>
		<title>刘诗昆钢琴教程4</title>
		<df>1</df>
		<times>68</times>
		<vid>9f1e0689e1a156fc6b373eab9195b0c6_9</vid>
		<mp4_1>http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4</mp4_1>
		<cataid>1470122811372</cataid>
		<swf_link>http://player.polyv.net/videos/9f1e0689e1a156fc6b373eab9195b0c6_9.swf</swf_link>
		<status>60</status>
		<seed>0</seed>
		<playerwidth>600</playerwidth>
		<duration>00:35:52</duration>
		<first_image>http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_5.jpg</first_image>
		<original_definition>384x294</original_definition>
		<context></context>
		<playerheight>458</playerheight>
		<ptime>2016-04-28 12:11:10</ptime>
		<source_filesize>65153042</source_filesize>
		<filesize>69789952</filesize>
		<md5checksum>b6dc8cd9ac9f189e5e2efeba8fd62d9b</md5checksum>
		<hls>http://hls.videocc.net/9f1e0689e1/9/9f1e0689e1a156fc6b373eab9195b0c6_1.m3u8</hls>
	</data>
</xml>

JSON示例

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": [
    {
      "tag": "刘诗昆,110435",
      "mp4": "http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4",
      "title": "刘诗昆钢琴教程4",
      "df": 1,
      "times": "68",
      "vid": "9f1e0689e1a156fc6b373eab9195b0c6_9",
      "mp4_1": "http://mpv.videocc.net/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_1.mp4",
      "cataid": "1470122811372",
      "swf_link": "http://player.polyv.net/videos/9f1e0689e1a156fc6b373eab9195b0c6_9.swf",
      "status": "60",
      "seed": 0,
      "playerwidth": "600",
      "duration": "00:35:52",
      "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_5.jpg",
      "original_definition": "384x294",
      "context": "",
      "playerheight": "458",
      "ptime": "2016-04-28 12:11:10",
      "source_filesize": 65153042,
      "filesize": [
        69789952
      ],
      "md5checksum": "b6dc8cd9ac9f189e5e2efeba8fd62d9b",
      "hls": [
        "http://hls.videocc.net/9f1e0689e1/9/9f1e0689e1a156fc6b373eab9195b0c6_1.m3u8"
      ]
    }
  ]
}

字段说明

字段	说明
code	返回码
status	返回状态
message	返回信息
total	总数
tag	标签
mp4	mp4格式视频地址
title	标题
df	视频码率数
times	播放次数
vid	视频id
mp4_1	流畅码率mp4格式视频地址
cataid	分类id， 如1为根目录
swf_link	返回flash链接
status	视频状态
seed	加密视频为1，非加密为0
playerwidth	视频宽度
duration	时长
first_image	视频首图
original_definition	最佳分辨率
context	视频描述
playerheight	视频高度
ptime	视频上传日期
source_filesize	源文件大小
filesize	编码后各个清晰度视频的文件大小，类型为array
md5checksum	md5校验码
hls	m3u8地址

sign的生成规则

format=参数&jsonp=参数&numPerPage=参数&pageNum=参数&ptime=参数&tag=参数secureKey经过SHA-1加密再经过大写化 (注意：参数为空时，则在生成sign的时候不需要添加此字段。例如如果这里没有t，则不需要拼接&t=参数)