获取视频信息

更新时间：2019-11-25

1. v6版本

接口描述
该接口用于获取单个视频信息，在v5版本基础上请求参数新增封面截图的类型。
请求地址
https://spark.bokecc.com/api/video/v6
请求方式
GET
请求参数

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

名称 类型 必填 描述
userid String 是 用户 ID。
videoid String 是 视频 ID。
imagetype Integer 否 返回封面截图的类型，取值范围(0：小图 1：大图)，默认值：0。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/video/v6?format=json&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1670922659110&userid=xxxxxx&hash=A1491625A69AA047C0933C38110AFD8F
返回数据
名称 类型 说明
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版本

接口描述
该接口用于获取单个视频信息，在v4版本基础上返回数据增加视频宽高信息。
请求地址
https://spark.bokecc.com/api/video/v5
请求方式
GET
请求参数

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

名称 类型 必填 描述
userid String 是 用户ID。
videoid String 是 视频ID。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/video/v5?format=json&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1670922659188&userid=xxxxxx&hash=A8211825A69AA047C0933C38110AFD8G
返回数据
名称 类型 说明
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版本

接口描述
该接口用于获取单个视频信息，在v3版本基础上返回数据新增上传者和上传时间。
请求地址
https://spark.bokecc.com/api/video/v4
请求方式
GET
请求参数

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

名称 类型 必填 描述
userid String 是 用户ID。
videoid String 是 视频ID。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/video/v4?format=json&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1670922659188&userid=xxxxxx&hash=A8211825A69AA047C0933C38110AFD8G
返回数据
名称 类型 说明
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版本

接口描述
该接口用于获取单个视频信息，在v2版本基础上返回参数新增文件总大小和原始文件大小。
请求地址
https://spark.bokecc.com/api/video/v3
请求方式
GET
请求参数

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

名称 类型 必填 描述
userid String 是 用户ID。
videoid String 是 视频ID。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/video/v3?format=json&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1670922659188&userid=xxxxxx&hash=A8211825A69AA047C0933C38110AFD8G
返回数据
名称 类型 说明
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版本

接口描述
该接口用于获取单个视频信息，在v1版本基础上返回数据新增转码后视频大小。
请求地址
https://spark.bokecc.com/api/video/v2
请求方式
GET
请求参数

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

名称 类型 必填 描述
userid String 是 用户ID。
videoid String 是 视频ID。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/video/v2?format=json&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1670922659188&userid=xxxxxx&hash=A8211825A69AA047C0933C38110AFD8G
返回数据
名称 类型 说明
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
请求方式
GET
请求参数

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

名称 类型 必填 描述
userid String 是 用户ID。
videoid String 是 视频ID。
format String 否 返回格式，xml或json，默认xml。
请求示例
https://spark.bokecc.com/api/video?format=json&videoid=6D080640AF53B5D363835A29B2A11xxx&time=1670922659188&userid=xxxxxx&hash=A8211825A69AA047C0933C38110AFD8G
返回数据
名称 类型 说明
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 ""