搜索排行榜分类

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