新浪微博风云榜

微博风云榜查询

接口地址：http://route.showapi.com/254-1 （注意：接口支持https，更安全，但稍慢一些，你懂的。请根据自己的情况进行选择。）

支持格式：json

请求方法：HTTP协议，支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时，enctype=application/x-www-form-urlencoded。 
文件上传的POST时，enctype=multipart/form-data。 

1、系统级参数（所有接入点都需要的参数）： 

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp	String	20141114142239	否	客户端时间。  格式yyyyMMddHHmmss,如20141114142239  为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起 

参数名称	类型	默认值	示例值	必须	描述
typeId	String		1	是	类型id 互联网=1 科学=2 历史=3 军事=4 数码=6 人文=7 宠物=9 星座=10 搞笑=11 情感=12 媒体=13 养生=15 音乐=16 电视剧=17 电影=18 综艺=19 摄影=21 健身=22 体育=23 美食=777 旅游=25 财经=26 医疗=27 读书=28 房地产=30 汽车=31 时尚=888 美妆=999 教育=36 动漫=37 游戏=38 法律=39 母婴=40 娱乐=41 收藏=42 科技观察=101
space	String		day	是	类容，分为 日榜=day 周榜=week 月榜=month
key	String			否	微博主人名称关键词
date	String			否	榜单日期。格式yyyyMMdd 如果是周榜，则此日期为上一周的星期1 如果是月榜，则此日期为上一月的第1天
page	String			否	第几页。每页最大20条记录
...

请求示例：String res=new ShowApiRequest("http://route.showapi.com/254-1","my_appId","my_appSecret") .addTextPara("typeId","1") .addTextPara("space","day") .addTextPara("key","") .addTextPara("date","") .addTextPara("page","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起 

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口  -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起 

名称	类型	示例值	描述
pagebean	Object[]		分页数据结构
-  maxResult	String	20	每页最大记录数
-  currentPage	String	1	当前页
-  allPages	String	5	所有的页数
-  allNum	String	100	所有记录数
-  contentlist	Object[]		实体对象列表
-  typeId	String		类型id
-  typeName	String		类型名称
-  space	String		空间类型，有天、周和月三种。分别是: day、week、month
-  date	String		此榜单发布日期
-  num	String		用户排名
-  img	String		头像地址
-  name	String		用户名称
-  newinfo	String		用户最新微博内容
-  desc	String		用户简单描述
-  influence	String		用户影响力，满分100分
-  url	String		用户新浪微博地址
...

返回示例：{ "showapi_res_code": 0, "showapi_res_error": "", "showapi_res_body": { "pagebean": { "allNum": 100, "allPages": 5, "contentlist": [ { "date": 20150824, "img": "http://tp1.sinaimg.cn/2709577332/180/5734583466/0", "influence": "91.02", "name": "Happy张江", "newinfo": "哈哈哈哈哈，好厉害的#湖 南 大 妈#，说的句句在理，叫人无法反驳啊。。。[笑cry]http://t.cn/RyvzYk1", "num": 1, "space": "day", "typeId": "0", "typeName": "人物", "url": "http://weibo.com/u/2709577332" } ], "currentPage": 1, "maxResult": 20 }, "ret_code": 0 } }