@TOC
更新
2020/6/03
- 接口已恢复。感谢蒟蒻…的帮助, 才能这么快解决这个问题。有兴趣可以查看他的关于sign获取的文章
之前分出了ts的分支,主要开始维护ts分支,master可能会更新的晚一点,如果需要自己启服务的话可以下载ts分支,有问题也可以回复,我可以协助一下。
2020/5/27
发现获取vkey的接口现在获取不到了,应该是官方换了请求方式,目前播放地址受到了影响,无法播放,修复时间待定。
2020/5/7
之前要使用api的话只能通过服务端请求,嗯嗯..想了想,现在支持跨域了。还是仅测试使用,服务器太渣渣。。经不起造。
2020/2/25
最近在做新的项目,叫小鱼干APP,可以在百度,vivo,小米,apple store 中下载,暂时没有时间来搞这个音乐api的东西了,不过服务没有停,如果想用来测试或者玩玩的还是可以用的。
2019/12/26
- 获取歌曲播放地址接口 增加 lyric参数代表是否获取歌词。
- 增加获取歌词接口
2019/12/24
- 所有音乐接口更改,增加一层music/ ,获取地址改为 music/song
- 增加福利图片接口
- 示例接口更改为https
接口仅供交流学习使用
因为之前使用网络上别人封装的音乐api现在无法使用,或者一些需要付费使用,当然这也无可厚非。
但对我而言,只需要简单的一些音乐api做一些东西。 感觉给钱有点亏。 就自己搞一个简单的符合我的需求的吧。
文档
- 音乐搜索
- 音乐top100列表
- 音乐播放地址
- 福利图片 (新增 2019/12/24).
- 音乐歌词 (新增 2019/12/26).
很简单的三个基本的功能。
所有方法都是GET
本项目所支持的Api
一、音乐 music
1、音乐列表
list
GET
参数 | 类型 | 描述 |
---|---|---|
p | string | 页码 |
n | string | 数目 |
w | string | 关键词 |
返回参数
上级 | 参数 | 类型 | 描述 |
---|---|---|---|
— | curpage | int | 页码 |
— | curnum | int | 数目 |
— | list | array [ object ] | 音乐列表 |
list > {} | songname | string | 歌曲名 |
list > {} | songname | string | 歌曲名 |
list > {} | albumname | string | 专辑名 |
list > {} | songmid | string | 歌曲id,用来请求播放地址 |
list > {} | albumimg | string | 封面图 |
list > {} | singer | object | 歌手信息 |
list > {} > singer | id | int | 歌手id |
list > {} > singer | name | string | 歌手名称 |
eg:
1 | https://api.zsfmyz.top/music/list?p=1&n=30&w=蔡徐坤 |
返回参数举例
1 | { |
2、音乐top100列表
top
GET
参数
无
返回参数
上级 | 参数 | 类型 | 描述 |
---|---|---|---|
— | date | string | 日期 |
— | curpage | int | 页码 |
— | curnum | int | 数目 |
— | list | — | 音乐列表 |
— | list | array [ object ] | 音乐列表 |
list > {} | songname | string | 歌曲名 |
list > {} | songname | string | 歌曲名 |
list > {} | albumname | string | 专辑名 |
list > {} | songmid | string | 歌曲id,用来请求播放地址 |
list > {} | albumimg | string | 封面图 |
list > {} | singer | object | 歌手信息 |
list > {} > singer | id | int | 歌手id |
list > {} > singer | name | string | 歌手名称 |
— | topinfo | — | 音乐top100信息 |
list中歌曲信息比普通列表多了排名: cur_count
eg:
1 | https://api.zsfmyz.top/music/top |
返回参数举例
1 | { |
3、音乐播放地址
song
GET
参数 | 类型 | 描述 |
---|---|---|
songmid | string | 用于获取token |
guid | string | 用于获取token |
lyric | string | 默认为0不获取歌词,1获取歌词 |
其他参数固定
返回参数
参数 | 类型 | 描述 |
---|---|---|
musicUrl | string | 音乐播放地址 |
eg:
1 | https://api.zsfmyz.top/music/song?songmid=000aWBBQ2fMyBJ&guid=126548448 |
返回参数举例
1 | { |
4、音乐歌词
lyric
GET
参数 | 类型 | 描述 |
---|---|---|
songmid | string | 用于获取歌词 |
其他参数固定
返回参数
参数 | 类型 | 描述 |
---|---|---|
lyric | string | 歌词内容 |
eg:
1 | https://api.zsfmyz.top/music/lyric?songmid=000wocYU11tSzS |
返回参数举例
1 | { |
二、福利图片 welfare
根据每日福利社的接口进行了封装,因为他们的https失效了,所以自己反向代理了。
1、图片列表
list
GET
参数 | 类型 | 描述 |
---|---|---|
per_page | string | 每页数据量 |
page | string | 第几页 |
其他参数固定
返回参数
如下:
eg:
1 | https://api.zsfmyz.top/welfare/list?per_page=20&page=2 |
返回参数举例
1 | { |
over 暂时只有这 ~~ 三 ~~ 四个,不过做一个音乐demo足够了,有兴趣的话可以试试。
http://api.zsfmyz.top/ https://api.zsfmyz.top/ 是目前开放的api接口地址,可直接食用。
原接口说明
搜索
封面
- http://imgcache.qq.com/music/photo/album_300/[albumid%100]/300_albumpic_[albumid]_0.jpg, albumid%100, albumid
- 比如albumid=8217,封面地址就是
- http://imgcache.qq.com/music/photo/album_300/17/300_albumpic_8217_0.jpg。
歌曲token
此方法需要参考本文开头说明中的 2020/6/03 更新中的说明的获取sign的文章再获取token
- songmid可以从歌曲信息中取到,filename根据songmid生成。
- 比如,songmid是003lghpv0jfFXG,则filename就是前缀加上C400,后缀加上.m4a,即C400003lghpv0jfFXG.m4a。
其他字段format、platform、cid、guid可以写死,但都是必须的。
拼接播放地址
以下是我根据此api所写的服务的项目地址,大家可以拿来测试体验。