搜索视频
通过该接口可以搜索指定信息的视频,地址为http://spark.bokecc.com/api/videos/search
需要传递以下参数:
参数 | 说明 |
---|---|
userid | 用户id,不可为空 |
q | 查询条件,不可为空 格式:查询字段:查询内容 查询字段:目前只支持TITLE 查询内容:查询关键字 注:格式中的”:”为英文半角 Example:q=TITLE:test |
sort | 查询结果排序,不可为空 格式:排序字段:排序方式 排序字段:CREATION_DATE或FILE_SIZE 排序方式:ASC或DESC 注:格式中的”:”为英文半角 Example:sort=CREATION_DATE:DESC |
categoryid | 视频子分类 id,如果不查询指定分类下的视频,请勿加入此参数 |
num_per_page | 返回信息时,每页包含的视频个数.注:阈值为 1~100 |
page | 当前页码 |
format | 返回格式,xml 或json |
返回数据videos包含如下字段:
字段名 | 说明 |
---|---|
total | 返回视频数量 |
video | 视频信息 |
video包含如下字段:
字段名 | 说明 |
---|---|
id | 视频ID |
title | 视频标题 |
desp | 视频描述 |
tags | 视频标签 |
duration | 视频时长,单位秒 |
category | 视频分类ID |
creation-date | 视频创建时间 |
filesize | 视频文件大小,单位字节 |
image | 视频截图地址 |
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"
},
…
]
}
}