获取视频信息

注：通过该接口可以获取指定用户的有效视频的信息，目前共六个版本，最新版本为V6：

1. v6版本

请求地址

https://spark.bokecc.com/api/video/v6

请求参数

名称 类型 必填 描述
userid String 是 用户 id，不可为空
num_per_page Integer 否 返回信息时，每页包含的视频个数 注:允许范围为 1~100，默认值:100
page Integer 否 当前页码，默认1
format String 否 返回格式，xml或json，默认xml

返回数据

名称 类型 说明
video Object 视频信息

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 原始文件占用空间
updateuser String 上传人 (‘主账号’/子账号的邮箱)
updatetime 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"?>
<video>
    <id>01234567</id>
    <title><![CDATA[视频标题]]></title>
    <desp><![CDATA[视频描述]]></desp>
    <tags><![CDATA[标签1 标签2 标签3]]></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>480</width>
       <height>960</height>
     </definition>
    …
    <totalsize>8518383</totalsize>
    <originalsize>3275892</originalsize>
    <updateuser>7@cc.com.cn</updateuser>
    <updatetime>2018-03-01 13:00:00</updatetime>
</video>

JSON示例

{
    "video": {
        "id": "01234567",
        "title": "视频标题",
        "desp": "视频描述",
        "tags": "标签1 标签2 标签3",
        "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. v5版本

请求地址

https://spark.bokecc.com/api/video/v5

请求参数

名称 类型 必填 描述
userid String 是 用户 id
videoid String 是 视频 id
format String 否 返回格式，xml或json，默认xml

返回数据

名称 类型 说明
video Object 视频信息

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 原始文件占用空间
updateuser String 上传人 (‘主账号’/子账号的邮箱)
updatetime 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"?>
<video>
    <id>01234567</id>
    <title>
        <![CDATA[视频标题]]>
    </title>
    <desp>
        <![CDATA[视频描述]]>
    </desp>
    <tags>
        <![CDATA[标签1 标签2 标签3]]>
    </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>480</width>
        <height>960</height>
    </definition>
    <totalsize>8518383</totalsize>
    <originalsize>3275892</originalsize>
    <updateuser>7@cc.com.cn</updateuser>
    <updatetime>2018-03-01 13:00:00</updatetime>
</video>

JSON示例

{
    "video": {
        "id": "01234567",
        "title": "视频标题",
        "desp": "视频描述",
        "tags": "标签1 标签2 标签3",
        "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. v4版本

请求地址

https://spark.bokecc.com/api/video/v4

请求参数

名称 类型 必填 描述
userid String 是 用户 id
videoid String 是 视频 id
format String 否 返回格式，xml或json，默认xml

返回数据

名称 类型 说明
video Object 视频信息

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 原始文件占用空间
updateuser String 上传人 (‘主账号’/子账号的邮箱)
updatetime 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"?>
<video>
    <id>01234567</id>
    <title>
        <![CDATA[视频标题]]>
    </title>
    <desp>
        <![CDATA[视频描述]]>
    </desp>
    <tags>
        <![CDATA[标签1 标签2 标签3]]>
    </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>

JSON示例

{
    "video": {
        "id": "01234567",
        "title": "视频标题",
        "desp": "视频描述",
        "tags": "标签1 标签2 标签3",
        "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"
    }
}

4. v3版本

请求地址

https://spark.bokecc.com/api/video/v3

请求参数

名称 类型 必填 描述
userid String 是 用户 id
videoid String 是 视频 id
format String 否 返回格式，xml或json，默认xml

返回数据

名称 类型 说明
video Object 视频信息

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"?>
<video>
    <id>01234567</id>
    <title>
        <![CDATA[视频标题]]>
    </title>
    <desp>
        <![CDATA[视频描述]]>
    </desp>
    <tags>
        <![CDATA[标签1 标签2 标签3]]>
    </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>

JSON示例

{
    "video": {
        "id": "01234567",
        "title": "视频标题",
        "desp": "视频描述",
        "tags": "标签1 标签2 标签3",
        "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
    }
}

5. v2版本

请求地址

https://spark.bokecc.com/api/video/v2

请求参数

名称 类型 必填 描述
userid String 是 用户 id
videoid String 是 视频 id
format String 否 返回格式，xml或json，默认xml

返回数据

名称 类型 说明
video Object 视频信息

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"?>
<video>
    <id>01234567</id>
    <title><![CDATA[视频标题]]></title>
    <desp><![CDATA[视频描述]]></desp>
    <tags><![CDATA[标签1 标签2 标签3]]></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>

JSON示例

{
    "video": {
        "id": "01234567",
        "title": "视频标题",
        "desp": "视频描述",
        "tags": "标签1 标签2 标签3",
        "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
            },
            ......
        ]
    }
}

6. v1版本

请求地址

https://spark.bokecc.com/api/video

请求参数

名称 类型 必填 描述
userid String 是 用户 id
videoid String 是 视频 id
format String 否 返回格式，xml或json，默认xml

返回数据

名称 类型 说明
video Object 视频信息

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"?>
<video>
    <id>01234567</id>
    <title><![CDATA[视频标题]]></title>
    <desp><![CDATA[视频描述]]></desp>
    <tags><![CDATA[标签1 标签2 标签3]]></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>

JSON示例

{
    "video": {
        "id": "01234567",
        "title": "视频标题",
        "desp": "视频描述",
        "tags": "标签1 标签2 标签3",
        "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 ""