官网提供API
说明:此API主要针对移动端直接调用QQ音乐API用,API只能在QQAPP内执行,上线时间尚短。
http://y.qq.com/m/api/api.html
自己分析的API
说明:
根据官网https://y.qq.com/分析的API,经过测试,可以使用,测试demo如下,demo流程
1、首先根据关键字搜索歌曲》获取播放key》获取播放地址播放
http://192.168.60.50:8081/shiro/public/music
经分析,也可不用获取播放key,先分类,排行榜》获取歌曲》获取单曲播放地址播放
自己分析api的优缺点
优点:API可直接js跨域直接调用,也可java二次封装,以restful方式提供出去,灵活方便
缺点:API有些参数不明确,接口更新变动情况不明,根据以前来看,2015年的接口,到现在基本可用。
以下的自己分析的部分api以及其他资源
获取热词列表
https://c.y.qq.com/splcloud/fcgi-bin/gethotkey.fcg?g_tk=5381&jsonpCallback=hotSearchKeysmod_top_search&loginUin=0&hostUin=0&format=jsonp&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0
获取版本更新日志
说明:版本更新说明
示例:
https://y.qq.com/download/download.js?loginUin=0&hostUin=0&format=json&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0
根据关键字搜索歌曲
地址:https://c.y.qq.com/soso/fcgi-bin/client_search_cp
说明:根据关键字搜索返回歌曲列表、专辑、歌手等信息
主要参数:
w:关键字
p:页码,从1开始
n:当前页的数据条数
示例:
https://c.y.qq.com/soso/fcgi-bin/client_search_cp?ct=24&qqmusic_ver=1298&new_json=1&remoteplace=txt.yqq.center&searchid=37602803789127241&t=0&aggr=1&cr=1&catZhida=1&lossless=0&flag_qc=0&p=1&n=20&w=%E5%88%98%E5%BE%B7%E5%8D%8E&g_tk=5381&loginUin=0&hostUin=0&format=json&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0
根据专辑搜索歌曲
地址:https://c.y.qq.com/v8/fcg-bin/fcg_v8_album_info_cp.fcg
说明:根据专辑ID搜索歌曲
主要参数:
albummid:专辑ID
示例:
https://c.y.qq.com/v8/fcg-bin/fcg_v8_album_info_cp.fcg?albummid=002LiyZW27dGjC&g_tk=5381&loginUin=0&hostUin=0&format=json&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0
排行榜分类
https://c.y.qq.com/v8/fcg-bin/fcg_v8_toplist_opt.fcg?page=index&format=html&tpl=macv4&v8debug=1&jsonCallback=jsonCallback
参数说明:
page=index 表示这是排行榜的首页
format=html 返回格式是html
debug:debug=1为调试模式,直接返回跨域json格式,其他值直接返回html页面
jsonCallback:此参数可有可无
此接口不能直接返回json格式,只能返回jsonp格式
返回数据格式是jsonp,可直接用jquery调用此接口回去数据
//JQuery JSONP Support
varurl = "http://192.168.0.103:12075/api/test.aspx?id=1&callback=?";
jQuery.getJSON(url, function(data){
// 处理返回的json 数据
alert("name:" + data.name+ ", Price:" +data.price);
});
专辑图片
90x90的小图
https://y.gtimg.cn/music/photo_new/T002R90x90M0000032gbwN4J7f7c.jpg?max_age=2592000
300x300的大图
https://y.gtimg.cn/music/photo_new/T002R300x300M0000032gbwN4J7f7c.jpg?max_age=2592000
专辑图片文件名解析
T002R:未知
300x300或90x90:图片大小
M000:未知
0032gbwN4J7f7c:专辑ID
.jpg:图片后缀
获取排行榜前多少条歌曲
主要参数:
date:查询日期
如果排行榜是按天统计,日期统计到昨天,格式为“2017-09-12”
如果排行榜是按周统计,统计到上周的星期四,格式为“2017_36”,标示2017年的第36周
具体怎么取,主要取“排行榜分类”接口返回的“update_key”字段值
song_begin:歌曲开始标记,从0开始
song_num:歌曲数量
topid:排行榜ID
https://c.y.qq.com/v8/fcg-bin/fcg_v8_toplist_cp.fcg?tpl=3&page=detail&date=2017-09-12&topid=4&type=top&song_begin=0&song_num=30&g_tk=5381&jsonpCallback=MusicJsonCallbacktoplist&loginUin=0&hostUin=0&format=jsonp&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0
获取key
地址:https://c.y.qq.com/base/fcgi-bin/fcg_musicexpress.fcg
说明:此API获取的KEY暂时没用到,猜测可能是已经过期的API
主要参数:guid:随机数,按一定规则生成,具体参考“guid生成规则”
示例:https://c.y.qq.com/base/fcgi-bin/fcg_musicexpress.fcg?json=3&guid=8383045540&g_tk=5381&loginUin=0&hostUin=0&format=json&inCharset=utf8&outCharset=GB2312¬ice=0&platform=yqq&needNewCode=0
获取vkey
地址:https://c.y.qq.com/base/fcgi-bin/fcg_music_express_mobile3.fcg
说明:获取播放音乐的vkey,关键API
主要参数:
guid:随机数
songmid:歌曲ID
filename:歌曲文件名,按一定规则生成,具体参考:“歌曲文件名生成规则”
示例:
https://c.y.qq.com/base/fcgi-bin/fcg_music_express_mobile3.fcg?g_tk=5381 &loginUin=0&hostUin=0&format=json&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0&cid=205361747&uin=0&songmid=001Qu4I30eVFYb&filename=C400001Qu4I30eVFYb.m4a&guid=8383045540
获取单曲播放地址
https://c.y.qq.com/v8/fcg-bin/fcg_play_single_song.fcg?songmid=004gPqc32etVgm&tpl=yqq_song_detail&format=jsonp&callback=getOneSongInfoCallback&g_tk=5381&jsonpCallback=getOneSongInfoCallback&loginUin=0&hostUin=0&format=jsonp&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0
主要参数:
songmid:歌曲id
获取热门包含此歌曲的热门歌单
https://c.y.qq.com/rcmusic/fcgi-bin/fcg_iphone_music_rec_songlist?jsonpCallback=musicRecSongListCallback&cid=338&ct=20&songid=5110311&uin=10000&p=0.3702123376466666&g_tk=5381&jsonpCallback=musicRecSongListCallback&loginUin=0&hostUin=0&format=jsonp&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0
播放歌曲
地址:http://dl.stream.qqmusic.qq.com/歌曲文件名
说明:实际上是带上vkey的文件路径,可放在html5音频标签中播放
主要参数:
vkey:通过“获取vkey”API,取得
guid:按一定规则生成
fromtag:不知道是怎么取得,目前取固定值66,取得以后存一个cookie(名称为qqmusic_fromtag)
示例:
http://dl.stream.qqmusic.qq.com/C400003OUlho2HcRHC.m4a?vkey=49B4DE20FEE0838FF6DBD07FE9925236361D5660C24BADBA91618A7D69A99F4F3754DE863CD187FD360A659795B5817D46B9D5B6C60E0782&guid=8383045540&uin=0&fromtag=66
无返回值,打开链接直接播放
获取专辑简介
https://c.y.qq.com/v8/fcg-bin/fcg_v8_album_info_cp.fcg?albummid=0032gbwN4J7f7c&g_tk=5381&jsonpCallback=getAlbumInfoCallback&loginUin=0&hostUin=0&format=jsonp&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0
获取歌曲MV信息
https://c.y.qq.com/qzone/fcg-bin/fcg_mv_getinfo_bysongid.fcg?utf8=1&mids=0021SIVy2hJFCT&uin=10000&p=0.26223891580381453&g_tk=5381&jsonpCallback=JsonCallback&loginUin=0&hostUin=0&format=jsonp&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0
mids:歌曲的ID(songmid)
返回信息:
JsonCallback({"code":0,"reportcode":0,"subcode":0,"num":1,"mvlist":[{"songmid":"0021SIVy2hJFCT","songid":203785058,"mvid":1364014,"mvvid":"t0024qgbzmj"}]})
获取歌词
https://c.y.qq.com/lyric/fcgi-bin/fcg_query_lyric.fcg?nobase64=1&musicid=203785058&callback=jsonp1&g_tk=5381&jsonpCallback=jsonp1&loginUin=0&hostUin=0&format=jsonp&inCharset=utf8&outCharset=utf-8¬ice=0&platform=yqq&needNewCode=0
主要参数:
musicid:歌曲ID(songid)
此API已经不能正常调用,这里可用另外一个API,返回XML格式数据
http://music.qq.com/miniportal/static/lyric/10/4900010.xml
4900010为歌曲ID
10为歌曲ID%100的值
guid生成规则
function getGuid() {
var t = (newDate).getUTCMilliseconds();
return _guid = Math.round(2147483647 * Math.random()) * t % 1e10;
}
guid为设置为cookie,获取guid的时候首先从cookie中获取,此cookie过期时间为2038年
document.cookie ="pgv_pvid=" + guid + "; Expires=Sun, 18 Jan 2038 00:00:00 GMT;PATH=/;";
歌曲文件名生成规则
说明:c100、c200、c300、c400为固定值,测试用的是c400;.m4a是歌曲文件名后缀
C100+歌曲ID+.m4a
C200+歌曲ID+.m4a
C300+歌曲ID+.m4a
C400+歌曲ID+.m4a
其他接口略,可在官网实时抓取。。。。。。。。。。。。。。。。。。。。。。。。。。。。
其他相关资料
播放核心JS
https://y.gtimg.cn/music/portal/js/common/pkg/player_module_b5739d0.js
新歌榜:http://music.qq.com/musicbox/shop/v3/data/hit/hit_newsong.js
总榜:http://music.qq.com/musicbox/shop/v3/data/hit/hit_all.js
总结
QQ在线音乐前端采用的nodejs,所有会看到很多这样的代码
这里面的路径是相对路径,路径前缀为
https://y.gtimg.cn/music/portal/
便于分析源码