帮助文档
搜索排行榜分类
1. 接口描述
| URL | https://openapi.youku.com/router/rest.json |
| 功能描述 | 搜索排行榜分类 |
| 返回格式 | Json，UTF8 |
| HTTP请求方式 | GET |
| 当前接口版本 | V3 |
| 历史接口版本 | 无 |
2. 系统参数
| 参数名 | 参数全称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|---|
| action | action | true | String | youku.search.rankinglist.category |
| client_id | client_id | true | String | 应用的client id |
| access_token | access token | false | String | oauth2的token |
| format | format | false | String | 可选，指定响应格式。默认保持代理接口格式化,目前支持格式为xml,json,text |
| timestamp | timestamp | true | String | 客户端当前时间戳，精确到秒，timestamp与开放平台请求时间误差为6分钟 |
| version | version | true | String | 3.0 |
| sign | sign | true | String | 对API调用参数（除sign外）的md5加密值。详情见签名方法 |
3. 业务参数
| 参数名 | 参数全称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|---|
| client_id | client_id | true | String | 应用的client id |
| access_token | access token | false | String | oauth2的token |
| format | format | false | String | 可选，指定响应格式。默认保持代理接口格式化,目前支持格式为xml,json,text |
| timestamp | timestamp | true | String | 客户端当前时间戳，精确到秒，timestamp与开放平台请求时间误差为6分钟 |
| version | version | true | String | 3.0 |
| sign | sign | true | String | 对API调用参数（除sign外）的md5加密值。详情见签名方法 |
4. 返回参数
| 参数 | 参数名称 | 参数类型 | 参数描述 |
|---|---|---|---|
| provider | provider | string | 父字段:e 服务方名称：searches.soku.kubox |
| code/td> | code | int | 父字段:e ,错误代码 |
| desc | desc | String | 父字段:e,错误描述 |
| total | total | String | 结果条数 |
| cost | cost | int | 耗时 |
| cateId | cateId | int | 父字段:data,分类ID |
| cateAlias | cateAlias | String | 父字段:data,分类别名：按分类请求排行榜API接口时的channel参数 |
| cateName | cateName | string | 父字段:data,分类名称 |
5. 调用示例
https://openapi.youku.com/router/rest.json?fd=nationality&opensysparams
={"sign": "c3b07e11408ef6439076bd3cfa918387", "action": "youku.search.rankinglist.category",
"format": "json", "timestamp": 1453721395, "access_token": "d9ce66ced641240836cf6011a4c195bc",
"version": "3.0", "client_id": "163d4fd10c7f9a28"}&caller=NOVA
6. 响应示例
{
"e": {
"provider": "searches.soku.top",
"code": 0,
"desc": "OK"
},
"total": 9,
"cost": 5,
"data": [
{
"cateId": 1,
"cateAlias": "teleplay",
"cateName": "电视剧"
},
{
"cateId": 2,
"cateAlias": "movie",
"cateName": "电影"
},
{
"cateId": 3,
"cateAlias": "variety",
"cateName": "综艺"
},
{
"cateId": 5,
"cateAlias": "anime",
"cateName": "动漫"
},
{
"cateId": 4,
"cateAlias": "music",
"cateName": "音乐"
},
{
"cateId": 6,
"cateAlias": "person",
"cateName": "明星"
},
{
"cateId": 7,
"cateAlias": "sports",
"cateName": "体育"
},
{
"cateId": 9,
"cateAlias": "documentary",
"cateName": "纪录片"
},
{
"cateId": 102,
"cateAlias": "fun",
"cateName": "搞笑"
}
]
}
7. 异常示例
"e": {
"provider":"searches.soku.top",
"code":1503,
"desc":"系统异常"
}
8. 注意事项
请预留“X-Caller”和“User-Agent”以标识调用方名称和调用方平台如果调用方不是请求的发起方而是代理方，请设置“X-Forwarded-For”记录发起方的真实IP
