优酷开放云

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

帮助文档

搜索排行榜分类

1. 接口描述

2. 系统参数

3. 业务参数

4. 返回参数

5. 调用示例

6. 响应示例

7. 异常示例

8. 注意事项