批量获取视频信息
注:通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息,目前共七个版本,最新版本为V7:
1. v7版本
请求地址
https://spark.bokecc.com/api/videos/v7
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
mode | Integer | 否 | 查询方式 0:指定要查询的视频的起始位置 1:指定一批视频进行查询(不传默认值为0) |
videoids | String | 否 | 要查询的一批视频id,以英文状态下逗号分隔,最大值100(mode=1时有效),mode=1时不可为空 |
videoid_from | String | 否 | 起始 videoid,若为空,则从上传的第一个视频开始(mode=0时有效) |
videoid_to | String | 否 | 终止 videoid,若为空,则到最后一个上传的视频(mode=0时有效) |
imagetype | Integer | 否 | 返回封面截图的类型,默认值:0(0:小图;1:大图) |
num_per_page | Integer | 否 | 返回信息时,每页包含的视频个数 注:允许范围为 1~100,默认值:100 |
page | Integer | 否 | 当前页码,默认1 |
返回数据
名称 | 类型 | 说明 |
---|---|---|
videos | Object | 视频信息 |
videos说明
名称 | 类型 | 说明 |
---|---|---|
total | Integer | 返回视频数量 |
video | Array | 视频信息 |
video说明
名称 | 类型 | 说明 |
---|---|---|
id | String | 视频ID |
title | String | 视频标题 |
desp | String | 视频描述 |
tags | String | 视频标签 |
duration | Integer | 视频时长,单位秒 |
category | String | 视频分类ID |
image | String | 视频截图地址 |
imageindex | Integer | 视频截图序号 |
image-alternate | Array | 视频截图排列信息 |
definition | Array | 视频文件大小信息 |
totalsize | Long | 视频占用总空间,包含原始文件大小 |
originalsize | Long | 原始文件占用空间 |
uploaduser | String | 上传人(‘主账号’/子账号的邮箱) |
uploadtime | String | 上传时间 |
image-alternate说明
名称 | 类型 | 说明 |
---|---|---|
index | Integer | 视频截图排列序号 |
url | String | 视频截图地址 |
definition说明
名称 | 类型 | 说明 |
---|---|---|
definitionlevel | Integer | 视频清晰度值 |
definitiondesc | String | 视频清晰度描述 |
terminaltype | Integer | 终端类型(0:PC端,10:移动端) |
filesize | Long | 视频文件大小 |
width | Integer | 该清晰度视频的宽 |
height | Integer | 该清晰度视频的高 |
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,
"width": 480,
"height": 960
},
......
],
"totalsize": 8518383,
"originalsize": 3275892,
"updateuser": "主账号",
"updatetime": "2018-03-01 13:00:00"
},
......
]
}
}
2. v6版本
请求地址
https://spark.bokecc.com/api/videos/v6
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
mode | Integer | 否 | 查询方式 0:指定要查询的视频的起始位置;1:指定一批视频进行查询(不传默认值为0) |
videoids | String | 否 | 要查询的一批视频id,以英文状态下逗号分隔,最大值100(mode=1时有效),mode=1时不可为空 |
videoid_from | String | 否 | 起始 videoid,若为空,则从上传的第一个视频开始(mode=0时有效) |
videoid_to | String | 否 | 终止 videoid,若为空,则到最后一个上传的视频(mode=0时有效) |
num_per_page | Integer | 否 | 返回信息时,每页包含的视频个数 注:允许范围为 1~100,默认值:100 |
page | Integer | 否 | 当前页码,默认1 |
返回数据
名称 | 类型 | 说明 |
---|---|---|
videos | Object | 视频信息 |
videos说明
名称 | 类型 | 说明 |
---|---|---|
total | Integer | 返回视频数量 |
video | Array | 视频信息 |
video说明
名称 | 类型 | 说明 |
---|---|---|
id | String | 视频ID |
title | String | 视频标题 |
desp | String | 视频描述 |
tags | String | 视频标签 |
duration | String | 视频时长,单位秒 |
category | String | 视频分类ID |
image | String | 视频截图地址 |
imageindex | Integer | 视频截图序号 |
image-alternate | Array | 视频截图排列信息 |
definition | Array | 视频文件大小信息 |
totalsize | Long | 视频占用总空间,包含原始文件大小 |
originalsize | Long | 原始文件占用空间 |
uploaduser | String | 上传人(‘主账号’/子账号的邮箱) |
uploadtime | String | 上传时间 |
image-alternate说明
名称 | 类型 | 说明 |
---|---|---|
index | Integer | 视频截图排列序号 |
url | String | 视频截图地址 |
definition说明
名称 | 类型 | 说明 |
---|---|---|
definitionlevel | Integer | 视频清晰度值 |
definitiondesc | String | 视频清晰度描述 |
terminaltype | Integer | 终端类型(0:PC端,10:移动端) |
filesize | Long | 视频文件大小 |
width | Integer | 该清晰度视频的宽 |
height | Integer | 该清晰度视频的高 |
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,
"width": 480,
"height": 960
},
......
],
"totalsize": 8518383,
"originalsize": 3275892,
"updateuser": "主账号",
"updatetime": "2018-03-01 13:00:00"
},
......
]
}
}
3. v5版本
请求地址
https://spark.bokecc.com/api/videos/v5
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid_from | String | 否 | 起始 videoid,若为空,则从上传的第一个视频开始 |
videoid_to | String | 否 | 终止 videoid,若为空,则到最后一个上传的视频 |
num_per_page | Integer | 否 | 返回信息时,每页包含的视频个数 注:允许范围为 1~100,默认值:100 |
page | Integer | 否 | 当前页码,默认1 |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
videos | Object | 视频信息 |
videos说明
名称 | 类型 | 说明 |
---|---|---|
total | Integer | 返回视频数量 |
video | Array | 视频信息 |
video说明
名称 | 类型 | 说明 |
---|---|---|
id | String | 视频ID |
title | String | 视频标题 |
desp | String | 视频描述 |
tags | String | 视频标签 |
duration | Integer | 视频时长,单位秒 |
category | String | 视频分类ID |
image | String | 视频截图地址 |
imageindex | Integer | 视频截图序号 |
image-alternate | Array | 视频截图排列信息 |
definition | Array | 视频文件大小信息 |
totalsize | Long | 视频占用总空间,包含原始文件大小 |
originalsize | Long | 原始文件占用空间 |
uploaduser | String | 上传人(‘主账号’/子账号的邮箱) |
uploadtime | String | 上传时间 |
image-alternate说明
名称 | 类型 | 说明 |
---|---|---|
index | Integer | 视频截图排列序号 |
url | String | 视频截图地址 |
definition说明
名称 | 类型 | 说明 |
---|---|---|
definitionlevel | Integer | 视频清晰度值 |
definitiondesc | String | 视频清晰度描述 |
terminaltype | Integer | 终端类型(0:PC端,10:移动端) |
filesize | Long | 视频文件大小 |
width | Integer | 该清晰度视频的宽 |
height | Integer | 该清晰度视频的高 |
XML示例
<?xml version="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>
<width>2839461</width>
<height>2839461</height>
</definition>
…
<totalsize>8518383</totalsize>
<originalsize>3275892</originalsize>
<updateuser>7@cc.com.cn</updateuser>
<updatetime>2018-03-01 13:00:00</updatetime>
</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,
"width": 480,
"height": 960
},
......
],
"totalsize": 8518383,
"originalsize": 3275892,
"updateuser": "主账号",
"updatetime": "2018-03-01 13:00:00"
},
......
]
}
}
4. v4版本
请求地址
https://spark.bokecc.com/api/videos/v4
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid_from | Integer | 否 | 起始 videoid,若为空,则从上传的第一个视频开始 |
videoid_to | Integer | 否 | 终止 videoid,若为空,则到最后一个上传的视频 |
num_per_page | Integer | 否 | 返回信息时,每页包含的视频个数 注:允许范围为 1~100,默认值:100 |
page | Integer | 否 | 当前页码,默认1 |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
videos | Object | 视频信息 |
videos说明
名称 | 类型 | 说明 |
---|---|---|
total | Integer | 返回视频数量 |
video | Array | 视频信息 |
video说明
名称 | 类型 | 说明 |
---|---|---|
id | String | 视频ID |
title | String | 视频标题 |
desp | String | 视频描述 |
tags | String | 视频标签 |
duration | Integer | 视频时长,单位秒 |
category | String | 视频分类ID |
image | String | 视频截图地址 |
imageindex | Integer | 视频截图序号 |
image-alternate | Array | 视频截图排列信息 |
definition | Array | 视频文件大小信息 |
totalsize | Long | 视频占用总空间,包含原始文件大小 |
originalsize | Long | 原始文件占用空间 |
uploaduser | String | 上传人(‘主账号’/子账号的邮箱) |
uploadtime | String | 上传时间 |
image-alternate说明
名称 | 类型 | 说明 |
---|---|---|
index | Integer | 视频截图排列序号 |
url | String | 视频截图地址 |
definition说明
名称 | 类型 | 说明 |
---|---|---|
definitionlevel | Integer | 视频清晰度值 |
definitiondesc | String | 视频清晰度描述 |
terminaltype | Integer | 终端类型(0:PC端,10:移动端) |
filesize | Long | 视频文件大小 |
XML示例
<?xml version="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>
<updateuser>7@cc.com.cn</updateuser>
<updatetime>2018-03-01 13:00:00</updatetime>
</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,
"updateuser": "主账号",
"updatetime": "2018-03-01 13:00:00"
},
......
]
}
}
5. v3版本
请求地址
https://spark.bokecc.com/api/videos/v3
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid_from | String | 否 | 起始 videoid,若为空,则从上传的第一个视频开始 |
videoid_to | String | 否 | 终止 videoid,若为空,则到最后一个上传的视频 |
num_per_page | Integer | 否 | 返回信息时,每页包含的视频个数 注:允许范围为 1~100,默认值:100 |
page | Integer | 否 | 当前页码,默认1 |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
videos | Object | 视频信息 |
videos说明
名称 | 类型 | 说明 |
---|---|---|
total | Integer | 返回视频数量 |
video | Array | 视频信息 |
video说明
名称 | 类型 | 说明 |
---|---|---|
id | String | 视频ID |
title | String | 视频标题 |
desp | String | 视频描述 |
tags | String | 视频标签 |
duration | Integer | 视频时长,单位秒 |
category | String | 视频分类ID |
image | String | 视频截图地址 |
imageindex | Integer | 视频截图序号 |
image-alternate | Array | 视频截图排列信息 |
definition | Array | 视频文件大小信息 |
totalsize | Long | 视频占用总空间,包含原始文件大小 |
originalsize | Long | 原始文件占用空间 |
image-alternate说明
名称 | 类型 | 说明 |
---|---|---|
index | Integer | 视频截图排列序号 |
url | String | 视频截图地址 |
definition说明
名称 | 类型 | 说明 |
---|---|---|
definitionlevel | Integer | 视频清晰度值 |
definitiondesc | String | 视频清晰度描述 |
terminaltype | Integer | 终端类型(0:PC端,10:移动端) |
filesize | Long | 视频文件大小 |
XML示例
<?xml version="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
},
…
]
}
}
6. v2版本
请求地址
https://spark.bokecc.com/api/videos/v2
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid_from | String | 否 | 起始 videoid,若为空,则从上传的第一个视频开始 |
videoid_to | String | 否 | 终止 videoid,若为空,则到最后一个上传的视频 |
num_per_page | Integer | 否 | 返回信息时,每页包含的视频个数 注:允许范围为 1~100,默认值:100 |
page | Integer | 否 | 当前页码,默认1 |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
videos | Object | 视频信息 |
videos说明
名称 | 类型 | 说明 |
---|---|---|
total | Integer | 返回视频数量 |
video | Array | 视频信息 |
video说明
名称 | 类型 | 说明 |
---|---|---|
id | String | 视频ID |
title | String | 视频标题 |
desp | String | 视频描述 |
tags | String | 视频标签 |
duration | Integer | 视频时长,单位秒 |
category | String | 视频分类ID |
image | String | 视频截图地址 |
imageindex | Integer | 视频截图序号 |
image-alternate | Array | 视频截图排列信息 |
definition | Array | 视频文件大小信息 |
image-alternate说明
名称 | 类型 | 说明 |
---|---|---|
index | Integer | 视频截图排列序号 |
url | String | 视频截图地址 |
definition说明
名称 | 类型 | 说明 |
---|---|---|
definitionlevel | Integer | 视频清晰度值 |
definitiondesc | String | 视频清晰度描述 |
terminaltype | Integer | 终端类型(0:PC端,10:移动端) |
filesize | Long | 视频文件大小 |
XML示例
<?xml version="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
},
…
]
},
…
]
}
}
7. v1版本
请求地址
https://spark.bokecc.com/api/videos
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid_from | String | 否 | 起始 videoid,若为空,则从上传的第一个视频开始 |
videoid_to | String | 否 | 终止 videoid,若为空,则到最后一个上传的视频 |
num_per_page | Integer | 否 | 返回信息时,每页包含的视频个数 注:允许范围为 1~100,默认值:100 |
page | Integer | 否 | 当前页码,默认1 |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
videos | Object | 视频信息 |
videos说明
名称 | 类型 | 说明 |
---|---|---|
total | Integer | 返回视频数量 |
video | Array | 视频信息 |
video说明
名称 | 类型 | 说明 |
---|---|---|
id | String | 视频ID |
title | String | 视频标题 |
desp | String | 视频描述 |
tags | String | 视频标签 |
duration | Integer | 视频时长,单位秒 |
category | String | 视频分类ID |
image | String | 视频截图地址 |
imageindex | Integer | 视频截图序号 |
image-alternate | Array | 视频截图排列信息 |
image-alternate说明
名称 | 类型 | 说明 |
---|---|---|
index | Integer | 视频截图排列序号 |
url | String | 视频截图地址 |
XML示例
<?xml version="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"
},
…
]
},
…
]
}
}