获取视频信息
注:通过该接口可以获取指定用户的有效视频的信息,目前共六个版本,最新版本为V6:
1. v6版本
请求地址
https://spark.bokecc.com/api/video/v6
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id,不可为空 |
num_per_page | Integer | 否 | 返回信息时,每页包含的视频个数 注:允许范围为 1~100,默认值:100 |
page | Integer | 否 | 当前页码,默认1 |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
video | Object | 视频信息 |
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 | 原始文件占用空间 |
updateuser | String | 上传人 (‘主账号’/子账号的邮箱) |
updatetime | 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"?>
<video>
<id>01234567</id>
<title><![CDATA[视频标题]]></title>
<desp><![CDATA[视频描述]]></desp>
<tags><![CDATA[标签1 标签2 标签3]]></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>480</width>
<height>960</height>
</definition>
…
<totalsize>8518383</totalsize>
<originalsize>3275892</originalsize>
<updateuser>7@cc.com.cn</updateuser>
<updatetime>2018-03-01 13:00:00</updatetime>
</video>
JSON示例
{
"video": {
"id": "01234567",
"title": "视频标题",
"desp": "视频描述",
"tags": "标签1 标签2 标签3",
"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. v5版本
请求地址
https://spark.bokecc.com/api/video/v5
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid | String | 是 | 视频 id |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
video | Object | 视频信息 |
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 | 原始文件占用空间 |
updateuser | String | 上传人 (‘主账号’/子账号的邮箱) |
updatetime | 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"?>
<video>
<id>01234567</id>
<title>
<![CDATA[视频标题]]>
</title>
<desp>
<![CDATA[视频描述]]>
</desp>
<tags>
<![CDATA[标签1 标签2 标签3]]>
</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>480</width>
<height>960</height>
</definition>
<totalsize>8518383</totalsize>
<originalsize>3275892</originalsize>
<updateuser>7@cc.com.cn</updateuser>
<updatetime>2018-03-01 13:00:00</updatetime>
</video>
JSON示例
{
"video": {
"id": "01234567",
"title": "视频标题",
"desp": "视频描述",
"tags": "标签1 标签2 标签3",
"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. v4版本
请求地址
https://spark.bokecc.com/api/video/v4
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid | String | 是 | 视频 id |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
video | Object | 视频信息 |
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 | 原始文件占用空间 |
updateuser | String | 上传人 (‘主账号’/子账号的邮箱) |
updatetime | 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"?>
<video>
<id>01234567</id>
<title>
<![CDATA[视频标题]]>
</title>
<desp>
<![CDATA[视频描述]]>
</desp>
<tags>
<![CDATA[标签1 标签2 标签3]]>
</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>
JSON示例
{
"video": {
"id": "01234567",
"title": "视频标题",
"desp": "视频描述",
"tags": "标签1 标签2 标签3",
"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"
}
}
4. v3版本
请求地址
https://spark.bokecc.com/api/video/v3
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid | String | 是 | 视频 id |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
video | Object | 视频信息 |
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"?>
<video>
<id>01234567</id>
<title>
<![CDATA[视频标题]]>
</title>
<desp>
<![CDATA[视频描述]]>
</desp>
<tags>
<![CDATA[标签1 标签2 标签3]]>
</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>
JSON示例
{
"video": {
"id": "01234567",
"title": "视频标题",
"desp": "视频描述",
"tags": "标签1 标签2 标签3",
"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
}
}
5. v2版本
请求地址
https://spark.bokecc.com/api/video/v2
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid | String | 是 | 视频 id |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
video | Object | 视频信息 |
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"?>
<video>
<id>01234567</id>
<title><![CDATA[视频标题]]></title>
<desp><![CDATA[视频描述]]></desp>
<tags><![CDATA[标签1 标签2 标签3]]></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>
JSON示例
{
"video": {
"id": "01234567",
"title": "视频标题",
"desp": "视频描述",
"tags": "标签1 标签2 标签3",
"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
},
......
]
}
}
6. v1版本
请求地址
https://spark.bokecc.com/api/video
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户 id |
videoid | String | 是 | 视频 id |
format | String | 否 | 返回格式,xml或json,默认xml |
返回数据
名称 | 类型 | 说明 |
---|---|---|
video | Object | 视频信息 |
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"?>
<video>
<id>01234567</id>
<title><![CDATA[视频标题]]></title>
<desp><![CDATA[视频描述]]></desp>
<tags><![CDATA[标签1 标签2 标签3]]></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>
JSON示例
{
"video": {
"id": "01234567",
"title": "视频标题",
"desp": "视频描述",
"tags": "标签1 标签2 标签3",
"duration": 12345,
"category": "12345",
"image": "http://image.bokecc.com/abc.jpg",
"imageindex": 1,
"image- alternate": [
{
"index": 0,
"url": "http://image.bokecc.com/abc0.jpg"
},
......
]
}
}