按分类获取视频信息
优质
小牛编辑
127浏览
2023-12-01
通过该接口可以获取指定分类下的视频信息，目前共两个版本,最新版为v2版,
当地址为:
https://spark.bokecc.com/api/videos/category/v2
需要传递以下参数：
| 参数 | 说明 |
|---|---|
| categoryid | 视频分类的id，不可为空 |
| userid | 用户id，不可为空 |
| num_per_page | 返回信息时,每页包含的视频个数 注:阈值为 1~100 |
| page | 当前页码 |
返回数据videos包含以下字段：
| 字段名 | 说明 |
|---|---|
| total | 返回视频总数 |
| video | 视频信息 |
| 字段名 | 说明 |
| id | 视频ID |
| title | 视频标题 |
| desp | 视频描述 |
| tags | 视频标签 |
| duration | 视频时长 |
| category | 视频分类ID |
| image | 视频截图地址 |
| imageindex | 视频截图序号 |
| image-alternate | 视频截图排列信息 |
| definition | 视频文件大小信息 |
| totalsize | 视频占用总空间，包含原始文件大小(单位:B) |
| originalsize | 原始文件占用空间(单位:B) |
| updateuser | 上传人(‘主账号’/子账号的邮箱) |
| updatetime | 上传时间 |
video包含以下字段：
image－alternate包含以下字段
| 字段名 | 说明 |
|---|---|
| index | 视频截图序列号 |
| url | 视频截图地址 |
definition包含以下字段：
| 字段名 | 说明 |
|---|---|
| definitionlevel | 视频清晰度值 |
| definitiondesc | 视频清晰度描述 |
| terminaltype | 终端类型（0:PC端，10:移动端） |
| filesize | 视频文件大小 |
| width | 该清晰度的视频的宽度 |
| height | 该清晰度的视频的高度 |
JSON格式的返回信息如下：
{
"videos":{
”total":"7",
"video":[{
"id":"01234567",
"title":" 视频标题",
"desp":"视频描述",
"tags":" 标签1 标签2”,
"duration":264,
"category":"12345",
"image": "http:// xxx-0.jpg",
"imageindex":0,
"image-alternate":[{
"index":"0",
"url":"http:// xxx-0/0.jpg"
},
...
],
"definition":[
{
"definitionlevel": 2,
"definitiondesc": "高清",
"terminaltype": 0,
"filesize": 6587147
},
…
],
"totalsize":8518383,
“originalsize”:3275892,
“updateuser”:”主账号”,
“updatetime”:”2018-03-01 13:00:00”
}
...
]
}
}
当地址为
http://spark.bokecc.com/api/videos/category
需要传递以下参数：
| 参数 | 说明 |
|---|---|
| categoryid | 视频分类的id，不可为空 |
| userid | 用户id，不可为空 |
| num_per_page | 返回信息时,每页包含的视频个数注:阈值为1~100 |
| page | 当前页码 |
| format | 返回格式，包括xml和json |
返回数据videos包含以下字段：
| 字段名 | 说明 |
|---|---|
| total | 返回视频总数 |
| video | 视频信息 |
video包含以下字段:
| 字段名 | 说明 |
|---|---|
| id | 视频ID |
| title | 视频标题 |
| desp | 视频描述 |
| tags | 视频标签 |
| duration | 视频时长 |
| category | 视频分类ID |
| image | 视频截图地址 |
| imageindex | 视频截图序号 |
| image-alternate | 视频截图排列信息 |
video包含以下字段：
image－alternate包含以下字段
| 字段名 | 说明 |
|---|---|
| index | 视频截图序列号 |
| url | 视频截图地址 |
XML格式的返回信息如下：
<? xmlversion="1.0"encoding="UTF-8"?>
<videos>
<total>7</total>
<video>
<id>01234567</id>
<title>视频标题</title>
<desp>视频描述</desp>
<tags>标签1 标签2</tags>
<duration>264</duration>
<category>12345</category>
<image>http:// xxx.jpg</image>
<imageindex>0</imageindex>
<image-alternate>
<index>0</index>
<url>http:// xxx-0/0.jpg</url>
</image-alternate>
…
</video>
…
</videos>
JSON格式的返回信息如下：
{
"videos":{
"total":"7",
"video":\[{
"id":"01234567",
"title":" 视频标题",
"desp":"视频描述",
"tags":" 标签1标签2",
"duration":264,
"category":"12345",
"image": "http:// xxx-0.jpg",
"imageindex":0,
"image-alternate":\[{
"index":"0",
"url":"http:// xxx-0/0.jpg"
},
...
\]
}
...
\]
}
}