批量获取视频信息

注：通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息，目前共七个版本，最新版本为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"
                    },
                    …
                ]
            },
            …
        ]
    }
}

批量获取视频信息