获取视频信息

更新时间：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"
            },
            ......
        ]
    }
}

获取视频信息

1. v6版本

接口描述

请求地址

请求方式

请求参数

请求示例

返回数据

video说明

image-alternate说明

definition说明

XML返回示例

JSON返回示例

2. v5版本

接口描述

请求地址

请求方式

请求参数

请求示例

返回数据

video说明

image-alternate说明

definition说明

XML返回示例

JSON返回示例

3. v4版本

接口描述

请求地址

请求方式

请求参数

请求示例

返回数据

video说明

image-alternate说明

definition说明

XML返回示例

JSON返回示例

4. v3版本

接口描述

请求地址

请求方式

请求参数

请求示例

返回数据

video说明

image-alternate说明

definition说明

XML返回示例

JSON返回示例

5. v2版本

接口描述

请求地址

请求方式

请求参数

请求示例

返回数据

video说明

image-alternate说明

definition说明

XML返回示例

JSON返回示例

6. v1版本

接口描述

请求地址

请求方式

请求参数

请求示例

返回数据

video说明

image-alternate说明

XML返回示例

JSON返回示例

results matching ""

No results matching ""

marketing@bokecc.com 北京市海淀区北三环中路44号海淀文教产业园F座4层

marketing@bokecc.com

北京市海淀区北三环中路44号海淀文教产业园F座4层