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

栏目: ASP.NET · 发布时间: 5年前

内容简介:吃着火锅, 写着代码, 听着歌一不小心某音乐就上市了. 趁着兴头扒了一套 api (极简, 可用, 从获取排行榜到歌曲播放 url). 现共享一下接口文档. 大家玩儿的开心. :smile:获取网站首页的推荐信息, 包含顶部轮播和广播

吃着火锅, 写着代码, 听着歌一不小心某音乐就上市了. 趁着兴头扒了一套 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 返回参数

字段 字段类型 字段说明
errno int 0: 表示没有问题, 其他表示有问题. 详情参考 msg
msg string 接口返回状态描述
data object 接口返回数据主体
slider array 轮播图信息(子条目为 string)
radioList array 电台列表数据(始终返回两条)
picUrl string 电台logo
title string 电台标题
id ing 电台id

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 返回参数

字段 字段类型 字段说明
errno int 0: 表示没有问题, 其他表示有问题. 详情参考 msg
msg string 接口返回状态描述
data array 接口返回数据主体
id int 歌单id
title string 歌单标题
listenCount int 歌单播放次数
picUrl string 歌单logo
songList array 歌单中排行榜前三的曲目
singername string 歌手名称
songname string 歌曲名称
number int 排行

2.6 错误状态码

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

3. 获取首页推荐信息

3.1 功能描述

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

3.2 请求说明

请求说明:

请求方式 GET

请求URL : /songIdlist/{:songListId}

3.3 请求参数

字段 字段类型 字段说明
songListId string 歌单id, 就是排行榜中获取的歌单条目的id字段. 用于指定用户选择的歌单

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 返回参数

字段 字段类型 字段说明
errno int 0: 表示没有问题, 其他表示有问题. 详情参考 msg
msg string 接口返回状态描述
data object 接口返回数据主体
update_time string 更新时间
total_song_num int 歌单中歌曲数目
topinfo object 歌单信息
pic_album string 歌单封面logo
ListName string 歌单名称
songlist array 歌曲列表
songmid string 歌曲id
singer string 歌手名称
songname string 歌曲名称

3.6 错误状态码

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

4. 获取首页推荐信息

4.1 功能描述

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

4.2 请求说明

请求说明:

请求方式 GET

请求URL : /songUrllist/{:songIdList}

4.3 请求参数

字段 字段类型 字段说明
songIdList stringArray 歌曲 id 列表, 需要拼接成 id1,id2,id3,id4 的形式

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"
    ]
}
复制代码

以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

面向对象分析与设计

面向对象分析与设计

Grady Booch、Robert A. Maksimchuk、Michael W. Engel、Bobbi J. Young、Jim Conallen、Kelli A. Houston / 王海鹏、潘加宇 / 人民邮电出版社 / 2009-8 / 79.00元

《面向对象分析与设计(第3版)》是UML创始人Grady Booch的代表作之一,书中介绍的概念都基于牢固的理论基础。同时,《面向对象分析与设计(第3版)》又是一本注重实效的书,面向架构师和软件开发者等软件工程实践者的实际需要。《面向对象分析与设计(第3版)》通过大量例子说明了基本概念,解释了方法,并展示了在不同领域的成功应用。全书分为理论和应用两部分。理论部分深刻剖析了面向对象分析与设计(OOA......一起来看看 《面向对象分析与设计》 这本书的介绍吧!

随机密码生成器
随机密码生成器

多种字符组合密码

Base64 编码/解码
Base64 编码/解码

Base64 编码/解码

SHA 加密
SHA 加密

SHA 加密工具