media-api

1. 音乐

1.1. 专辑

1.1.1. newRelease

URL /music/album/newRelease

介绍:获取新发布的专辑列表

Curl request
$ curl 'http://localhost:8080/music/albums/newRelease?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=54DD8F8BE8ACCA8B2D330BF5AAA62E09&page=2&pageSize=1' -i
HTTP request
GET /music/albums/newRelease?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=54DD8F8BE8ACCA8B2D330BF5AAA62E09&page=2&pageSize=1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 424

{
	"code":200,
	"data":{
		"list":[
			{
				"artist":{
					"id":115250,
					"logo":"http://pic.xiami.net/images/artistlogo/6/15235874956606.jpg",
					"name":"于文文"
				},
				"id":2103696570,
				"logo":"http://pic.xiami.net/images/album/img90/714690/7146901524714690.jpg",
				"name":"就差一个你"
			}
		],
		"page":{
			"page":2,
			"pageSize":1,
			"total":100,
			"totalPage":100
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/albums/newRelease?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=54DD8F8BE8ACCA8B2D330BF5AAA62E09&page=2&pageSize=1'
Request parameters
Parameter Description

page

请求页码,默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].id

Number

专辑ID

data.list[].logo

String

专辑LOGO

data.list[].name

String

专辑名称

data.list[].artist

Object

艺人信息

data.list[].artist.id

Number

艺人ID

data.list[].artist.logo

String

艺人LOGO

data.list[].artist.name

String

艺人名称

data.page

Object

分页信息

data.page.page

Number

请求页码

data.page.pageSize

Number

每页显示条数

data.page.total

Number

总记录数

data.page.totalPage

Number

总页数

1.1.2. songList

URL /music/album/songList

介绍：获取某个专辑的歌曲列表

Curl request
$ curl 'http://localhost:8080/music/albums/songList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=B0E320909F23566E3B11D3A824D1E253&albumId=2103696570' -i
HTTP request
GET /music/albums/songList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=B0E320909F23566E3B11D3A824D1E253&albumId=2103696570 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 1043

{
	"code":200,
	"data":{
		"list":[
			{
				"album":{
					"id":2103696570,
					"logo":"http://pic.xiami.net/images/album/img90/714690/7146901524714690.jpg",
					"name":"就差一个你"
				},
				"artist":{
					"id":115250,
					"logo":"http://pic.xiami.net/images/artistlogo/6/15235874956606.jpg",
					"name":"于文文"
				},
				"canDownload":true,
				"canPlay":true,
				"lyricFile":"http://img.xiami.net/lyric/73/1802984073_1524731034_2060.trc",
				"lyricType":"trc",
				"singers":"于文文",
				"songId":1802984073,
				"songName":"就差一个你"
			},
			{
				"album":{
					"id":2103696570,
					"logo":"http://pic.xiami.net/images/album/img90/714690/7146901524714690.jpg",
					"name":"就差一个你"
				},
				"artist":{
					"id":115250,
					"logo":"http://pic.xiami.net/images/artistlogo/6/15235874956606.jpg",
					"name":"于文文"
				},
				"canDownload":true,
				"canPlay":true,
				"singers":"于文文",
				"songId":1802984074,
				"songName":"就差一个你 (伴奏)"
			}
		]
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/albums/songList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=B0E320909F23566E3B11D3A824D1E253&albumId=2103696570'
Request parameters
Parameter Description

albumId

专辑ID

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].canDownload

Boolean

是否可以下载,true/false

data.list[].canPlay

Boolean

是否可以播放，true/false

data.list[].lyricFile

String

歌词文件

data.list[].lyricType

String

歌词类型，text/lrc/trc/translate

data.list[].singers

String

歌手信息，多个歌手通过/分割

data.list[].songId

Number

歌曲ID

data.list[].songName

String

歌曲名称

data.list[].artist

Object

艺人信息

data.list[].artist.id

Number

艺人ID

data.list[].artist.logo

String

艺人LOGO

data.list[].artist.name

String

艺人名称

1.2. 榜单

1.2.1. list

URL /music/billboards/list

介绍:获取榜单列表

Curl request
$ curl 'http://localhost:8080/music/billboards/list?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1' -i
HTTP request
GET /music/billboards/list?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 311

{
	"code":200,
	"data":{
		"list":[
			{
				"id":101,
				"name":"飙升榜"
			},
			{
				"id":305,
				"name":"歌曲收录榜"
			},
			{
				"id":306,
				"name":"K歌榜"
			},
			{
				"id":307,
				"name":"虾米分享榜"
			},
			{
				"id":310,
				"name":"电音榜"
			}
		]
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/billboards/list?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1'
Request parameters
Parameter Description

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].id

Number

榜单ID

data.list[].name

String

歌单名称

1.2.2. detail

URL /music/billboards/detail

介绍:获取榜单的详情，主要是一些歌曲列表

Curl request
$ curl 'http://localhost:8080/music/billboards/detail?id=102&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E05877A6F5C8F0FAE47A34A918CFB214' -i
HTTP request
GET /music/billboards/detail?id=102&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E05877A6F5C8F0FAE47A34A918CFB214 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 670

{
	"code":200,
	"data":{
		"list":[
			{
				"album":{
					"id":2103754211,
					"logo":"http://pic.xiami.net/images/album/img97/60/5b2ce15dd6af1_3028197_1529667933.jpg",
					"name":"渐渐"
				},
				"artist":{
					"id":135,
					"logo":"http://pic.xiami.net/images/artistlogo/64/15296684855164.jpg",
					"name":"陈奕迅"
				},
				"canDownload":false,
				"canPlay":true,
				"lyricFile":"http://img.xiami.net/lyric/70/1803360770_1529668817_243.trc",
				"lyricType":"trc",
				"singers":"陈奕迅",
				"songId":1803360770,
				"songName":"渐渐"
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":50,
			"totalPage":50
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/billboards/detail?id=102&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E05877A6F5C8F0FAE47A34A918CFB214'
Request parameters
Parameter Description

id

榜单ID

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].canDownload

Boolean

是否可以下载,true/false

data.list[].canPlay

Boolean

是否可以播放，true/false

data.list[].lyricFile

String

歌词文件

data.list[].lyricType

String

歌词类型，text/lrc/trc/translate

data.list[].singers

String

歌手信息，多个歌手通过/分割

data.list[].songId

Number

歌曲ID

data.list[].songName

String

歌曲名称

data.list[].artist

Object

艺人信息

data.list[].album

Object

专辑信息

data.list[].artist.id

Number

艺人ID

data.list[].artist.logo

String

艺人LOGO

data.list[].artist.name

String

艺人名称

data.list[].album.id

Number

专辑ID

data.list[].album.logo

String

专辑LOGO

data.list[].album.name

String

专辑名称

1.3. 搜索

1.3.1. hotwords

URL /music/search/hotwords

介绍：获取搜索热词列表

Curl request
$ curl 'http://localhost:8080/music/search/hotwords?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1' -i
HTTP request
GET /music/search/hotwords?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 733

{
	"code":200,
	"data":{
		"list":[
			{
				"word":"答案"
			},
			{
				"word":"that girl"
			},
			{
				"word":"讲真的"
			},
			{
				"word":"抖音"
			},
			{
				"word":"五月天"
			},
			{
				"word":"儿歌"
			},
			{
				"word":"纸短情长"
			},
			{
				"word":"学猫叫"
			},
			{
				"word":"走马"
			},
			{
				"word":"我的将军啊"
			},
			{
				"word":"9277"
			},
			{
				"word":"田馥甄"
			},
			{
				"word":"张学友"
			},
			{
				"word":"林宥嘉"
			},
			{
				"word":"起风了"
			},
			{
				"word":"华晨宇"
			},
			{
				"word":"李宗盛"
			},
			{
				"word":"卡布奇诺"
			},
			{
				"word":"后来"
			},
			{
				"word":"张国荣"
			}
		]
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/search/hotwords?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1'
Request parameters
Parameter Description

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

结果列表

data.list[].word

String

热搜词

1.3.2. suggest

URL /music/search/suggest

介绍：获取搜索联想词列表

Curl request
$ curl 'http://localhost:8080/music/search/suggest?keyword=%E5%91%A8&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=773E0F7F56C1D17B07FF4049E6793CC7' -i
HTTP request
GET /music/search/suggest?keyword=%E5%91%A8&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=773E0F7F56C1D17B07FF4049E6793CC7 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 508

{
	"code":200,
	"data":{
		"list":[
			{
				"tip":"周杰伦",
				"type":"search"
			},
			{
				"tip":"周华健",
				"type":"search"
			},
			{
				"tip":"周传雄",
				"type":"search"
			},
			{
				"objectId":"1801512872",
				"tip":"最美的期待 - 周笔畅",
				"type":"song"
			},
			{
				"objectId":"1776156051",
				"tip":"告白气球 - 周杰伦",
				"type":"song"
			},
			{
				"objectId":"1770153970",
				"tip":"稻香 - 周杰伦",
				"type":"song"
			}
		]
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/search/suggest?keyword=%E5%91%A8&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=773E0F7F56C1D17B07FF4049E6793CC7'
Request parameters
Parameter Description

keyword

搜索关键字

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

结果列表

data.list[].objectId

String

如果为search，此值为空，根据type不同，分为songId/albumId/mvId

data.list[].tip

String

提示词

data.list[].type

String

search/song/album/mv

1.4. 歌单

1.4.1. search

URL /music/collects/search

介绍：搜索歌单

Curl request
$ curl 'http://localhost:8080/music/collects/search?keyword=%E5%91%A8%E6%9D%B0%E4%BC%A6&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=0FC557A617FE524EEBBBA305861CA859' -i
HTTP request
GET /music/collects/search?keyword=%E5%91%A8%E6%9D%B0%E4%BC%A6&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=0FC557A617FE524EEBBBA305861CA859 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 364

{
	"code":200,
	"data":{
		"list":[
			{
				"description":"",
				"id":354313077,
				"logo":"http://pic.xiami.net/images/appv5/common/40315/59b69e5b56d7f_4mnT_1505140315.jpg",
				"name":"你们要的周杰伦，回来啦！",
				"songCount":83
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":80313,
			"totalPage":80313
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/collects/search?keyword=%E5%91%A8%E6%9D%B0%E4%BC%A6&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=0FC557A617FE524EEBBBA305861CA859'
Request parameters
Parameter Description

keyword

搜索关键字

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

歌单列表数据

data.page

Object

分页信息

data.list[].description

String

歌单描述

data.list[].id

Number

歌单ID

data.list[].logo

String

歌单LOGO

data.list[].name

String

歌单名称

data.list[].songCount

Number

歌曲数量

data.page.page

Number

请求页码

data.page.pageSize

Number

每页显示条数

data.page.total

Number

总记录数

data.page.totalPage

Number

总页数

1.4.2. songList

URL /music/collects/songList

介绍：获取某个歌单的歌曲列表

Curl request
$ curl 'http://localhost:8080/music/collects/songList?id=388810128&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=F79E8FA11AA310747555209AE3B1C3CE' -i
HTTP request
GET /music/collects/songList?id=388810128&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=F79E8FA11AA310747555209AE3B1C3CE HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 696

{
	"code":200,
	"data":{
		"list":[
			{
				"album":{
					"id":1313437671,
					"logo":"http://pic.xiami.net/images/album/img17/7117/13134376711415242051.jpeg",
					"name":"DEARS"
				},
				"artist":{
					"id":7117,
					"logo":"http://pic.xiami.net/images/artistlogo/59/15268687903159.jpg",
					"name":"中島美嘉"
				},
				"canDownload":false,
				"canPlay":true,
				"lyricFile":"http://img.xiami.net/lyric/80/1773633480_1528794371_7703.xtrc",
				"lyricType":"trc",
				"singers":"中島美嘉",
				"songId":1773633480,
				"songName":"僕が死のうと思ったのは"
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":60,
			"totalPage":60
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/collects/songList?id=388810128&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=F79E8FA11AA310747555209AE3B1C3CE'
Request parameters
Parameter Description

id

歌单ID

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

歌曲列表

data.page

Object

分页信息

data.list[].album

Object

专辑信息

data.list[].album.id

Number

专辑ID

data.list[].album.logo

String

专辑LOGO

data.list[].album.name

String

专辑名称

data.list[].canDownload

Boolean

是否可以下载,true/false

data.list[].canPlay

Boolean

是否可以播放，true/false

data.list[].lyricFile

String

歌词文件

data.list[].lyricType

String

歌词类型，text/lrc/trc/translate

data.list[].singers

String

歌手信息，多个歌手通过/分割

data.list[].songId

Number

歌曲ID

data.list[].songName

String

歌曲名称

data.list[].artist

Object

艺人信息

data.list[].artist.id

Number

艺人ID

data.list[].artist.logo

String

艺人LOGO

data.list[].artist.name

String

艺人名称

data.page.page

Number

请求页码

data.page.pageSize

Number

每页显示条数

data.page.total

Number

总记录数

data.page.totalPage

Number

总页数

1.4.3. daily

URL /music/collects/daily

介绍：获取每日推荐歌单

Curl request
$ curl 'http://localhost:8080/music/collects/daily?page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5' -i
HTTP request
GET /music/collects/daily?page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 348

{
	"code":200,
	"data":{
		"list":[
			{
				"id":388810128,
				"logo":"http://img.xiami.net/images/appv5/common/1530/5b2ca14a6ab93_j08x_1529651530.jpg",
				"name":"有时候就是想一个人静静得听音乐",
				"songCount":60
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":1000,
			"totalPage":1000
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/collects/daily?page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5'
Request parameters
Parameter Description

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

歌单列表

data.page

Object

分页信息

data.list[].description

String

歌单描述

data.list[].id

Number

歌单ID

data.list[].logo

String

歌单LOGO

data.list[].name

String

歌单名称

data.list[].songCount

Number

歌曲数量

data.page.page

Number

请求页码

data.page.pageSize

Number

每页显示条数

data.page.total

Number

总记录数

data.page.totalPage

Number

总页数

1.5. 歌曲

1.5.1. search

URL /music/songs/search

介绍：搜索歌曲

Curl request
$ curl 'http://localhost:8080/music/songs/search?keyword=%E4%B8%8D%E7%88%B1%E6%88%91%E5%B0%B1%E6%8B%89%E5%80%92&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=ECE3936A397DC7D6C1A848374E78C8BD' -i
HTTP request
GET /music/songs/search?keyword=%E4%B8%8D%E7%88%B1%E6%88%91%E5%B0%B1%E6%8B%89%E5%80%92&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=ECE3936A397DC7D6C1A848374E78C8BD HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 688

{
	"code":200,
	"data":{
		"list":[
			{
				"album":{
					"id":2103708276,
					"logo":"http://pic.xiami.net/images/album/img57/347057/21037082761526347057.jpg",
					"name":"不爱我就拉倒"
				},
				"artist":{
					"id":1260,
					"logo":"http://pic.xiami.net/images/artistlogo/36/15162027033536.jpg",
					"name":"周杰伦"
				},
				"canDownload":false,
				"canPlay":true,
				"lyricFile":"http://img.xiami.net/lyric/91/1803053391_1526311910_7922.trc",
				"lyricType":"trc",
				"singers":"周杰伦",
				"songId":1803053391,
				"songName":"不爱我就拉倒"
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":24,
			"totalPage":24
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/songs/search?keyword=%E4%B8%8D%E7%88%B1%E6%88%91%E5%B0%B1%E6%8B%89%E5%80%92&page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=ECE3936A397DC7D6C1A848374E78C8BD'
Request parameters
Parameter Description

keyword

搜索关键字

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

歌曲列表

data.list[].canDownload

Boolean

是否可以下载,true/false

data.list[].canPlay

Boolean

是否可以播放，true/false

data.list[].lyricFile

String

歌词文件

data.list[].lyricType

String

歌词类型，text/lrc/trc/translate

data.list[].singers

String

歌手信息，多个歌手通过/分割

data.list[].songId

Number

歌曲ID

data.list[].songName

String

歌曲名称

data.list[].artist

Object

艺人信息

data.list[].artist.id

Number

艺人ID

data.list[].artist.logo

String

艺人LOGO

data.list[].artist.name

String

艺人名称

data.list[].album.id

Number

专辑ID

data.list[].album.logo

String

专辑LOGO

data.list[].album.name

String

专辑名称

1.5.2. get

URL /music/songs/get

介绍：根据艺人和名称获取歌曲信息

Curl request
$ curl 'http://localhost:8080/music/songs/get?artistName=%E5%91%A8%E6%9D%B0%E4%BC%A6&songName=%E4%B8%8D%E7%88%B1%E6%88%91%E5%B0%B1%E6%8B%89%E5%80%92&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=7E56225B66E014AB7D37229DF2198DE3' -i
HTTP request
GET /music/songs/get?artistName=%E5%91%A8%E6%9D%B0%E4%BC%A6&songName=%E4%B8%8D%E7%88%B1%E6%88%91%E5%B0%B1%E6%8B%89%E5%80%92&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=7E56225B66E014AB7D37229DF2198DE3 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 550

{
	"code":200,
	"data":{
		"album":{
			"id":2103708276,
			"logo":"http://pic.xiami.net/images/album/img57/347057/21037082761526347057.jpg",
			"name":"不爱我就拉倒"
		},
		"artist":{
			"id":1260,
			"logo":"http://pic.xiami.net/images/artistlogo/36/15162027033536.jpg",
			"name":"周杰伦"
		},
		"canDownload":false,
		"canPlay":true,
		"lyricFile":"http://img.xiami.net/lyric/91/1803053391_1526311910_7922.trc",
		"lyricType":"trc",
		"singers":"周杰伦",
		"songId":1803053391,
		"songName":"不爱我就拉倒"
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/songs/get?artistName=%E5%91%A8%E6%9D%B0%E4%BC%A6&songName=%E4%B8%8D%E7%88%B1%E6%88%91%E5%B0%B1%E6%8B%89%E5%80%92&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=7E56225B66E014AB7D37229DF2198DE3'
Request parameters
Parameter Description

artistName

歌手名称

songName

歌曲名称

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.canDownload

Boolean

是否可以下载,true/false

data.canPlay

Boolean

是否可以播放，true/false

data.lyricFile

String

歌词文件

data.lyricType

String

歌词类型，text/lrc/trc/translate

data.singers

String

歌手信息，多个歌手通过/分割

data.songId

Number

歌曲ID

data.songName

String

歌曲名称

data.artist

Object

艺人信息

data.artist.id

Number

艺人ID

data.artist.logo

String

艺人LOGO

data.artist.name

String

艺人名称

data.album.id

Number

专辑ID

data.album.logo

String

专辑LOGO

data.album.name

String

专辑名称

1.5.3. detail

NOte: URL /music/songs/detail

介绍：根据ID获取歌曲信息

Curl request
$ curl 'http://localhost:8080/music/songs/detail?id=1803053391&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1' -i
HTTP request
GET /music/songs/detail?id=1803053391&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 550

{
	"code":200,
	"data":{
		"album":{
			"id":2103708276,
			"logo":"http://pic.xiami.net/images/album/img57/347057/21037082761526347057.jpg",
			"name":"不爱我就拉倒"
		},
		"artist":{
			"id":1260,
			"logo":"http://pic.xiami.net/images/artistlogo/36/15162027033536.jpg",
			"name":"周杰伦"
		},
		"canDownload":false,
		"canPlay":true,
		"lyricFile":"http://img.xiami.net/lyric/91/1803053391_1526311910_7922.trc",
		"lyricType":"trc",
		"singers":"周杰伦",
		"songId":1803053391,
		"songName":"不爱我就拉倒"
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/songs/detail?id=1803053391&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1'
Request parameters
Parameter Description

id

歌曲ID

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.canDownload

Boolean

是否可以下载,true/false

data.canPlay

Boolean

是否可以播放，true/false

data.lyricFile

String

歌词文件

data.lyricType

String

歌词类型，text/lrc/trc/translate

data.singers

String

歌手信息，多个歌手通过/分割

data.songId

Number

歌曲ID

data.songName

String

歌曲名称

data.artist

Object

艺人信息

data.artist.id

Number

艺人ID

data.artist.logo

String

艺人LOGO

data.artist.name

String

艺人名称

data.album.id

Number

专辑ID

data.album.logo

String

专辑LOGO

data.album.name

String

专辑名称

1.5.4. listenFile

URL /music/songs/listenFile

介绍：获取指定歌曲的最高音质的试听文件

Curl request
$ curl 'http://localhost:8080/music/songs/listenFile?id=1803053391&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=6B6FAD70EDF52DD05A30364E5EC0EAAD' -i
HTTP request
GET /music/songs/listenFile?id=1803053391&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=6B6FAD70EDF52DD05A30364E5EC0EAAD HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 192

{
	"code":200,
	"data":{
		"listenFile":"http://m128.xiami.net/260/1260/2103708276/1803053391_1526310864990.mp3?auth_key=1530500400-0-0-58098cd43ce87a0767f2c26b76d78c7b"
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/songs/listenFile?id=1803053391&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=6B6FAD70EDF52DD05A30364E5EC0EAAD'
Request parameters
Parameter Description

id

歌曲ID

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.listenFile

String

最高音质的试听文件URL

1.5.5. DownloadFiles

URL /music/songs/downloadFiles

介绍：获取指定歌曲的下载文件列表

No snippets found for operation::Music/Songs/DownloadFiles

1.5.6. Daily

URL /music/songs/daily

介绍：获取每日推荐歌曲列表

Curl request
$ curl 'http://localhost:8080/music/songs/daily?page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5' -i
HTTP request
GET /music/songs/daily?page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 692

{
	"code":200,
	"data":{
		"list":[
			{
				"album":{
					"id":104997677,
					"logo":"http://pic.xiami.net/images/album/img97/1004997397/1049976771427771121.jpg",
					"name":"寻光集"
				},
				"artist":{
					"id":1004997397,
					"logo":"http://pic.xiami.net/images/artistlogo/48/15063207888148.png",
					"name":"虾米音乐人"
				},
				"canDownload":true,
				"canPlay":true,
				"lyricFile":"http://img.xiami.net/lyric/23/1773344123_1445998243_8550.trc",
				"lyricType":"trc",
				"singers":"金玟岐",
				"songId":1773344123,
				"songName":"才华有限公司"
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":30,
			"totalPage":30
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/songs/daily?page=1&pageSize=1&appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5'
Request parameters
Parameter Description

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

歌曲列表

data.list[].canDownload

Boolean

是否可以下载,true/false

data.list[].canPlay

Boolean

是否可以播放，true/false

data.list[].lyricFile

String

歌词文件

data.list[].lyricType

String

歌词类型，text/lrc/trc/translate

data.list[].singers

String

歌手信息，多个歌手通过/分割

data.list[].songId

Number

歌曲ID

data.list[].songName

String

歌曲名称

data.list[].artist

Object

艺人信息

data.list[].artist.id

Number

艺人ID

data.list[].artist.logo

String

艺人LOGO

data.list[].artist.name

String

艺人名称

data.list[].album.id

Number

专辑ID

data.list[].album.logo

String

专辑LOGO

data.list[].album.name

String

专辑名称

1.6. 风格

1.6.1. rollingList

URL /music/styles/rollingList

介绍：转盘风格列表

No snippets found for operation::Music/Styles/RollingList

1.6.2. songList

URL /music/styles/songList

介绍：风格歌曲列表

Curl request
$ curl 'http://localhost:8080/music/styles/rollingList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1' -i
HTTP request
GET /music/styles/rollingList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 754

{
	"code":200,
	"data":{
		"list":[
			{
				"id":2,
				"name":"流行",
				"type":1
			},
			{
				"id":16,
				"name":"民谣",
				"type":1
			},
			{
				"id":9,
				"name":"电子",
				"type":1
			},
			{
				"id":3,
				"name":"摇滚",
				"type":1
			},
			{
				"id":5,
				"name":"爵士",
				"type":1
			},
			{
				"id":12,
				"name":"轻音乐",
				"type":1
			},
			{
				"id":1,
				"name":"嘻哈",
				"type":1
			},
			{
				"id":22,
				"name":"儿童",
				"type":1
			},
			{
				"id":20,
				"name":"乡村",
				"type":1
			},
			{
				"id":21,
				"name":"古典",
				"type":1
			},
			{
				"id":8,
				"name":"拉丁",
				"type":1
			},
			{
				"id":18,
				"name":"金属",
				"type":1
			}
		]
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/music/styles/rollingList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1'
Request parameters
Parameter Description

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

风格列表

data.list[].id

Number

风格ID

data.list[].name

String

风格名称

data.list[].type

Number

风格层级 ，1:1级，2:2级

2. 读物

2.1. 专辑

2.1.1. search

URL /reading/album/search

说明： 搜索专辑

Curl request
$ curl 'http://localhost:8080/reading/albums/search?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=0FC557A617FE524EEBBBA305861CA859&keyword=%E5%91%A8%E6%9D%B0%E4%BC%A6&page=1&pageSize=1' -i
HTTP request
GET /reading/albums/search?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=0FC557A617FE524EEBBBA305861CA859&keyword=%E5%91%A8%E6%9D%B0%E4%BC%A6&page=1&pageSize=1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 761

{
	"code":200,
	"data":{
		"list":[
			{
				"artist":{
					"id":18040563,
					"logo":"http://fdfs.xmcdn.com/group27/M04/A5/5C/wKgJW1kXFeay8IuVAADQqF4_224011_web_large.jpg",
					"name":"周杰伦粉丝频道"
				},
				"canDownload":true,
				"id":345837,
				"largeLogo":"http://fdfs.xmcdn.com/group13/M0B/13/3D/wKgDXlVq6njyRjtDAABrW6udgXo389_mobile_large.jpg",
				"mediumLogo":"http://fdfs.xmcdn.com/group13/M0B/13/3D/wKgDXlVq6njyRjtDAABrW6udgXo389_mobile_meduim.jpg",
				"smallLogo":"http://fdfs.xmcdn.com/group13/M0B/13/3D/wKgDXlVq6njyRjtDAABrW6udgXo389_mobile_small.jpg",
				"title":"周杰伦粉丝电台",
				"updateTime":1514886212000
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":27,
			"totalPage":27
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/reading/albums/search?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=0FC557A617FE524EEBBBA305861CA859&keyword=%E5%91%A8%E6%9D%B0%E4%BC%A6&page=1&pageSize=1'
Request parameters
Parameter Description

keyword

搜索关键字

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].canDownload

Boolean

是否能下载，true/false

data.list[].id

Number

专辑ID

data.list[].largeLogo

String

大图

data.list[].mediumLogo

String

中图

data.list[].smallLogo

String

小图

data.list[].title

String

标题

data.list[].updateTime

Number

更新时间

data.list[].artist

Object

主播信息

data.list[].artist.id

Number

主播ID

data.list[].artist.logo

String

主播图片LOGO

data.list[].artist.name

String

主播名称

data.page

Object

分页信息

data.page.page

Number

请求页码

data.page.pageSize

Number

每页显示条数

data.page.total

Number

总记录数

data.page.totalPage

Number

总页数

2.1.2. daily

URL /reading/albums/daily

说明 ：每日推荐专辑

Curl request
$ curl 'http://localhost:8080/reading/albums/daily?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5&page=1&pageSize=1' -i
HTTP request
GET /reading/albums/daily?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5&page=1&pageSize=1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 767

{
	"code":200,
	"data":{
		"list":[
			{
				"artist":{
					"id":1266964,
					"logo":"http://fdfs.xmcdn.com/group21/M05/6A/3E/wKgJLVh1KQPCRU05AAK4JTj5zPc807_web_large.jpg",
					"name":"有声的紫襟"
				},
				"canDownload":true,
				"id":12642314,
				"largeLogo":"http://fdfs.xmcdn.com/group39/M06/01/19/wKgJnlphjGuwslJPAAGfGRV4Y-o110_mobile_large.jpg",
				"mediumLogo":"http://fdfs.xmcdn.com/group39/M06/01/19/wKgJnlphjGuwslJPAAGfGRV4Y-o110_mobile_meduim.jpg",
				"smallLogo":"http://fdfs.xmcdn.com/group39/M06/01/19/wKgJnlphjGuwslJPAAGfGRV4Y-o110_mobile_small.jpg",
				"title":"《阴间神探》紫襟故事",
				"updateTime":1529921004000
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":220,
			"totalPage":220
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/reading/albums/daily?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5&page=1&pageSize=1'
Request parameters
Parameter Description

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].canDownload

Boolean

是否能下载，true/false

data.list[].id

Number

专辑ID

data.list[].largeLogo

String

大图

data.list[].mediumLogo

String

中图

data.list[].smallLogo

String

小图

data.list[].title

String

标题

data.list[].updateTime

Number

更新时间

data.list[].artist

Object

主播信息

data.list[].artist.id

Number

主播ID

data.list[].artist.logo

String

主播图片LOGO

data.list[].artist.name

String

主播名称

data.page

Object

分页信息

data.page.page

Number

请求页码

data.page.pageSize

Number

每页显示条数

data.page.total

Number

总记录数

data.page.totalPage

Number

总页数

2.1.3. trackList

URL /reading/albums/trackList

说明：专辑声音列表

Request parameters

2.1.4. detail

URL /reading/albums/detail

说明：专辑详情

Curl request
$ curl 'http://localhost:8080/reading/albums/detail?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=B810F3057E8456E5CE7CB3BC38A8C995&id=6108936' -i
HTTP request
GET /reading/albums/detail?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=B810F3057E8456E5CE7CB3BC38A8C995&id=6108936 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 628

{
	"code":200,
	"data":{
		"artist":{
			"id":30495264,
			"logo":"http://fdfs.xmcdn.com/group14/M02/93/D1/wKgDZFdg7RfwA-bwAAGbZ7LSgRU189_web_large.jpg",
			"name":"喜马拉雅资讯日历"
		},
		"canDownload":true,
		"id":6108936,
		"largeLogo":"http://fdfs.xmcdn.com/group32/M0A/F2/8B/wKgJnFnDV8qg57OAAADPwZ1BZqU198_mobile_large.jpg",
		"mediumLogo":"http://fdfs.xmcdn.com/group32/M0A/F2/8B/wKgJnFnDV8qg57OAAADPwZ1BZqU198_mobile_meduim.jpg",
		"smallLogo":"http://fdfs.xmcdn.com/group32/M0A/F2/8B/wKgJnFnDV8qg57OAAADPwZ1BZqU198_mobile_small.jpg",
		"title":"滚动头条",
		"updateTime":1529921260000
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/reading/albums/detail?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=B810F3057E8456E5CE7CB3BC38A8C995&id=6108936'
Request parameters
Parameter Description

id

专辑ID

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.canDownload

Boolean

是否能下载，true/false

data.id

Number

专辑ID

data.largeLogo

String

大图

data.mediumLogo

String

中图

data.smallLogo

String

小图

data.title

String

标题

data.updateTime

Number

更新时间

data.artist

Object

主播信息

data.artist.id

Number

主播ID

data.artist.logo

String

主播图片LOGO

data.artist.name

String

主播名称

2.1.5. guessLike

URL /reading/albums/guessLike

说明：猜你喜欢（专辑列表）

Curl request
$ curl 'http://localhost:8080/reading/albums/guessLike?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5&page=1&pageSize=1' -i
HTTP request
GET /reading/albums/guessLike?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5&page=1&pageSize=1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 763

{
	"code":200,
	"data":{
		"list":[
			{
				"artist":{
					"id":1266964,
					"logo":"http://fdfs.xmcdn.com/group21/M05/6A/3E/wKgJLVh1KQPCRU05AAK4JTj5zPc807_web_large.jpg",
					"name":"有声的紫襟"
				},
				"canDownload":true,
				"id":12642314,
				"largeLogo":"http://fdfs.xmcdn.com/group39/M06/01/19/wKgJnlphjGuwslJPAAGfGRV4Y-o110_mobile_large.jpg",
				"mediumLogo":"http://fdfs.xmcdn.com/group39/M06/01/19/wKgJnlphjGuwslJPAAGfGRV4Y-o110_mobile_meduim.jpg",
				"smallLogo":"http://fdfs.xmcdn.com/group39/M06/01/19/wKgJnlphjGuwslJPAAGfGRV4Y-o110_mobile_small.jpg",
				"title":"《阴间神探》紫襟故事",
				"updateTime":1529664891000
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":1,
			"totalPage":1
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/reading/albums/guessLike?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5&page=1&pageSize=1'
Request parameters
Parameter Description

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].canDownload

Boolean

是否能下载，true/false

data.list[].id

Number

专辑ID

data.list[].largeLogo

String

大图

data.list[].mediumLogo

String

中图

data.list[].smallLogo

String

小图

data.list[].title

String

标题

data.list[].updateTime

Number

更新时间

data.list[].artist

Object

主播信息

data.list[].artist.id

Number

主播ID

data.list[].artist.logo

String

主播图片LOGO

data.list[].artist.name

String

主播名称

data.page

Object

分页信息

data.page.page

Number

请求页码

data.page.pageSize

Number

每页显示条数

data.page.total

Number

总记录数

data.page.totalPage

Number

总页数

2.2. 分类

2.2.1. list

URL /reading/categorys/list

说明 ：分类列表

Curl request
$ curl 'http://localhost:8080/reading/categorys/list?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1' -i
HTTP request
GET /reading/categorys/list?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 1505

{
	"code":200,
	"data":{
		"list":[
			{
				"id":3,
				"name":"有声书"
			},
			{
				"id":2,
				"name":"音乐"
			},
			{
				"id":4,
				"name":"娱乐"
			},
			{
				"id":12,
				"name":"相声评书"
			},
			{
				"id":6,
				"name":"儿童"
			},
			{
				"id":29,
				"name":"3D体验馆"
			},
			{
				"id":1,
				"name":"资讯"
			},
			{
				"id":28,
				"name":"脱口秀"
			},
			{
				"id":10,
				"name":"情感生活"
			},
			{
				"id":9,
				"name":"历史"
			},
			{
				"id":39,
				"name":"人文"
			},
			{
				"id":38,
				"name":"英语"
			},
			{
				"id":32,
				"name":"小语种"
			},
			{
				"id":13,
				"name":"教育培训"
			},
			{
				"id":15,
				"name":"广播剧"
			},
			{
				"id":16,
				"name":"戏曲"
			},
			{
				"id":40,
				"name":"国学书院"
			},
			{
				"id":17,
				"name":"电台"
			},
			{
				"id":8,
				"name":"商业财经"
			},
			{
				"id":18,
				"name":"IT科技"
			},
			{
				"id":7,
				"name":"健康养生"
			},
			{
				"id":22,
				"name":"旅游"
			},
			{
				"id":21,
				"name":"汽车"
			},
			{
				"id":24,
				"name":"动漫游戏"
			},
			{
				"id":23,
				"name":"电影"
			},
			{
				"id":41,
				"name":"党课随身听"
			},
			{
				"id":30,
				"name":"名校公开课"
			},
			{
				"id":31,
				"name":"时尚生活"
			},
			{
				"id":34,
				"name":"诗歌"
			},
			{
				"id":46,
				"name":"畅销书"
			},
			{
				"id":11,
				"name":"其他"
			}
		]
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/reading/categorys/list?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1'
Request parameters
Parameter Description

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].id

Number

分类ID

data.list[].name

String

分类名称

2.2.2. rollingList

URL /reading/categorys/rollingList

说明：转盘分类列表

Curl request
$ curl 'http://localhost:8080/reading/categorys/rollingList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1' -i
HTTP request
GET /reading/categorys/rollingList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 609

{
	"code":200,
	"data":{
		"list":[
			{
				"id":3,
				"name":"有声书"
			},
			{
				"id":12,
				"name":"相声评书"
			},
			{
				"id":4,
				"name":"娱乐"
			},
			{
				"id":1,
				"name":"资讯"
			},
			{
				"id":28,
				"name":"脱口秀"
			},
			{
				"id":9,
				"name":"历史"
			},
			{
				"id":38,
				"name":"英语"
			},
			{
				"id":8,
				"name":"商业财经"
			},
			{
				"id":21,
				"name":"汽车"
			},
			{
				"id":7,
				"name":"健康养生"
			},
			{
				"id":46,
				"name":"畅销书"
			},
			{
				"id":6,
				"name":"儿童"
			}
		]
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/reading/categorys/rollingList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1'
Request parameters
Parameter Description

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].id

Number

分类ID

data.list[].name

String

分类名称

2.2.3. trackList

URL /reading/categorys/trackList

说明 ：分类声音列表

Curl request
$ curl 'http://localhost:8080/reading/categorys/trackList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=DD523DC38DA96F624595FB1E309FAF4E&categoryId=1&page=1&pageSize=1' -i
HTTP request
GET /reading/categorys/trackList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=DD523DC38DA96F624595FB1E309FAF4E&categoryId=1&page=1&pageSize=1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 970

{
	"code":200,
	"data":{
		"list":[
			{
				"artist":{
					"id":52622741,
					"logo":"http://fdfs.xmcdn.com/group20/M05/19/EA/wKgJJ1eDW1_QCA5MAABNXnIlT3I433_web_large.png",
					"name":"东方网"
				},
				"canDownload":true,
				"duration":387,
				"id":49918385,
				"largeLogo":"http://fdfs.xmcdn.com/group19/M03/19/FE/wKgJK1eDXl7AR__9AAFbNixU8BI570_mobile_large.jpg",
				"listenUrl":"http://download.xmcdn.com/group33/M02/40/A3/wKgJnVmwijqh-Q4xABJS9rHZPBU883.m4a",
				"mediumLogo":"http://fdfs.xmcdn.com/group19/M03/19/FE/wKgJK1eDXl7AR__9AAFbNixU8BI570_web_large.jpg",
				"orderNum":292,
				"smallLogo":"http://fdfs.xmcdn.com/group19/M03/19/FE/wKgJK1eDXl7AR__9AAFbNixU8BI570_web_meduim.jpg",
				"title":"扑朔迷离？双方各执一词，产妇坠亡背后的真相是什么|新闻早餐 2017.9.7 星期四",
				"updateTime":1504741946000
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":1000,
			"totalPage":1000
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/reading/categorys/trackList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=DD523DC38DA96F624595FB1E309FAF4E&categoryId=1&page=1&pageSize=1'
Request parameters
Parameter Description

categoryId

分类ID

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].canDownload

Boolean

是否可以下载,true/false

data.list[].duration

Number

时长

data.list[].id

Number

声音ID

data.list[].largeLogo

String

大图

data.list[].mediumLogo

String

中图

data.list[].smallLogo

String

小图

data.list[].listenUrl

String

试听链接

data.list[].orderNum

Number

排序值

data.list[].title

String

标题

data.list[].updateTime

Number

更新时间

data.list[].artist

Object

主播信息

data.list[].artist.id

Number

主播ID

data.list[].artist.logo

String

主播图片LOGO

data.list[].artist.name

String

主播名称

data.page

Object

分页信息

data.page.page

Number

请求页码

data.page.pageSize

Number

每页显示条数

data.page.total

Number

总记录数

data.page.totalPage

Number

总页数

2.3. 榜单

2.3.1. totalAlbumList

URL /reading/ranks/totalAlbumList

说明：总榜专辑列表

Curl request
$ curl 'http://localhost:8080/reading/ranks/totalAlbumList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5&page=1&pageSize=1' -i
HTTP request
GET /reading/ranks/totalAlbumList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5&page=1&pageSize=1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 745

{
	"code":200,
	"data":{
		"list":[
			{
				"artist":{
					"id":102403331,
					"logo":"http://fdfs.xmcdn.com/group31/M05/AE/BC/wKgJSVpVWEehNz2YAABUGZUcTNw947_web_large.jpg",
					"name":"封面新闻"
				},
				"canDownload":true,
				"id":12580785,
				"largeLogo":"http://fdfs.xmcdn.com/group33/M02/85/08/wKgJTFpcaUCS86jcAADx8I4Z1Fs369_mobile_large.jpg",
				"mediumLogo":"http://fdfs.xmcdn.com/group33/M02/85/08/wKgJTFpcaUCS86jcAADx8I4Z1Fs369_mobile_meduim.jpg",
				"smallLogo":"http://fdfs.xmcdn.com/group33/M02/85/08/wKgJTFpcaUCS86jcAADx8I4Z1Fs369_mobile_small.jpg",
				"title":"鲜快报",
				"updateTime":1529673742000
			}
		],
		"page":{
			"page":1,
			"pageSize":1,
			"total":100,
			"totalPage":100
		}
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/reading/ranks/totalAlbumList?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=E712B38109DDBC8318CAFC60B6C79FF5&page=1&pageSize=1'
Request parameters
Parameter Description

page

请求页码，默认为1

pageSize

每页显示条数，默认为20

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].canDownload

Boolean

是否能下载，true/false

data.list[].id

Number

专辑ID

data.list[].largeLogo

String

大图

data.list[].mediumLogo

String

中图

data.list[].smallLogo

String

小图

data.list[].title

String

标题

data.list[].updateTime

Number

更新时间

data.list[].artist

Object

主播信息

data.list[].artist.id

Number

主播ID

data.list[].artist.logo

String

主播图片LOGO

data.list[].artist.name

String

主播名称

data.page

Object

分页信息

data.page.page

Number

请求页码

data.page.pageSize

Number

每页显示条数

data.page.total

Number

总记录数

data.page.totalPage

Number

总页数

2.4. 搜索

2.4.1. suggest

URL /reading/search/suggest

说明： 搜索联想词

Curl request
$ curl 'http://localhost:8080/reading/search/suggest?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=1D29A041464FF441B31C34387DF8C89B&keyword=%E5%91%A8%E6%9D%B0%E4%BC%A6' -i
HTTP request
GET /reading/search/suggest?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=1D29A041464FF441B31C34387DF8C89B&keyword=%E5%91%A8%E6%9D%B0%E4%BC%A6 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 100

{
	"code":200,
	"data":{
		"list":[
			{
				"tip":"周杰伦歌曲"
			}
		]
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/reading/search/suggest?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=1D29A041464FF441B31C34387DF8C89B&keyword=%E5%91%A8%E6%9D%B0%E4%BC%A6'
Request parameters
Parameter Description

keyword

搜索关键字

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].tip

String

提示语

2.4.2. hotwords

URL /reading/search/hotwords

说明： 搜索热词

Curl request
$ curl 'http://localhost:8080/reading/search/hotwords?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1' -i
HTTP request
GET /reading/search/hotwords?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1 HTTP/1.1
Host: localhost:8080
HTTP response
HTTP/1.1 200 OK
X-Application-Context: xp-media-boot:-1
Content-Type: application/json;charset=UTF-8
Content-Length: 737

{
	"code":200,
	"data":{
		"list":[
			{
				"word":"马未都"
			},
			{
				"word":"湖畔大学"
			},
			{
				"word":"摸金天师"
			},
			{
				"word":"凯叔讲故事"
			},
			{
				"word":"吴晓波"
			},
			{
				"word":"李阳"
			},
			{
				"word":"商业财经"
			},
			{
				"word":"历史"
			},
			{
				"word":"陈志武金融课"
			},
			{
				"word":"清华肖星财务课"
			},
			{
				"word":"黄健翔聊国足"
			},
			{
				"word":"声音报告"
			},
			{
				"word":"趣读消费心理学"
			},
			{
				"word":"晓说2017"
			},
			{
				"word":"“大力”史"
			},
			{
				"word":"陈默"
			},
			{
				"word":"麻衣神算"
			},
			{
				"word":"秦朔书院"
			}
		]
	},
	"msg":"success"
}
HTTPie request
$ http GET 'http://localhost:8080/reading/search/hotwords?appId=xmart%3Aappid%3A002&timestamp=2018-05-25+11%3A11%3A11&sign=8A597263FA1151C246BF25D823446EE1'
Request parameters
Parameter Description

appId

分配给调用方的appId

timestamp

时间戳，格式为yyyy-MM-dd HH:mm:ss

sign

签名串
Response fields
Path Type Description

msg

String

提示信息

code

Number

返回信息码

data

Object

返回数据

data.list

Array

数据列表

data.list[].word

String

热语