Skip to content

Commit da1668b

Browse files
committed
feat(接口): 添加 获取更多音乐版本 接口,#29
1 parent 4b43ff9 commit da1668b

File tree

4 files changed

+225
-149
lines changed

4 files changed

+225
-149
lines changed

README.md

+75-74
Original file line numberDiff line numberDiff line change
@@ -156,80 +156,81 @@ $ $Env:HOST=127.0.0.1; npm run dev
156156
40. 获取歌手和专辑图片
157157
41. 获取歌手图片
158158
42. 获取音乐相关信息
159-
43. 获取音乐详情
160-
44. 获取音乐专辑/歌手信息
161-
45. 私人 FM(对应手机和 pc 端的猜你喜欢)
162-
46. banner
163-
47. 乐库 banner
164-
48. 乐库电台
165-
49. 乐库
166-
50. 电台 - 推荐
167-
51. 电台
168-
52. 电台 - 图片
169-
53. 电台 - 音乐列表
170-
54. 编辑精选
171-
55. 编辑精选数据
172-
56. 编辑精选歌单
173-
57. 编辑精选专区
174-
58. 编辑精选专区详情
175-
59. 领取 VIP(需要登陆,该接口为测试接口)
176-
60. 获取歌手列表
177-
61. 获取歌手详情
178-
62. 获取歌手专辑
179-
63. 获取歌手单曲
180-
64. 获取歌手 MV
181-
65. 获取视频 url
182-
66. 获取歌曲 MV
183-
67. 获取视频相关信息
184-
68. 获取视频详情
185-
69. 新歌速递
186-
70. 场景音乐列表
187-
71. 场景音乐详情
188-
72. 获取场景音乐讨论区
189-
73. 获取场景音乐模块 Tag
190-
74. 获取场景音乐歌单列表
191-
75. 获取场景音乐视频列表
192-
76. 获取场景音乐音乐列表
193-
77. 每日推荐
194-
78. 历史推荐
195-
79. 风格推荐
196-
80. 排行列表
197-
81. 排行榜推荐列表
198-
82. 排行榜往期列表
199-
83. 排行榜信息
200-
84. 排行榜歌曲列表
201-
85. 歌曲评论
202-
86. 歌曲评论-根据分类返回
203-
87. 歌曲评论-根据热词返回
204-
88. 楼层评论
205-
89. 歌单评论
206-
90. 专辑评论
207-
91. 歌曲曲谱
208-
92. 曲谱详情
209-
93. 推荐曲谱
210-
94. 曲谱合集
211-
95. 曲谱合集详情
212-
96. 提交听歌历史
213-
97. 获取服务器时间
214-
98. 刷刷
215-
99. AI 推荐
216-
100. 频道 - 获取用户所有频道
217-
101. 频道 - 详情
218-
102. 频道 - 频道安利
219-
103. 频道 - 相似频道
220-
104. 频道 - 订阅
221-
105. 频道 - 音乐故事
222-
106. 频道 - 音乐故事详情
223-
107. 动态 - 最常访问
224-
108. 获取用户公开的音乐
225-
109. 听书 - 每日推荐
226-
110. 听书 - 排行榜推荐
227-
111. 听书 - VIP 推荐
228-
112. 听书 - 每周推荐
229-
113. 听书 - 专辑详情
230-
114. 听书 - 专辑音乐列表
231-
115. 歌曲详情 - 歌曲成绩单
232-
116. 歌曲详情 - 歌曲成绩单详情
159+
43. 获取更多音乐版本
160+
44. 获取音乐详情
161+
45. 获取音乐专辑/歌手信息
162+
46. 私人 FM(对应手机和 pc 端的猜你喜欢)
163+
47. banner
164+
48. 乐库 banner
165+
49. 乐库电台
166+
50. 乐库
167+
51. 电台 - 推荐
168+
52. 电台
169+
53. 电台 - 图片
170+
54. 电台 - 音乐列表
171+
55. 编辑精选
172+
56. 编辑精选数据
173+
57. 编辑精选歌单
174+
58. 编辑精选专区
175+
59. 编辑精选专区详情
176+
60. 领取 VIP(需要登陆,该接口为测试接口)
177+
61. 获取歌手列表
178+
62. 获取歌手详情
179+
63. 获取歌手专辑
180+
64. 获取歌手单曲
181+
65. 获取歌手 MV
182+
66. 获取视频 url
183+
67. 获取歌曲 MV
184+
68. 获取视频相关信息
185+
69. 获取视频详情
186+
70. 新歌速递
187+
71. 场景音乐列表
188+
72. 场景音乐详情
189+
73. 获取场景音乐讨论区
190+
74. 获取场景音乐模块 Tag
191+
75. 获取场景音乐歌单列表
192+
76. 获取场景音乐视频列表
193+
77. 获取场景音乐音乐列表
194+
78. 每日推荐
195+
79. 历史推荐
196+
80. 风格推荐
197+
81. 排行列表
198+
82. 排行榜推荐列表
199+
83. 排行榜往期列表
200+
84. 排行榜信息
201+
85. 排行榜歌曲列表
202+
86. 歌曲评论
203+
87. 歌曲评论-根据分类返回
204+
88. 歌曲评论-根据热词返回
205+
89. 楼层评论
206+
90. 歌单评论
207+
91. 专辑评论
208+
92. 歌曲曲谱
209+
93. 曲谱详情
210+
94. 推荐曲谱
211+
95. 曲谱合集
212+
96. 曲谱合集详情
213+
97. 提交听歌历史
214+
98. 获取服务器时间
215+
99. 刷刷
216+
100. AI 推荐
217+
101. 频道 - 获取用户所有频道
218+
102. 频道 - 详情
219+
103. 频道 - 频道安利
220+
104. 频道 - 相似频道
221+
105. 频道 - 订阅
222+
106. 频道 - 音乐故事
223+
107. 频道 - 音乐故事详情
224+
108. 动态 - 最常访问
225+
109. 获取用户公开的音乐
226+
110. 听书 - 每日推荐
227+
111. 听书 - 排行榜推荐
228+
112. 听书 - VIP 推荐
229+
113. 听书 - 每周推荐
230+
114. 听书 - 专辑详情
231+
115. 听书 - 专辑音乐列表
232+
116. 歌曲详情 - 歌曲成绩单
233+
117. 歌曲详情 - 歌曲成绩单详情
233234

234235
## License
235236

docs/README.md

+103-74
Original file line numberDiff line numberDiff line change
@@ -69,80 +69,81 @@
6969
40. [`获取歌手和专辑图片`](#获取歌手和专辑图片)
7070
41. [`获取歌手图片`](#获取歌手图片)
7171
42. [`获取音乐相关信息`](#获取音乐相关信息)
72-
43. [`获取音乐详情`](#获取音乐详情)
73-
44. [`获取音乐专辑/歌手信息`](#获取音乐专辑/歌手信息)
74-
45. [`私人 FM(对应手机和 pc 端的猜你喜欢)`](#私人-fm对应手机和-pc-端的猜你喜欢)
75-
46. [`banner`](#banner)
76-
47. [`乐库 banner`](#乐库-banner)
77-
48. [`乐库电台`](#乐库电台)
78-
49. [`乐库`](#乐库)
79-
50. [`电台 - 推荐`](#电台-推荐)
80-
51. [`电台`](#电台)
81-
52. [`电台 - 图片`](#电台-图片)
82-
53. [`电台 - 音乐列表`](#电台-音乐列表)
83-
54. [`编辑精选`](#编辑精选)
84-
55. [`编辑精选数据`](#编辑精选数据)
85-
56. [`编辑精选歌单`](#编辑精选歌单)
86-
57. [`编辑精选专区`](#编辑精选专区)
87-
58. [`编辑精选专区详情`](#编辑精选专区详情)
88-
59. [`领取 VIP(需要登陆,该接口为测试接口)`](#领取-vip需要登陆该接口为测试接口)
89-
60. [`获取歌手列表`](#获取歌手列表)
90-
61. [`获取歌手详情`](#获取歌手详情)
91-
62. [`获取歌手专辑`](#获取歌手专辑)
92-
63. [`获取歌手单曲`](#获取歌手单曲)
93-
64. [`获取歌手 MV`](#获取歌手-MV)
94-
65. [`获取视频 url`](#获取视频-ur)
95-
66. [`获取歌曲 MV`](#获取歌曲-MV)
96-
67. [`获取视频相关信息`](#获取视频相关信息)
97-
68. [`获取视频详情`](#获取视频详情)
98-
69. [`新歌速递`](#新歌速递)
99-
70. [`场景音乐列表`](#场景音乐列表)
100-
71. [`场景音乐详情`](#场景音乐详情)
101-
72. [`获取场景音乐讨论区`](#获取场景音乐讨论区)
102-
73. [`获取场景音乐模块 Tag`](#获取场景音乐模块)
103-
74. [`获取场景音乐歌单列表`](#获取场景音乐歌单列表)
104-
75. [`获取场景音乐视频列表`](#获取场景音乐视频列表)
105-
76. [`获取场景音乐音乐列表`](#获取场景音乐音乐列表)
106-
77. [`每日推荐`](#每日推荐)
107-
78. [`历史推荐`](#历史推荐)
108-
79. [`风格推荐`](#风格推荐)
109-
80. [`排行列表`](#排行列表)
110-
81. [`排行榜推荐列表`](#排行榜推荐列表)
111-
82. [`排行榜往期列表`](#排行榜往期列表)
112-
83. [`排行榜信息`](#排行榜信息)
113-
84. [`排行榜歌曲列表`](#排行榜歌曲列表)
114-
85. [`歌曲评论`](#歌曲评论)
115-
86. [`歌曲评论-根据分类返回`](#歌曲评论-根据分类返回)
116-
87. [`歌曲评论-根据热词返回`](#歌曲评论-根据热词返回)
117-
88. [`楼层评论`](#楼层评论)
118-
89. [`歌单评论`](#歌单评论)
119-
90. [`专辑评论`](#专辑评论)
120-
91. [`歌曲曲谱`](#歌曲曲谱)
121-
92. [`曲谱详情`](#曲谱详情)
122-
93. [`推荐曲谱`](#推荐曲谱)
123-
94. [`曲谱合集`](#曲谱合集)
124-
95. [`曲谱合集详情`](#曲谱合集详情)
125-
96. [`提交听歌历史`](#提交听歌历史)
126-
97. [`获取服务器时间`](#获取服务器时间)
127-
98. [`刷刷`](#刷刷)
128-
99. [`AI 推荐`](#ai-推荐)
129-
100. [`频道 - 获取用户所有频道`](#频道-获取用户所有频道)
130-
101. [`频道 - 详情`](#频道---详情)
131-
102. [`频道 - 频道安利`](#频道-频道安利)
132-
103. [`频道 - 相似频道`](#频道-相似频道)
133-
104. [`频道 - 订阅`](#频道-订阅)
134-
105. [`频道 - 音乐故事`](#频道-音乐故事)
135-
106. [`频道 - 音乐故事详情`](#频道-音乐故事详情)
136-
107. [`动态 - 最常访问`](#动态-最常访问)
137-
108. [`获取用户公开的音乐`](#获取用户公开的音乐)
138-
109. [`听书 - 每日推荐`](#听书-每日推荐)
139-
110. [`听书 - 排行榜推荐`](#听书-排行榜推荐)
140-
111. [`听书 - VIP 推荐`](#听书-vip-推荐)
141-
112. [`听书 - 每周推荐`](#听书-每周推荐)
142-
113. [`听书 - 专辑详情`](#听书-专辑详情)
143-
114. [`听书 - 专辑音乐列表`](#听书-专辑音乐列表)
144-
115. [`歌曲详情 - 歌曲成绩单`](#歌曲详情-歌曲成绩单)
145-
116. [`歌曲详情 - 歌曲成绩单详情`](#歌曲详情---歌曲成绩单详情)
72+
43. [`获取更多音乐版本`](#获取更多音乐版本)
73+
44. [`获取音乐详情`](#获取音乐详情)
74+
45. [`获取音乐专辑/歌手信息`](#获取音乐专辑/歌手信息)
75+
46. [`私人 FM(对应手机和 pc 端的猜你喜欢)`](#私人-fm对应手机和-pc-端的猜你喜欢)
76+
47. [`banner`](#banner)
77+
48. [`乐库 banner`](#乐库-banner)
78+
49. [`乐库电台`](#乐库电台)
79+
50. [`乐库`](#乐库)
80+
51. [`电台 - 推荐`](#电台-推荐)
81+
52. [`电台`](#电台)
82+
53. [`电台 - 图片`](#电台-图片)
83+
54. [`电台 - 音乐列表`](#电台-音乐列表)
84+
55. [`编辑精选`](#编辑精选)
85+
56. [`编辑精选数据`](#编辑精选数据)
86+
57. [`编辑精选歌单`](#编辑精选歌单)
87+
58. [`编辑精选专区`](#编辑精选专区)
88+
59. [`编辑精选专区详情`](#编辑精选专区详情)
89+
60. [`领取 VIP(需要登陆,该接口为测试接口)`](#领取-vip需要登陆该接口为测试接口)
90+
61. [`获取歌手列表`](#获取歌手列表)
91+
62. [`获取歌手详情`](#获取歌手详情)
92+
63. [`获取歌手专辑`](#获取歌手专辑)
93+
64. [`获取歌手单曲`](#获取歌手单曲)
94+
65. [`获取歌手 MV`](#获取歌手-MV)
95+
66. [`获取视频 url`](#获取视频-ur)
96+
67. [`获取歌曲 MV`](#获取歌曲-MV)
97+
68. [`获取视频相关信息`](#获取视频相关信息)
98+
69. [`获取视频详情`](#获取视频详情)
99+
70. [`新歌速递`](#新歌速递)
100+
71. [`场景音乐列表`](#场景音乐列表)
101+
72. [`场景音乐详情`](#场景音乐详情)
102+
73. [`获取场景音乐讨论区`](#获取场景音乐讨论区)
103+
74. [`获取场景音乐模块 Tag`](#获取场景音乐模块)
104+
75. [`获取场景音乐歌单列表`](#获取场景音乐歌单列表)
105+
76. [`获取场景音乐视频列表`](#获取场景音乐视频列表)
106+
77. [`获取场景音乐音乐列表`](#获取场景音乐音乐列表)
107+
78. [`每日推荐`](#每日推荐)
108+
79. [`历史推荐`](#历史推荐)
109+
80. [`风格推荐`](#风格推荐)
110+
81. [`排行列表`](#排行列表)
111+
82. [`排行榜推荐列表`](#排行榜推荐列表)
112+
83. [`排行榜往期列表`](#排行榜往期列表)
113+
84. [`排行榜信息`](#排行榜信息)
114+
85. [`排行榜歌曲列表`](#排行榜歌曲列表)
115+
86. [`歌曲评论`](#歌曲评论)
116+
87. [`歌曲评论-根据分类返回`](#歌曲评论-根据分类返回)
117+
88. [`歌曲评论-根据热词返回`](#歌曲评论-根据热词返回)
118+
89. [`楼层评论`](#楼层评论)
119+
90. [`歌单评论`](#歌单评论)
120+
91. [`专辑评论`](#专辑评论)
121+
92. [`歌曲曲谱`](#歌曲曲谱)
122+
93. [`曲谱详情`](#曲谱详情)
123+
94. [`推荐曲谱`](#推荐曲谱)
124+
95. [`曲谱合集`](#曲谱合集)
125+
96. [`曲谱合集详情`](#曲谱合集详情)
126+
97. [`提交听歌历史`](#提交听歌历史)
127+
98. [`获取服务器时间`](#获取服务器时间)
128+
99. [`刷刷`](#刷刷)
129+
100. [`AI 推荐`](#ai-推荐)
130+
101. [`频道 - 获取用户所有频道`](#频道-获取用户所有频道)
131+
102. [`频道 - 详情`](#频道---详情)
132+
103. [`频道 - 频道安利`](#频道-频道安利)
133+
104. [`频道 - 相似频道`](#频道-相似频道)
134+
105. [`频道 - 订阅`](#频道-订阅)
135+
106. [`频道 - 音乐故事`](#频道-音乐故事)
136+
107. [`频道 - 音乐故事详情`](#频道-音乐故事详情)
137+
108. [`动态 - 最常访问`](#动态-最常访问)
138+
109. [`获取用户公开的音乐`](#获取用户公开的音乐)
139+
110. [`听书 - 每日推荐`](#听书-每日推荐)
140+
111. [`听书 - 排行榜推荐`](#听书-排行榜推荐)
141+
112. [`听书 - VIP 推荐`](#听书-vip-推荐)
142+
113. [`听书 - 每周推荐`](#听书-每周推荐)
143+
114. [`听书 - 专辑详情`](#听书-专辑详情)
144+
115. [`听书 - 专辑音乐列表`](#听书-专辑音乐列表)
145+
116. [`歌曲详情 - 歌曲成绩单`](#歌曲详情-歌曲成绩单)
146+
117. [`歌曲详情 - 歌曲成绩单详情`](#歌曲详情---歌曲成绩单详情)
146147

147148
### 安装
148149

@@ -251,6 +252,8 @@ $ set HOST=127.0.0.1 && npm run dev
251252

252253
#### 更新记录
253254

255+
24-08-09:添加 获取更多音乐版本 接口。
256+
254257
24-07-22:添加 `歌曲详情` 接口.
255258

256259
24-07-17: 添加 搜索建议 接口。
@@ -1030,6 +1033,32 @@ vip 专属推荐
10301033

10311034
**调用例子:** `/audio?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE` `/audio?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE,55603312694BF99AD6000C2D0D72D368`
10321035

1036+
### 获取更多音乐版本
1037+
1038+
说明:调用此接口,可以获取更多版本音乐
1039+
1040+
**必选参数:**
1041+
1042+
`album_audio_id`:音乐的 mixsongid/album_audio_id
1043+
1044+
**可选参数:**
1045+
1046+
`page`: 页码
1047+
1048+
`pagesize`: 每页页数, 默认为 30
1049+
1050+
`show_type`:是否返回分类
1051+
1052+
`sort`:排序,支持 `all``hot``new`
1053+
1054+
`type`: 分类
1055+
1056+
`show_detail`:是否返回详情,否则只返回总数,0:只返回总数,不传或者其他都返回详情
1057+
1058+
**接口地址:** `/audio/related`
1059+
1060+
**调用例子:** `/audio/related?album_audio_id=573120919` `/audio/related?album_audio_id=573120919&show_detail=0`
1061+
10331062
### 获取音乐详情
10341063

10351064
说明:调用此接口,可以获取音乐详情

0 commit comments

Comments
 (0)