按标签查找视频

点击这里查看旧版

接口URL

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

接口说明

按视频标签查找视频列表

支持格式

XML/JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string POLYV用户ID,http://api.polyv.net/v2/data/{userid}/viewlog中的{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=参数)

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...