获取视频分类目录

接口URL

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

接口说明

作用:获取视频分类目录

支持格式

JSON

HTTP请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
userid string POLYV用户ID, http://api.polyv.net/v2/user/{userid}/main中的{userid}需要替换为POLYV用户ID的值
cataid int 分类id,默认为根目录,获取该分类下的树结构json
sign string 签名,为40位大写的SHA1值

返回结果

{
    "code": 200, 
    "status": "success", 
    "message": "success", 
    "data": [
        {
            "text": "默认分类 (39) ", 
            "cataname": "默认分类", 
            "catatree": "1", 
            "cataid": 1, 
            "parentid": 0, 
            "videos": 39, 
            "nodes": [
                {
                    "text": "第一个分类 (5) ", 
                    "cataname": "第一个分类", 
                    "catatree": "1,1466071267861", 
                    "cataid": 1466071267861, 
                    "parentid": 1, 
                    "videos": 5, 
                    "nodes": [
                        {
                            "text": "1.1 (3) ", 
                            "cataname": "1.1", 
                            "catatree": "1,1466071267861,1474873773161", 
                            "cataid": 1474873773161, 
                            "parentid": 1466071267861, 
                            "videos": 3
                        }, 
                        {
                            "text": "1.2 (2) ", 
                            "cataname": "1.2", 
                            "catatree": "1,1466071267861,1474873783646", 
                            "cataid": 1474873783646, 
                            "parentid": 1466071267861, 
                            "videos": 2
                        }
                    ]
                }, 
                {
                    "text": "第二个分类 (2) ", 
                    "cataname": "第二个分类", 
                    "catatree": "1,1474873733364", 
                    "cataid": 1474873733364, 
                    "parentid": 1, 
                    "videos": 2
                }, 
                {
                    "text": "第三个分类 (9) ", 
                    "cataname": "第三个分类", 
                    "catatree": "1,1474873744871", 
                    "cataid": 1474873744871, 
                    "parentid": 1, 
                    "videos": 9, 
                    "nodes": [
                        {
                            "text": "3.1 (2) ", 
                            "cataname": "3.1", 
                            "catatree": "1,1474873744871,1474873792718", 
                            "cataid": 1474873792718, 
                            "parentid": 1474873744871, 
                            "videos": 2
                        }, 
                        {
                            "text": "3.2 (6) ", 
                            "cataname": "3.2", 
                            "catatree": "1,1474873744871,1474873800254", 
                            "cataid": 1474873800254, 
                            "parentid": 1474873744871, 
                            "videos": 6
                        }
                    ]
                }, 
                {
                    "text": "第四个分类 (4) ", 
                    "cataname": "第四个分类", 
                    "catatree": "1,1474873756622", 
                    "cataid": 1474873756622, 
                    "parentid": 1, 
                    "videos": 4
                }
            ]
        }
    ]
}

字段 说明
code 成功/失败代码
status 成功/失败代码
message 成功/失败信息
text 分类名和该分类下视频总数的组合
cataname 分类名
cataree 分类树,显示从根目录到该目录每一层的分类id
cataid 分类id,如果为1则是根目录
parentid 上一级分类id,根目录的上一级分类为0
videos 此分类及其子分类视频总数
nodes 该分类的子分类

php请求示例

<?php
  $userid = "4802b9bb81";
  $ptime = time()*1000;
  $secretkey = "fRJiHrsZzw";
  $cataid = "1499328808069";
  $str = "ptime=$ptime"."&userid=$userid".$secretkey;
  $sign = strtoupper(sha1($str));
  $url = "http://api.polyv.net/v2/video/$userid/cataJson?ptime=".$ptime."&cataid=".$cataid."&sign=".$sign;
  $content = file_get_contents($url);
  echo $content;
?>

示例Demo

下面“获取视频分类Demo.zip”提供了两种方法解析jsontree得到目录的demo
一种是使用bootstrap插件treeview
另一种是使用jquery插件treeview(这个方法中通过解析json然后拼凑页面的元素的方法,可以应用于不同插件,方便外部开发者参考调用)

获取视频分类Demo.zip

 

签名规则

将请求参数(sign和cataid除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign。

以下是示例过程:

1. 将请求参数按照参数名字典顺序排列为:

ptime="1470969330000";
userid="4802b9bb81";

2. 连接字符串
用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign(本示例的值为fRJiHrsZzw),如下:

ptime=1474882994000&userid=4802b9bb81fRJiHrsZzw

3. 生成签名sign

sign为40位大写SHA1值:

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