搜索视频
更新时间:2012-06-04
接口描述
该接口用于搜索视频。·
请求地址
https://spark.bokecc.com/api/videos/search
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 用户id。 |
q | String | 是 | 查询条件 格式:查询字段:查询内容 查询字段:目前只支持TITLE 查询内容:查询关键字 注:格式中的“:”为英文半角 Example:q=TITLE:test。 |
sort | String | 是 | 查询结果排序 格式:排序字段:排序方式 排序字段:CREATION_DATE或FILE_SIZE 排序方式:ASC或DESC 注:格式中的“:”为英文半角 Example:sort=CREATION_DATE:DESC。 |
categoryid | String | 否 | 视频子分类 id,如果不查询指定分类下的视频,请勿加入此参数。 |
num_per_page | Integer | 否 | 分页参数,每页显示数量,默认为100。取值范围:1~100之间的任意整数。 |
page | Integer | 否 | 分页参数,页码,默认为1。取值范围:大于0的整数。 |
format | String | 否 | 返回格式,xml或json,默认xml |
请求示例
https://spark.bokecc.com/api/videos/search?q=TITLE%3A111&sort=CREATION_DATE%3ADESC&time=1670915417962&userid=xxxxxx&hash=6CBBAF6D3E86873EE311F521468C7461
返回数据
名称 | 类型 | 说明 |
---|---|---|
videos | Object | 视频信息。 |
videos说明
名称 | 类型 | 说明 |
---|---|---|
total | Long | 返回视频数量。 |
video | Array | 视频信息。 |
video说明
名称 | 类型 | 说明 |
---|---|---|
id | String | 视频ID。 |
title | String | 视频标题。 |
desp | String | 视频描述。 |
tags | String | 视频标签。 |
duration | Integer | 视频时长,单位:秒。 |
category | String | 视频分类ID。 |
creation-date | String | 视频创建时间。 |
filesize | Long | 视频文件大小,单位:字节。 |
image | 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>
<creation-date>2012-10-29 15:16:50</creation-date>
<filesize>4174340</filesize>
<image>http://image.bokecc.com/abc.jpg</image
</video>
......
</videos>
JSON返回示例
{
"videos": {
"total": 100,
"video": [
{
"id": "01234567",
"title": "Video Title",
"desp": "Video Description",
"tags": "tag1 tag2 tag3",
"duration": 12345,
"category": "12345",
"creation-date": "2012-10-29 15:16:50",
"filesize": 4174340,
"image": "http://image.bokecc.com/abc.jpg"
}
]
}
}