我扒下了某音乐的 ????????????

吃着火锅, 写着代码, 听着歌一不小心某音乐就上市了. 趁着兴头扒了一套 api (极简, 可用, 从获取排行榜到歌曲播放 url). 现共享一下接口文档. 大家玩儿的开心. :smile:

本项目项目地址 github

接口域名

music.niubishanshan.top

basePath

/api/music

1. 获取首页推荐信息

1.1 功能描述

获取网站首页的推荐信息, 包含顶部轮播和广播

1.2 请求说明

请求说明:

请求方式 GET

请求URL ：/recommend

1.3 请求参数

1.4 返回结果

{
    "errno": 0,
    "msg": "success",
    "data": {
        "slider": [
            "http://y.gtimg.cn/music/common/upload/MUSIC_FOCUS/1111137.jpg",
            "http://y.gtimg.cn/music/common/upload/MUSIC_FOCUS/1109397.jpg",
            "http://y.gtimg.cn/music/common/upload/MUSIC_FOCUS/1109234.jpg",
            "http://y.gtimg.cn/music/common/upload/MUSIC_FOCUS/1109139.jpg",
            "http://y.gtimg.cn/music/common/upload/MUSIC_FOCUS/1110553.jpg"
        ],
        "radioList": [
            {
                "picUrl": "http://y.gtimg.cn/music/photo/radio/track_radio_199_13_1.jpg",
                "title": "热歌",
                "id": 199
            },
            {
                "picUrl": "http://y.gtimg.cn/music/photo/radio/track_radio_307_13_1.jpg",
                "title": "一人一首招牌歌",
                "id": 307
            }
        ]
    }
}
复制代码

1.5 返回参数

1.6 错误状态码

代码健壮的像一头牛, 不会报错~

2. 获取排行榜信息

2.1 功能描述

获取排行榜数据, 获取到的是从各种维度获取的排行版歌单(比如周榜, 月榜...)

2.2 请求说明

请求说明:

请求方式 GET

请求URL ：/toplist

2.3 请求参数

2.4 返回结果

{
    "errno": 0,
    "msg": "success",
    "data": [
        {
            "id": 4,
            "title": "巅峰榜·流行指数",
            "listenCount": 19500000,
            "picUrl": "http://y.gtimg.cn/music/photo_new/T003R300x300M000000VjrhC1PVxWS.jpg",
            "songList": [
                {
                    "singername": "薛之谦",
                    "songname": "天份",
                    "number": 1
                },
                {
                    "singername": "陈柯宇",
                    "songname": "生僻字",
                    "number": 2
                },
                {
                    "singername": "毛不易",
                    "songname": "别再闹了",
                    "number": 3
                }
            ]
        }
        ... 各种数据 ...
    ]
}
复制代码

2.5 返回参数

2.6 错误状态码

代码健壮的像一头牛, 不会报错~

3. 获取首页推荐信息

3.1 功能描述

获取指定歌单中的曲目列表

3.2 请求说明

请求说明:

请求方式 GET

请求URL ： /songIdlist/{:songListId}

3.3 请求参数

3.4 返回结果

{
    "errno": 0,
    "msg": "success",
    "data": {
        "update_time": "2018-12-24",
        "total_song_num": 100,
        "topinfo": {
            "pic_album": "http://imgcache.qq.com/music/photo_new/T002R300x300M000004KfMU92CZeAd.jpg",
            "ListName": "巅峰榜·流行指数"
        },
        "songlist": [
            {
                "songmid": "000Qepff3UyUWO",
                "singer": "薛之谦",
                "songname": "天份"
            },
           ...各种数据...
        ]
    }
}
复制代码

3.5 返回参数

3.6 错误状态码

代码健壮的像一头牛, 不会报错~

4. 获取首页推荐信息

4.1 功能描述

获取网站首页的推荐信息, 包含顶部轮播和广播

4.2 请求说明

请求说明:

请求方式 GET

请求URL ： /songUrllist/{:songIdList}

4.3 请求参数

4.4 返回结果

{
    "errno": 0,
    "msg": "success",
    "data": [
        "http://isure.stream.qqmusic.qq.com//C400000Qepff3UyUWO.m4a?guid=5579254314&vkey=70D5522DDF8F35B36B133AA0F85A9C2FA608F2FA85BCBB4EC31CC6A0047CEAB873E9E2B947A6D893C219C65781B9EFE1F00C583518290F4E&uin=0&fromtag=38",
        "http://isure.stream.qqmusic.qq.com//C400001KxFBr3ZrMIk.m4a?guid=5579254314&vkey=7DC202D78758D601A1EF4B15F5597A805C740CFCE9210870073D05247716E83D4146EE3907962645D2F7BE99071BFC0B01E73F09AFA5114D&uin=0&fromtag=38"
    ]
}
复制代码