虾米音乐排行榜导航 官方自营 全部收费

 

可根据类别查询虾米音乐排行榜,使用关键词搜索歌曲并获得页面地址,查询艺人热门歌曲及专辑列表。

浏览量: 32267

调用量: 76527

使用人数: 7174

¥ 0.01 元起

接入点说明: 查看虾米音乐的排行榜信息
相关文档:
接口地址: http://route.showapi.com/1143-7 (注意:接口支持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 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_sign_method String md5 签名生成方式,其值可选为"md5"或"hmac"。如果不传入则默认"md5"。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数):
参数名称 类型 默认值 示例值 必须 描述
typeId String
102
类型id
103 = 虾米音乐榜
102 = 虾米新歌榜
104 = 虾米原创榜

201 = Hito中文榜
202 = 香港劲歌金榜
203 = 英国UK单曲榜
204 = Billboard单曲榜
205 = Oricon公信单曲榜
206 = M-net综合数据周榜

page String
1
第几页,每页最多25条记录

返回参数/ 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,服务不存在或未上线
-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受限
showapi_res_error String 用户输入有误! 错误信息的展示
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
pagebean Xiami_Top_PageBean
分页结构
- allNum String
113128
所有记录条数
- allPages String
11312
总页数
- currentPage String
1
当前第几页
- maxResult String
25
每页最大记录数
- contentlist MusicItem[]
查询到的歌曲列表
-- artistId String
艺人id
-- artistName String
艺人名称
-- artistUrl String
艺人详情链接地址
-- albumName String
专辑名称
-- albumId String
专辑id
-- albumUrl String
专辑详情地址
-- songName String
歌曲标题
-- totalScore String
得分,仅在阿里音东排行榜中此字段有值
-- songUrl String
歌曲url
-- songId String
歌曲id
-- rank Number
排名,仅在排行榜查询中此字段有值
-- albumLogo String
专辑图片
-- artistLogo String
艺人图片
-- singerName String
歌手名字
-- listenUrl String
听歌的url地址
ret_code String
0
成功为0,其他失败
...

返回示例/ Return example

{
	"showapi_res_code": 0,
	"showapi_res_error": "",
	"showapi_res_body": {
		"ret_code": 0,
		"pagebean": {
			"allPages": "8",
			"contentlist": [
				{
					"albumName": "",
					"albumId": "2100372319",
					"albumUrl": "http://www.xiami.com/album/2100372319",
					"singerLogo": "",
					"songName": "小半",
					"songId": "1776290685",
					"albumLogo": "http://img.xiami.net/images/album/img9/106166809/21003723191470712635.jpg",
					"songUrl": "http://www.xiami.com/song/1776290685",
					"artistLogo": "",
					"filesize": 0,
					"rank": 1,
					"artistUrl": "http://www.xiami.com/artist/profile-106166809",
					"artistId": "106166809",
					"listenUrl": "http://www.xiami.com/play?ids=/song/playlist/id/1776290685/object_name/default/object_id/0",
					"artistName": "陈粒(粒粒)"
				},
				{
					"albumName": "",
					"albumId": "",
					"albumUrl": "",
					"singerLogo": "",
					"songName": "小星星",
					"songId": "1769872629",
					"albumLogo": "http://img.xiami.net/images/album/img11/75411/4115591474885931.jpg",
					"songUrl": "http://www.xiami.com/song/1769872629",
					"artistLogo": "",
					"filesize": 0,
					"rank": 2,
					"artistUrl": "http://www.xiami.com/artist/profile-75411",
					"artistId": "75411",
					"listenUrl": "http://www.xiami.com/play?ids=/song/playlist/id/1769872629/object_name/default/object_id/0",
					"artistName": "汪苏泷(Silence)"
				} 
			],
			"currentPage": "1",
			"allNum": "200",
			"maxResult": "25"
		}
	}
}