批量获取视频信息

通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息,目前共七个版本,最新版本为V7:

a.当地址为https://spark.bokecc.com/api/videos/v7

需要传递以下参数:

参数 说明
userid 用户 id,不可为空
mode 查询方式 0:指定要查询的视频的起始位置;1:指定一批视频进行查询(不传默认值为0)
videoids 要查询的一批视频id,以英文状态下逗号分隔,最大值100,不可为空(mode=1时有效)
videoid_from 起始 videoid,若为空,则从上传的第一个视频开始(mode=0时有效)
videoid_to 终止 videoid,若为空,则到最后一个上传的视频(mode=0时有效)
imagetype 返回封面截图的类型,默认值:0(0:小图;1:大图)
num_per_page 返回信息时,每页包含的视频个数 注:允许范围为 1~100,默认值:100
page 当前页码

返回数据videos包含以下字段:

字段名 说明
total 返回视频数量
video 视频信息

video包含以下字段:

字段名 说明
id 视频ID
title 视频标题
desp 视频描述
tags 视频标签
duration 视频时长,单位秒
category 视频分类ID
image 视频截图地址
imageindex 视频截图序号
image-alternate 视频截图排列信息
definition 视频文件大小信息
totalsize 视频占用总空间,包含原始文件大小
originalsize 原始文件占用空间
uploaduser 上传人(‘主账号’/子账号的邮箱)
uploadtime 上传时间

image-alternate包含以下字段:

字段名 说明
index 视频截图排列序号
url 视频截图地址

definition包含以下字段:

字段名 说明
definitionlevel 视频清晰度值
definitiondesc 视频清晰度描述
terminaltype 终端类型(0:PC端,10:移动端)
filesize 视频文件大小
width 该清晰度的视频的宽度
height 该清晰度的视频的高度

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”
            },
            …
        ]
    }
}

b.当地址为https://spark.bokecc.com/api/videos/v6

需要传递以下参数:

参数 说明
userid 用户 id,不可为空
mode 查询方式 0:指定要查询的视频的起始位置;1:指定一批视频进行查询(不传默认值为0)
videoids 要查询的一批视频id,以英文状态下逗号分隔,最大值100,不可为空(mode=1时有效)
videoid_from 起始 videoid,若为空,则从上传的第一个视频开始(mode=0时有效)
videoid_to 终止 videoid,若为空,则到最后一个上传的视频(mode=0时有效)
num_per_page 返回信息时,每页包含的视频个数 注:允许范围为 1~100,默认值:100
page 当前页码

返回数据videos包含以下字段:

字段名 说明
total 返回视频数量
video 视频信息

video包含以下字段:

字段名 说明
id 视频ID
title 视频标题
desp 视频描述
tags 视频标签
duration 视频时长,单位秒
category 视频分类ID
image 视频截图地址
imageindex 视频截图序号
image-alternate 视频截图排列信息
definition 视频文件大小信息
totalsize 视频占用总空间,包含原始文件大小
originalsize 原始文件占用空间
uploaduser 上传人(‘主账号’/子账号的邮箱)
uploadtime 上传时间

image-alternate包含以下字段:

字段名 说明
index 视频截图排列序号
url 视频截图地址

definition包含以下字段:

字段名 说明
definitionlevel 视频清晰度值
definitiondesc 视频清晰度描述
terminaltype 终端类型(0:PC端,10:移动端)
filesize 视频文件大小
width 该清晰度的视频的宽度
height 该清晰度的视频的高度

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”
            },
            …
        ]
    }
}

c.当地址为https://spark.bokecc.com/api/videos/v5

需要传递以下参数:

参数 说明
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 原始文件占用空间
uploaduser 上传人(‘主账号’/子账号的邮箱)
uploadtime 上传时间

image-alternate包含以下字段:

字段名 说明
index 视频截图排列序号
url 视频截图地址

definition包含以下字段:

字段名 说明
definitionlevel 视频清晰度值
definitiondesc 视频清晰度描述
terminaltype 终端类型(0:PC端,10:移动端)
filesize 视频文件大小
width 该清晰度的视频的宽度
height 该清晰度的视频的高度

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”
            },
            …
        ]
    }
}

d.当地址为https://spark.bokecc.com/api/videos/v4

需要传递以下参数:

参数 说明
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 原始文件占用空间
uploaduser 上传人(‘主账号’/子账号的邮箱)
uploadtime 上传时间

image-alternate包含以下字段:

字段名 说明
index 视频截图排列序号
url 视频截图地址

definition包含以下字段:

字段名 说明
definitionlevel 视频清晰度值
definitiondesc 视频清晰度描述
terminaltype 终端类型(0:PC端,10:移动端)
filesize 视频文件大小

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”
            },
            …
        ]
    }
}

e.当地址为https://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格式的返回信息如下:

<?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
            },
            …
        ]
    }
}

f.当地址为https://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 视频截图排列信息
definition 视频文件大小信息

image-alternate包含以下字段:

字段名 说明
index 视频截图排列序号
url 视频截图地址

definition包含以下字段:

字段名 说明
definitionlevel 视频清晰度值
definitiondesc 视频清晰度描述
terminaltype 终端类型(0:PC端,10:移动端)
filesize 视频文件大小

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
                    },
                    …
                ]
            },
            …
        ]
    }
}

g.当地址为https://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 视频截图排列信息

image-alternate包含以下字段:

字段名 说明
index 视频截图排列序号
url 视频截图地址

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 ""