获取视频信息

优质

小牛编辑

132浏览

2023-12-01

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

a.当地址为https://spark.bokecc.com/api/video/v6

需要传递以下参数

参数	说明
userid	用户 id，不可为空
videoid	视频 id，不可为空
imagetype	返回封面截图的类型,默认值:0(0:小图;1:大图)
format	返回格式，xml 或 json

返回数据video包括如下字段：

字段名	说明
id	视频ID
title	视频标题
desp	视频描述
tags	视频标签
duration	视频时长，单位秒
category	视频分类ID
image	视频截图地址
imageindex	视频截图序号
image-alternate	视频截图排列信息
definition	视频文件大小信息
totalsize	视频占用总空间，包含原始文件大小
originalsize	原始文件占用空间
updateuser	上传人 (‘主账号’/子账号的邮箱)
updatetime	上传时间

image-alternate包括如下字段：

字段名	说明
index	视频截图排列序号
url	视频截图地址

definition包括如下字段：

字段名	说明
definitionlevel	视频清晰度值
definitiondesc	视频清晰度描述
terminaltype	终端类型（0:PC端，10:移动端）
filesize	视频文件大小
width	该清晰度视频的宽
height	该清晰度视频的高

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”
    }
}

b.当地址为https://spark.bokecc.com/api/video/v5

需要传递以下参数

参数	说明
userid	用户 id，不可为空
videoid	视频 id，不可为空
format	返回格式，xml 或 json

返回数据video包括如下字段：

字段名	说明
id	视频ID
title	视频标题
desp	视频描述
tags	视频标签
duration	视频时长，单位秒
category	视频分类ID
image	视频截图地址
imageindex	视频截图序号
image-alternate	视频截图排列信息
definition	视频文件大小信息
totalsize	视频占用总空间，包含原始文件大小
originalsize	原始文件占用空间
updateuser	上传人 (‘主账号’/子账号的邮箱)
updatetime	上传时间

image-alternate包括如下字段：

字段名	说明
index	视频截图排列序号
url	视频截图地址

definition包括如下字段：

字段名	说明
definitionlevel	视频清晰度值
definitiondesc	视频清晰度描述
terminaltype	终端类型（0:PC端，10:移动端）
filesize	视频文件大小
width	该清晰度视频的宽
height	该清晰度视频的高

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”
    }
}

c.当地址为https://spark.bokecc.com/api/video/v4

需要传递以下参数

参数	说明
userid	用户 id，不可为空
videoid	视频 id，不可为空
format	返回格式，xml 或 json

返回数据video包括如下字段：

字段名	说明
id	视频ID
title	视频标题
desp	视频描述
tags	视频标签
duration	视频时长，单位秒
category	视频分类ID
image	视频截图地址
imageindex	视频截图序号
image-alternate	视频截图排列信息
definition	视频文件大小信息
totalsize	视频占用总空间，包含原始文件大小
originalsize	原始文件占用空间
updateuser	上传人 (‘主账号’/子账号的邮箱)
updatetime	上传时间

image-alternate包括如下字段：

字段名	说明
index	视频截图排列序号
url	视频截图地址

definition包括如下字段：

字段名	说明
definitionlevel	视频清晰度值
definitiondesc	视频清晰度描述
terminaltype	终端类型（0:PC端，10:移动端）
filesize	视频文件大小

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”
    }
}

d.当地址为https://spark.bokecc.com/api/video/v3

需要传递以下参数

参数	说明
userid	用户 id，不可为空
videoid	视频 id，不可为空
format	返回格式，xml 或 json

返回数据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"?>
<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
    }
}

e.当地址为https://spark.bokecc.com/api/video/v2

需要传递以下参数

参数	说明
userid	用户 id，不可为空
videoid	视频 id，不可为空
format	返回格式，xml 或 json

返回数据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"?>
<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
        },
        …
        ]
    }
}

f.当地址为https://spark.bokecc.com/api/video

需要传递以下参数：

参数	说明
userid	用户 id，不可为空
videoid	视频 id，不可为空
format	返回格式，xml 或 json

返回数据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"?>
<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"
        },
        ...
        ]
    }
}