批量获取视频信息

更新时间：2022-1-9

1. v8版本

接口描述
通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息，在v7基础上请求参数新增排序字段。
请求地址
https://spark.bokecc.com/api/videos/v8
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
sort String 否 查询结果排序，默认为创建时间正序排序
格式：排序字段:排序方式
排序字段：CREATION_DATE或FILE_SIZE
排序方式：ASC或DESC
注：格式中的“:”为英文半角
Example：sort=CREATION_DATE:DESC。
mode Integer 否 查询方式，默认值为0。 取值说明：0 指定要查询的视频的起始位置，1 指定一批视频进行查询。
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 否 分页参数，每页显示数量，默认为100。取值范围：1~100之间的任意整数。
page Integer 否 分页参数，页码，默认为1。取值范围：大于0的整数。
请求示例
https://spark.bokecc.com/api/video/v8?page=1&sort=CREATION_DATE%3ADESC&time=1672743324846&userid=xxxxxx&hash=AF598E9881D56129DFB7C1FC9118CCB2&num_per_page=10
返回数据
名称 类型 说明
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. v7版本

接口描述
通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息，在v6基础上请求参数新增封面截图的类型。
请求地址
https://spark.bokecc.com/api/videos/v7
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
mode Integer 否 查询方式，默认值为0。 取值说明：0 指定要查询的视频的起始位置，1 指定一批视频进行查询。
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 否 分页参数，每页显示数量，默认为100。取值范围：1~100之间的任意整数。
page Integer 否 分页参数，页码，默认为1。取值范围：大于0的整数。
请求示例
https://spark.bokecc.com/api/video/v7?format=json&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1670922659110&userid=xxxxxx&hash=A1491625A69AA047C0933C38110AFD8F
返回数据
名称 类型 说明
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"
            },
            ......
        ]
    }
}

3. v6版本

接口描述
通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息，在v5基础上可以指定一批videoid查询。
请求地址
https://spark.bokecc.com/api/videos/v6
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
mode Integer 否 查询方式，默认值为0。 取值说明：0 指定要查询的视频的起始位置，1 指定一批视频进行查询。
videoids String 否 要查询的一批视频ID，以英文状态下逗号分隔，最大值100。该参数在mode=1时有效，并且mode=1时不可为空。
videoid_from String 否 起始 videoid。若为空，则从上传的第一个视频开始。该参数在mode=0时有效。
videoid_to String 否 终止 videoid。若为空，则到最后一个上传的视频。该参数在mode=0时有效。
num_per_page Integer 否 分页参数，每页显示数量，默认为100。取值范围：1~100之间的任意整数。
page Integer 否 分页参数，页码，默认为1。取值范围：大于0的整数。
请求示例
https://spark.bokecc.com/api/video/v6?format=json&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1670922659110&userid=xxxxxx&hash=A1491625A69AA047C0933C38110AFD8F
返回数据
名称 类型 说明
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"
            },
            ......
        ]
    }
}

4. v5版本

接口描述
通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息，在v4基础上返回数据新增视频的宽和高。
请求地址
https://spark.bokecc.com/api/videos/v5
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
videoid_from String 否 起始 videoid，若为空，则从上传的第一个视频开始。
videoid_to String 否 终止 videoid，若为空，则到最后一个上传的视频。
num_per_page Integer 否 分页参数，每页显示数量，默认为100。取值范围：1~100之间的任意整数。
page Integer 否 分页参数，页码，默认为1。取值范围：大于0的整数。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/video/v6?format=json&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1670922659110&userid=xxxxxx&hash=A1491625A69AA047C0933C38110AFD8F
返回数据
名称 类型 说明
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"
            },
            ......
        ]
    }
}

5. v4版本

接口描述
通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息，在v3基础上返回数据新增上传者和上传时间
请求地址
https://spark.bokecc.com/api/videos/v4
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
videoid_from Integer 否 起始 videoid，若为空，则从上传的第一个视频开始。
videoid_to Integer 否 终止 videoid，若为空，则到最后一个上传的视频。
num_per_page Integer 否 分页参数，每页显示数量，默认为100。取值范围：1~100之间的任意整数。
page Integer 否 分页参数，页码，默认为1。取值范围：大于0的整数。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/videos/v4?time=1670926367671&userid=xxxxxx&hash=AF86EFBE4C641F604AA749E76081D747
返回数据
名称 类型 说明
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"
            },
            ......
        ]
    }
}

6. v3版本

接口描述
通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息，在v2基础上返回数据新增视频文件总大小和原始文件大小。
请求地址
https://spark.bokecc.com/api/videos/v3
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
videoid_from String 否 起始 videoid，若为空，则从上传的第一个视频开始。
videoid_to String 否 终止 videoid，若为空，则到最后一个上传的视频。
num_per_page Integer 否 分页参数，每页显示数量，默认为100。取值范围：1~100之间的任意整数。
page Integer 否 分页参数，页码，默认为1。取值范围：大于0的整数。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/videos/v3?time=1670926367671&userid=xxxxxx&hash=AF86EFBE4C641F604AA749E76081D747
返回数据
名称 类型 说明
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
            },
            …
        ]
    }
}

7. v2版本

接口描述
通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息，在v1版本基础上返回数据新增转码后视频大小。
请求地址
https://spark.bokecc.com/api/videos/v2
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
videoid_from String 否 起始 videoid，若为空，则从上传的第一个视频开始。
videoid_to String 否 终止 videoid，若为空，则到最后一个上传的视频。
num_per_page Integer 否 分页参数，每页显示数量，默认为100。取值范围：1~100之间的任意整数。
page Integer 否 分页参数，页码，默认为1。取值范围：大于0的整数。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/videos/v2?time=1670926367671&userid=xxxxxx&hash=AF86EFBE4C641F604AA749E76081D747
返回数据
名称 类型 说明
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
                    },
                    …
                ]
            },
            …
        ]
    }
}

8. v1版本

接口描述
通过该接口可以获取指定用户的一批有效视频(不包括删除、正在处理的视频)的信息。
请求地址
https://spark.bokecc.com/api/videos
请求方式
GET
请求参数

以下请求参数需要进行THQS权限认证， 权限认证方式请参考THQS认证方式。

名称 类型 必填 描述
userid String 是 用户ID。
videoid_from String 否 起始 videoid，若为空，则从上传的第一个视频开始。
videoid_to String 否 终止 videoid，若为空，则到最后一个上传的视频。
num_per_page Integer 否 分页参数，每页显示数量，默认为100。取值范围：1~100之间的任意整数。
page Integer 否 分页参数，页码，默认为1。取值范围：大于0的整数。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/videos?time=1670926367671&userid=xxxxxx&hash=AF86EFBE4C641F604AA749E76081D747
返回数据
名称 类型 说明
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 ""