批量获取视频信息
通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息，目前共三个版本，最新版本为V3:
a.当地址为http://spark.bokecc.com/api/videos/v3
需要传递以下参数：
| 参数 | 说明 |
|---|---|
| userid | 用户 id，不可为空 |
| videoid_from | 起始 videoid，若为空，则从上传的第一个视频开始 |
| videoid_to | 终止 videoid，若为空，则到最后一个上传的视频 |
| 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 | 视频截图排列信息 |
| definition | 视频文件大小信息 |
| totalsize | 视频占用总空间，包含原始文件大小 |
| originalsize | 原始文件占用空间 |
image-alternate包含以下字段：
| 字段名 | 说明 |
|---|---|
| index | 视频截图排列序号 |
| url | 视频截图地址 |
definition包含以下字段：
| 字段名 | 说明 |
|---|---|
| definitionlevel | 视频清晰度值 |
| definitiondesc | 视频清晰度描述 |
| terminaltype | 终端类型（0:PC端，10:移动端） |
| filesize | 视频文件大小 |
XML格式的返回信息如下：
<?xmlversion="1.0"encoding="UTF-8"?>
<videos>
<total>100</total>
<video>
<id>01234567</id>
<title><!\[CDATA\[Video Title\]\]></title>
<desp><!\[CDATA\[Video Description\]\]></desp>
<tags><!\[CDATA\[tag1 tag2 tag3\]\]></tags>
<duration>12345</duration>
<category>12345</category>
<image>http://image.bokecc.com/abc.jpg</image>
<imageindex>1</imageindex>
<image-alternate>
<index>0</index>
<url>http://image.bokecc.com/abc0.jpg</url>
</image-alternate>
<image-alternate>
<index>1</index>
<url>http://image.bokecc.com/abc1.jpg</url>
</image-alternate>
…
<definition>
<definitionlevel>0</definitionlevel>
<definitiondesc>普通</definitiondesc>
<terminaltype>0</terminaltype>
<filesize>2839461</filesize>
</definition>
…
<totalsize>8518383</totalsize>
<originalsize>3275892</originalsize>
</video>
...
</videos>
JSON格式的返回信息如下：
{
"videos":{
"total":100,
"video":\[
{
"id":"01234567",
"title":"Video Title",
"desp":"Video Description",
"tags":"tag1 tag2 tag3",
"duration":12345,
"category":"12345",
"image":"http://image.bokecc.com/abc.jpg",
"imageindex":1,
"image-alternate":\[
{
"index":0,
"url":"http://image.bokecc.com/abc0.jpg"
},
…
\],
"definition":\[
{
"definitionlevel":2,
"definitiondesc":"高清",
"terminaltype": 0,
"filesize": 6587147
},
…
\],
"totalsize":8518383,
"originalsize":3275892
},
…
\]
}
}
b.当地址为http://spark.bokecc.com/api/videos/v2
需要传递以下参数：
| 参数 | 说明 |
|---|---|
| userid | 用户id，不可为空 |
| videoid_from | 起始videoid，若为空，则从上传的第一个视频开始 |
| videoid_to | 终止videoid，若为空，则到最后一个上传的视频 |
| 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 | 视频截图排列信息 |
image-alternate包含以下字段：
| 字段名 | 说明 |
|---|---|
| definitionlevel | 视频清晰度值 |
| definitiondesc | 视频清晰度描述 |
definition包含以下字段：
| 字段名 | 说明 |
|---|---|
| definitionlevel | 视频清晰度值 |
| definitiondesc | 视频清晰度描述 |
| terminaltype | 终端类型（0:PC端，10:移动端） |
| filesize | 视频文件大小 |
XML格式的返回信息如下：
<?xmlversion="1.0"encoding="UTF-8"?>
<videos>
<total>100</total>
<video>
<id>01234567</id>
<title><!\[CDATA\[Video Title\]\]></title>
<desp><!\[CDATA\[Video Description\]\]></desp>
<tags><!\[CDATA\[tag1 tag2 tag3\]\]></tags>
<duration>12345</duration>
<category>12345</category>
<image>http://image.bokecc.com/abc.jpg</image>
<imageindex>1</imageindex>
<image-alternate>
<index>0</index>
<url>http://image.bokecc.com/abc0.jpg</url>
</image-alternate>
<image-alternate>
<index>1</index>
<url>http://image.bokecc.com/abc1.jpg</url>
</image-alternate>
…
<definition>
<definitionlevel>0</definitionlevel>
<definitiondesc>普通</definitiondesc>
<terminaltype>0</terminaltype>
<filesize>2839461</filesize>
</definition>
…
</video>
...
</videos>
JSON格式的返回信息如下：
{
"videos":{
"total":100,
"video":\[
{
"id":"01234567",
"title":"Video Title",
"desp":"Video Description",
"tags":"tag1 tag2 tag3",
"duration":12345,
"category":"12345",
"image":"http://image.bokecc.com/abc.jpg",
"imageindex":1,
"image-alternate":\[
{
"index":0,
"url":"http://image.bokecc.com/abc0.jpg"
},
…
\],
"definition":\[
{
"definitionlevel":2,
"definitiondesc":"高清",
"terminaltype": 0,
"filesize": 6587147
},
…
\]
},
…
\]
}
}
c.当地址为http://spark.bokecc.com/api/videos
需要传递以下参数：
| 参数 | 说明 |
|---|---|
| userid | 用户id，不可为空 |
| videoid_from | 起始videoid，若为空，则从上传的第一个视频开始 |
| videoid_to | 终止videoid，若为空，则到最后一个上传的视频 |
| 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 | 视频截图排列信息 |
| definition | 视频文件大小信息 |
image-alternate包含以下字段：
| 字段名 | 说明 |
|---|---|
| index | 视频截图排列序号 |
| url | 视频截图地址 |
definition包含以下字段：
| 字段名 | 说明 |
|---|---|
| definitionlevel | 视频清晰度值 |
| definitiondesc | 视频清晰度描述 |
| terminaltype | 终端类型（0:PC端，10:移动端） |
| filesize | 视频文件大小 |
XML格式的返回信息如下：
<?xmlversion="1.0"encoding="UTF-8"?>
<videos>
<total>100</total>
<video>
<id>01234567</id>
<title><!\[CDATA\[Video Title\]\]></title>
<desp><!\[CDATA\[Video Description\]\]></desp>
<tags><!\[CDATA\[tag1 tag2 tag3\]\]></tags>
<duration>12345</duration>
<category>12345</category>
<image>http://image.bokecc.com/abc.jpg</image>
<imageindex>1</imageindex>
<image-alternate>
<index>0</index>
<url>http://image.bokecc.com/abc0.jpg</url>
</image-alternate>
<image-alternate>
<index>1</index>
<url>http://image.bokecc.com/abc1.jpg</url>
</image-alternate>
...
</video>
...
</videos>
JSON格式的返回信息如下：
{
"videos":{
"total":100,
"video":\[
{
"id":"01234567",
"title":"Video Title",
"desp":"Video Description",
"tags":"tag1 tag2 tag3",
"duration":12345,
"category":"12345",
"image":"http://image.bokecc.com/abc.jpg",
"imageindex":1,
"image-alternate":\[
{
"index":0,
"url":"http://image.bokecc.com/abc0.jpg"
},
…
\]
},
…
\]
}
}
