获取视频分类
更新时间：2017-08-21
1. v2版本
接口描述
该接口用于获取全部视频分类。
请求地址
https://spark.bokecc.com/api/video/category/v2
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。
| 名称 |
类型 |
必填 |
描述 |
| userid |
String |
是 |
用户ID。 |
| format |
String |
否 |
返回格式，xml或json，默认xml。 |
请求示例
https://spark.bokecc.com/api/video/category/v2?format=json&time=1671170956799&userid=CC443A6686737xxx&hash=7AC61288FB8424A46F0D20B2EA99EA03
返回数据
| 名称 |
类型 |
说明 |
| video |
Object |
信息。 |
video说明
| 名称 |
类型 |
说明 |
| category |
Array |
视频分类信息。 |
category说明
| 名称 |
类型 |
说明 |
| id |
String |
分类ID。 |
| name |
String |
分类名称。 |
| sub-category |
Array |
子分类信息。 |
sub-category说明
| 名称 |
类型 |
说明 |
| id |
String |
分类ID。 |
| name |
String |
分类名称。 |
| sub-category |
Array |
子分类信息。 |
XML返回示例
<?xmlversion="1.0"encoding="UTF-8"?>
<video>
<category>
<id>DC7D95457F098473</id>
<name>一级分类1</name>
<sub-category>
<category>
<id>456</id>
<name>视频类型1</name>
<sub-category>
<category>
<id>00A4EF671F1898AC</id>
<name>电影</name>
<sub-category>
<category>
<id>63DC8D0B86596D80</id>
<name>言情</name>
<sub-category>…</sub-category>
</category>
…
</sub-category>
</category>
…
<sub-category>
</category>
…
<sub-category>
</category>
…
</video>
JSON返回示例
{
"video": {
"category": [
{
"id": "DC7D95457F098473",
"name": "一级分类1",
"sub-category": [
{
"id": "9C81F086E324AE74",
"name": "视频类型",
"sub-category": [
{
"id": "00A4EF671F1898AC",
"name": "电影",
"sub-category": [
{
"id": "CEB3395BEA6F9931",
"name": "搞笑",
"sub-category": []
},
{
"id": "63DC8D0B86596D80",
"name": "言情",
"sub-category": []
},
......
]
},
......
]
}
]
},
......
]
}
}
2. v1版本
接口描述
该接口用于获取视频分类。
请求地址
https://spark.bokecc.com/api/video/category
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。
| 名称 |
类型 |
必填 |
描述 |
| userid |
String |
是 |
用户ID。 |
| format |
String |
否 |
返回格式，xml或json，默认xml。 |
请求示例
https://spark.bokecc.com/api/video/category?format=json&time=1671171313869&userid=CC443A6686737xxx&hash=E5957A7FEEA20BFFD6B95534FBA6A265
返回数据
注：返回结果中的level 包括BASIC 和 PREMIUM，BASIC 中只包含一个默认父分类，无法创建自定义父分类， PREMIUM 版本中包含用户创建的父分类。
| 名称 |
类型 |
说明 |
| video |
Object |
信息。 |
video说明
| 名称 |
类型 |
说明 |
| category |
Array |
视频分类信息。 |
| level |
String |
视频分类等级。 |
category说明
| 名称 |
类型 |
说明 |
| id |
String |
分类ID。 |
| name |
String |
分类名称。 |
| sub-category |
Array |
子分类信息。 |
sub-category说明
| 名称 |
类型 |
说明 |
| id |
String |
子分类ID。 |
| name |
String |
子分类名称。 |
XML返回示例
<?xmlversion="1.0"encoding="UTF-8"?>
<video>
<level>BASIC</level>
<category>
<id>123</id>
<name>category1</name>
<sub-category>
<id>456</id>
<name>sub category1</name>
<sub-category></sub-category>
</sub-category>
......
</category>
......
</video>
JSON返回示例
{
"video": {
"level": "PREMIUM",
"category": [
{
"id": 123,
"name": "category1",
"sub-category": [
{
"id": 456,
"name": "sub category1"
},
......
]
},
......
]
}
}
