批量获取视频信息

优质

小牛编辑

131浏览

2023-12-01

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