批量获取视频信息

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

results matching ""

    No results matching ""