All Projects → jsososo → Qqmusicapi

jsososo / Qqmusicapi

Licence: gpl-3.0
基于 Express + Axios 的 QQ音乐接口 nodejs 版

Programming Languages

javascript
184084 projects - #8 most used programming language

Projects that are alternatives of or similar to Qqmusicapi

Video.github.io
🎬视频网站项目已实现功能: 首页导航栏,中部轮播图,以及电影列表的展现,底部导航链接 注册页面 视频播放页面 搜索页面 登录页面 用户管理页面 一键安装 电影抓取 等功能。基于NodeJS的Express框架开发的动态网站项目,下面也提供了本程序的相关演示站点。
Stars: ✭ 413 (-18.38%)
Mutual labels:  express
Inversify Express Utils
Some utilities for the development of Express application with InversifyJS
Stars: ✭ 454 (-10.28%)
Mutual labels:  express
Ueditor
📝 UEditor 官方支持的版本有PHP JSP ASP .NET. ueditor for nodejs 可以让你的UEditor支持node.js
Stars: ✭ 493 (-2.57%)
Mutual labels:  express
Any Rule
🦕 常用正则大全, 支持web / vscode / idea / Alfred Workflow多平台
Stars: ✭ 5,708 (+1028.06%)
Mutual labels:  express
Hackernews React Graphql
Hacker News clone rewritten with universal JavaScript, using React and GraphQL.
Stars: ✭ 4,242 (+738.34%)
Mutual labels:  express
Social Network
Mini social network that I made as my first web app project.
Stars: ✭ 458 (-9.49%)
Mutual labels:  express
Serverless Express
Run Node.js web applications and APIs using existing application frameworks on AWS #serverless technologies such as Lambda, API Gateway, Lambda@Edge, and ALB.
Stars: ✭ 4,265 (+742.89%)
Mutual labels:  express
Open Api
A Monorepo of various packages to power OpenAPI in node
Stars: ✭ 497 (-1.78%)
Mutual labels:  express
Express Jwt Permissions
🚦 Express middleware for JWT permissions
Stars: ✭ 444 (-12.25%)
Mutual labels:  express
Nestjs
A collection of badass modules and utilities to help you level up your NestJS applications 🚀
Stars: ✭ 475 (-6.13%)
Mutual labels:  express
Meantorrent
meanTorrent - MEAN.JS BitTorrent Private Tracker - Full-Stack JavaScript Using MongoDB, Express, AngularJS, and Node.js, A BitTorrent Private Tracker CMS with Multilingual, and IRC announce support, CloudFlare support. Demo at:
Stars: ✭ 438 (-13.44%)
Mutual labels:  express
Create Graphql
Command-line utility to build production-ready servers with GraphQL.
Stars: ✭ 441 (-12.85%)
Mutual labels:  express
Api Design Node V3
[Course] API design in Node with Express v3
Stars: ✭ 459 (-9.29%)
Mutual labels:  express
Vue2 blog
使用vue2.x + vue-cli +vue-router+ vuex + axios + mysql + express + pm2 + webpack+nginx构建的具有登录,注册,留言,用户发帖,用户评论等功能的SPA Blog。注意,注意,注意,后端API全部自己手写,很适合刚学习vue以及express的小伙伴学习,喜欢请Star鼓励一下我,谢谢!项目预览:
Stars: ✭ 417 (-17.59%)
Mutual labels:  express
Mern Crud
A simple records system using MongoDB, Express.js, React.js, and Node.js with real-time CRUD operations using Socket.io
Stars: ✭ 493 (-2.57%)
Mutual labels:  express
Forms Angular
Probably the most opinionated framework in the world
Stars: ✭ 412 (-18.58%)
Mutual labels:  express
Kite
🌴 Kite 前台页面是vue ssr服务端渲染、后台页面是react spa、服务层nodejs express、mysql编写的一套多权限文章、动态管理系统
Stars: ✭ 455 (-10.08%)
Mutual labels:  express
Opine
Fast, minimalist web framework for Deno ported from ExpressJS.
Stars: ✭ 506 (+0%)
Mutual labels:  express
Passport Magic Login
Passwordless authentication with magic links for Passport.js.
Stars: ✭ 493 (-2.57%)
Mutual labels:  express
Fullstack Javascript Architecture
✍️ Opinionated project architecture for Full-Stack JavaScript Applications.
Stars: ✭ 464 (-8.3%)
Mutual labels:  express

QQMusicApi

这是一个基于 Express + Axios 的 Nodejs 项目,一切仅供学习参考,该支持的还是要支持的,不然杰伦喝不起奶茶了。

其实有点点嫌弃qq音乐接口的数据格式,所以会对部分接口返回做一些处理,但是考虑到一些之前扒过接口的项目,有些人可能还是喜欢原汁原味, 可以在接口处增加一个参数 raw=1

对于所有处理过的返回数据,都会包含 result100 表示成功,500 表示穿参错误,400 为 node 捕获的未知异常,301 表示缺少用户登陆的 cookie

关于如何在服务器上存储 cookie,可以查看接口 设置用户Cookie

灵感来源:Binaryify/NeteaseCloudMusicApi

Start

$ git clone [email protected]:jsososo/QQMusicApi.git

$ npm install

$ npm start

项目默认端口为 3300,默认qq号 1234567 (设置Cookie),可以通过修改 bin/config.js 或设置启动参数 PORT=3400 QQ=7654321 npm start

如果使用的是微信号,则将 bin/config.js 中的 qq好改为 wxuin,具体数值可以在网页版qq音乐的 cookie 中获取

如果需要启用数据统计、ip拦截等,可以将 bin/config.js 中的 useDataStatistics 设为 true (会存在直接拦截部分来自其他后台的请求)

在线接口测试网址:http://api.qq.jsososo.com

用前须知

!> 公用 cookie 的形式会存在封号风险,因此现在默认取消了公用 cookie 方法,望注意

!> 该项目仅做接口转发,部分接口通过修改 Referer 实现,所有数据均不做存储处理,大家还是理性的保护好自己的个人信息,谨防诈骗

!> QQ音乐登陆的这个问题还是难绕过去,目前还是需要登陆并手动获取 https://y.qq.comcookie,注入网站或node, 如果又什么更好的解决办法,欢迎大家提 pr 给我

!> 另,可以通过 qqmusic-cookie-porter 这个 chrome 插件半自动获取 cookie

!> 本项目仅供学习使用,请尊重版权,请勿利用此项目从事商业行为! 本项目仅供学习使用,请尊重版权,请勿利用此项目从事商业行为! 本项目仅供学习使用,请尊重版权,请勿利用此项目从事商业行为!

!> 接口仅作为测试或者方便听歌使用,发现有人使用其他服务大量的调用接口导致服务经常性挂掉重启,所以加入了ip检测和黑白名单机制, 想用的童鞋请自行clone走项目启动,我也没钱升级我的服务器了!!

常见问题

1、为什么无法获取音乐链接等?

请确保已正确添加绿钻账号 Cookie 信息,具体操作可以查看 设置用户cookie,检测是否设置成功可以查看 查看当前cookie

2、为什么返回了 自己起一个 node 服务 这么难??? 或 被加入了黑名单 ?

第一个,服务默认禁止了一些明显来源于爬虫的接口,可以将 util/dataStatistics.js 中相关代码注释重启, 如果短时大量请求会被拉入黑名单,可以通过移除黑名单、加入白名单,或者干脆在 app.js 里注释 dataHandle 相关代码

更新记录

21-02-10 🦛 修复部分歌手页面报错 & 增加歌手名字获取

21-02-09 🍡 修复日推歌单 & 部分歌手详情格式问题

21-01-19 🐙 优化404报错

21-01-17 🐊 优化获取链接接口报错提示

21-01-06:🎄 底层格式修改,方便 electron 整合调用

20-12-15:❄️ 修复歌曲链接失效

20-08-03:😲 支持微信登录

20-08-03:🕶️ 部分接口增加缓存策略

20-07-14 修改了因图标导致的无法部署

20-06-24:🍑 获取用户创建歌单接口出错

20-05-21:🍇 新增推荐 banner、url 支持重定向、配置化启动

20-04-23:🎢 修复高品音质获取失败问题

20-04-18:📖 写死的参数替换

20-04-14:🚎 日推

20-04-07:🍰 接口记录问题

20-03-30:🌸 收藏歌单操作,获取用户收藏的歌单/专辑

20-03-22:🍃 去除 cookie 中 uin 的其他字母

20-02-15:👍 新增评论操作相关接口

20-02-01:🥤 新增多个歌单操作相关接口

20-01-31:🐑 配合 chrome 插件自动获取存储 cookie

20-01-30:🍲 增加快速搜索接口、歌单、专辑、歌单、mv的评论获取

20-01-19:😢 issue#9

20-01-17:👑 更新歌曲链接的域名ip

20-01-09:🦈 反馈

20-01-07:🔫 歌单搜索接口修改

19-12-23:🦑 排行榜相关接口优化、新增相似歌曲、相关歌单、相关mv

19-12-18:🍒 批量获取歌曲信息、top排行榜数据优化

19-12-11:🚀 高频ip黑白名单

19-12-05:🏎️ 获取 mp3 和无损 ape、flac 等格式链接

19-11-14:🐄 排行榜

19-10-29:🐝 搜索歌手,专辑信息查询

19-10-15:👖 url 获取

19-10-10:🤬 热搜词、关注歌手、关注粉丝列表

19-09-23:🏊 歌单、mv 的分类获取

19-09-21:🚢 新增 MV 信息、根据分类筛选歌手、新碟推荐、新 MV 推荐

19-09-20:🐬 支持在线测试

19-09-20:🐫 新增 mv 接口,返回结果优化

19-09-19:🙀 评论、推荐、歌手接口

19-09-18:🐧 init

公用参数说明

!> 非常重要,特别是和登陆 cookie 有关的参数

1、raw 前面提到的,默认为 0, 如果传了非0参数,则表示使用原汁原味的数据结构

2、ownCookie 默认为 0,使用服务器上预存的 cookie 信息, 非0表示使用浏览器传过来的 cookie,如果不使用的话,部分接口会遇到 301, 如果该用户非 vip,也无法获取大部分歌曲的播放链接,我自己会不定时的更新这个服务器上(api.qq.jsososo.com)的 cookie作为登陆用户

接口文档

vkey & guid 获取(已废弃,直接看下个接口)

19-10-11,因为企鹅音乐修改了对音乐播放链接的获取,因此这个接口已没有意义,获取播放链接的参考下面的接口

先介绍 vkey 和 guid 的获取,因为这是拼凑音乐链接的关键,也是播放音乐的核心一步

接口:/vkey

返回示例:

{
  "data": {
    "vkey": "78159670DE0BF35ABEF86841070FDA6818BC95FB25E5C983547E9D29C9803D30971A3500E2D85D5204848BDC4E3E130BE9FCC63EB73F0F47",
    "guid": "5339940689",
    "domain": "http://ws.stream.qqmusic.qq.com/"
  },
  "result": 100,
  "success": true
}

下面是不同格式的音乐对应的 url 拼接,可稳定获取128k的播放链接,但是高品质会被403,还在摸索中。。。

// content 参数里面的文件类型可以用在下载的时候,后端将歌曲转成流,并标注返回的类型(content)
const formatMap = {
          size128: {
            val: '128k',
            s: 'M500',
            e: '.mp3',
            content: 'audio/mpeg',
          },
          size320: {
            val: '320k',
            s: 'M800',
            e: '.mp3',
            content: 'audio/mpeg',
          },
          sizeape: {
            val: '无损ape',
            s: 'A000',
            e: '.ape',
            content: 'audio/ape',
          },
          sizeflac: {
            val: '无损flac',
            s: 'F000',
            e: '.flac',
            content: 'audio/x-flac',
          }
        }
      }
const format = 'size320';
const { s, e } = formatMap[format];

// 注意是 strMediaMid 不是 songid, 也不是 songmid,付费歌曲的strMediaMid 和 songmid 不同,非付费歌曲相同
const url = `${domain}${s}${strMediaMid}${e}?guid=${guid}&vkey=${vkey}&fromtag=8&uin=0`

播放链接

接口:/song/urls

参数:

id: 歌曲的 songmid,必填,多个用逗号分割,该接口可用 postget

并不是所有的音乐都能获取到播放链接,如果是未登陆或非 vip 用户的 cookie,只能获取到非 vip 用户可听的歌曲, 其他像一些必须要购买数字专辑才能收听的歌曲,如果未购买也是无法获取的,无法获取到的播放链接则不会在返回的对象中出现, 这点需要大家自己做好兼容,我这里服务器会默认使用自己会员的 cookie,如果需要使用自己的 cookie,请参考上面文档

示例:/song/urls?id=0039MnYb0qxYhV,004Z8Ihr0JIu5s

// 晴天和七里香
{
  "data": {
    "0039MnYb0qxYhV": "http://ws.stream.qqmusic.qq.com/C400002202B43Cq4V4.m4a?guid=2796982635&vkey=0A1ADCEDC042ABE27FE184A3436DBB6F15AFF286F0F06DDFAEA9ADAF2D82F67EF33746A9472F62B444B7E7CEB32EE0D34DFD53A6E2D97D7B&uin=1899&fromtag=66",
    "004Z8Ihr0JIu5s": "http://ws.stream.qqmusic.qq.com/C4000012Ez0a1tFcOI.m4a?guid=2796982635&vkey=DB0E16676C581AE2E762FCA5D32FBB52454EA229C6BD58D9BA2976BA7CC3E49532EA299860E0F219148005848530335ABC254EC7A3374F80&uin=1899&fromtag=66"
  },
  "result": 100
}

下载链接

接口:/song/url

参数:

id: songmid

type: 默认 128 // 128:mp3 128k,320:mp3 320k,m4a:m4a格式 128k,flac:flac格式 无损,ape:ape格式 无损

mediaId: 这个字段为其他接口中返回的 strMediaId 字段,可不传,不传默认同 songmid,但是部分歌曲不传可能会出现能获取到链接,但实际404, 所以有条件的大家都传吧

isRedirect: 默认 0,非 0 时直接重定向到播放链接

这个接口跟上个接口一样,也是依赖服务器的 Cookie 信息的,不支持批量获取,不一定是全部的歌曲都有无损、高品的, 要注意结合 size320,sizeape,sizeflac 等参数先判断下是否有播放链接

示例:/song/url?id=0039MnYb0qxYhV

搜索

搜索

接口:/search

参数:

key: 关键词 必填

pageNo: 页码,默认 1

pageSize: 一页返回数量,默认 20

t: 搜索类型 默认为 0 // 0:单曲,2:歌单,7:歌词,8:专辑,9:歌手,12:mv

示例:/search?key=周杰伦

获取热搜词

接口:/search/hot

示例:/search/hot

返回示例:k 为热搜词,n 为搜索量

{
  "result": 100,
  "data": [
    {
      "k": "PHOENIX 涅槃 ",
      "n": 440301
    },
    {
      "k": "嚣张 ",
      "n": 430912
    },
    ...
  ]
}

快速搜索

接口: /search/quick

key: 关键词 必填

快速给出少量符合条件的歌曲、mv、专辑、歌手

示例:/search/quick?key=周杰伦

查找音乐

单个查找

接口:/song/find

参数:

key: 关键词

这个接口就像是简化版的搜索,根据关键词获取到搜出的第一个歌曲,不过他会直接带上播放链接,参数为 url, 如果没有则表示无法获取到播放链接。这个接口的作用是,对于其他平台的歌单如果需要获取到企鹅音乐的信息时, 可以通过 歌名 + 歌手 + 专辑 等关键词获取大致的歌曲,当然这是并不能保障稳定的。

示例:/song/find?key=周杰伦%2f稻香

批量获取

接口:/song/finds

类型:仅支持post

参数:

data: 对象,key 为歌曲id,value 为搜索关键词

同样,并不是所有传过去的 id 都会有返回,没返回就是没有找到,返回的歌曲也都是会包含播放链接

示例:

anxios({
	url: "/song/finds",
	method: "post",
	data: {
		298838: "笑忘书 王菲",
		abcdefg: "邮差 王菲"
	}
})

// 返回:

{
	data: {
		208838: obj,
		abcdefg: obj,
	},
	result: 100,
}

用户信息

设置用户Cookie

接口:/user/setCookie

参数:

data: 字符串,cookie 信息,格式如下 aaa=bbb; ccc=ddd; ....

该方法仅支持 post 请求,content-type 选择 application/json,同时,当且仅当传入的 cookie 为写配置的 QQ 号(启动参数 或 bin/config.js)时才会 被作为默认的公用 cookie 存储使用,各位在搭建自己的服务时记得修改这里的信。参考如下 设置cookie

查看当前Cookie

接口 /user/cookie

无需参数,共返回两个字段 cookie 为当前网站下的 cookie,userCookie 为服务器公用账号 cookie。

用户主页信息

!> 这个接口是需要登陆 cookie 才能获取的,不然会返回 301,所以如果有误需要考虑一下可能是 cookie 过期

接口:/user/detail

参数:

id: qq号 必填

返回中 mymusic 为喜欢的音乐,mydiss 为用户创建的歌单,需要注意的是,喜欢的音乐中的歌单id为 id,歌单中的歌单id为 dissid

示例:/user/detail?id=123456

用户创建的歌单

接口:/user/songlist

参数:

id: qq号 必填

这个接口比上一个接口更纯粹,只获取创建的歌单,且数据结构更简单,非必须登陆 Cookie,但如果用户未公开主页时,只有本人的 Cookie 才能获取数据

示例:/user/songlist?id=123456

用户收藏的歌单

接口:/user/collect/songlist

参数:

id: qq号,必填,默认取 cookie 中 uin

pageNo: 默认 1

pageSize: 默认 20

示例:/user/collect/songlist?id=123456

用户收藏的专辑

接口:/user/collect/album

参数:

id: qq号,必填,默认取 cookie 中 uin

pageNo: 默认 1

pageSize: 默认 20

示例:/user/collect/album?id=123456

歌单

1、获取歌单详情

接口:/songlist

参数: id: 歌单id 必填

返回说明:

这些表示各种码率对应的文件大小,如果为0则表示该格式的文件不存在

{
  "size128": 1922927,
  "size320": 4803503,
  "sizeape": 10810010,
  "sizeflac": 10827560,
}

示例:/songlist?id=2429907335

2、获取歌单分类

接口:/songlist/category

这个接口没有参数,返回几种类型下的小分类 idname,不同于歌手的筛选,搜索歌单时只能用一个 id,不能用且关系。

示例:/songlist/category

3、根据分类获取歌单

接口:/songlist/list

参数

pageSize: 默认为 20

pageNo: 默认为1

sort: 默认是 5,// 5: 推荐,2: 最新,其他数字的排列值最后都会返回推荐

category: 分类 id,默认 10000000 (全部),其他值从上面的分类接口获取

示例:/songlist/list

4、歌曲id、mid的哈希表

!> 这个接口强制使用浏览器传来的用户 Cookie 信息

接口:/songlist/map

参数:

dirid: 默认 201 我喜欢的歌单

这个接口只能获取用户自己创建的歌单且只会返回歌曲的 id 和 mid 的哈希表,不包含其他数据

5、添加歌曲到歌单

!> 这个接口强制使用浏览器传来的用户 Cookie 信息

接口:/songlist/add

参数:

mid: 歌曲 mid 必填,多个用 , 分割

dirid: 必填

6、从歌单中移除歌曲

!> 这个接口强制使用浏览器传来的用户 Cookie 信息

接口:/songlist/remove

参数:

id: 歌曲 id 必填,多个用 , 分割

dirid: 必填

与上一个添加接口不同,移除需要 id 不是 mid

7、新建歌单

!> 这个接口强制使用浏览器传来的用户 Cookie 信息

接口:/songlist/create

参数:

name: 歌单名,不能为空

如果歌单名重复,也会报错

8、删除歌单

!> 这个接口强制使用浏览器传来的用户 Cookie 信息

接口:/songlist/delete

参数:

dirid: 必填

9、收藏/取消收藏 歌单

!> 这个接口强制使用浏览器传来的用户 Cookie 信息

接口:/songlist/collect

参数:

id: 歌单id 必填

op: 必填 1 收藏;2 取消收藏

歌曲信息

单个获取

接口:/song

参数:

songmid: 必填

这个接口包含了很多的歌曲信息,包括歌手、专辑、语种、曲风等,但是不包含歌词,songinfo.data.track_info.album.mid 为专辑的 mid, 下面为专辑封面图片的路径,在搜索接口中也能获取到这个参数。

`https://y.gtimg.cn/music/photo_new/T002R300x300M000${mid}.jpg`

示例:/song?songmid=0039MnYb0qxYhV

批量获取

接口:/song/batch

参数:

songmids: 必填

这个接口本质为上一个接口的批量调用

示例:/song/batch?songmids=001PLl3C4gPSCI,0039MnYb0qxYhV

相似歌曲

接口:/song/similar

参数:

id: 歌曲 songid 必填

返回相似歌曲列表

示例:/song/similar?id=5105986

相关歌单

接口:/song/playlist

参数:

id: 歌曲 songid 必填

返回相关歌单列表

示例:/song/playlist?id=5105986

相关MV

接口:/song/mv

参数:

id: 歌曲 songid 必填

返回相关mv列表

示例:/song/mv?id=5105986

歌词

接口:/lyric

参数:

songmid: 必填

返回的接口中 lyrictrans 分别是歌词和翻译,转成了base64,这里node进行了解码。

示例:/lyric?songmid=0039MnYb0qxYhV

示例:/lyric?songmid=000b3wiQ3z0VbG

推荐歌单

1、为你推荐歌单

接口:/recommend/playlist/u

这个接口不需要参数,需要注意,和下面这个接口的数据格式不同

示例:/recommend/playlist/u

2、按分类推荐歌单

接口:/recommend/playlist

参数:

id: 分类id,默认为 3317 // 3317: 官方歌单,59:经典,71:情歌,3056:网络歌曲,64:KTV热歌

pageNo: 页码,默认为 1

pageSize: 每页返回数量,默认为 20

示例:/recommend/playlist

3、日推

接口:/recommend/daily

这个接口无需参数,强制使用传进来的 Cookie,返回日推歌单信息

4、轮播图Banner

接口:/recommend/banner

这个接口无需参数,目前仅已知会返回专辑推荐,但是只能获取 albumid,非 albummid

示例:/recommend/banner

最新推荐

1、新歌推荐

接口:/new/songs,

参数:

type: 地区分类,默认为 0 // 0: 最新 1:内地,2:港台,3:欧美,4:韩国,5:日本

ps: 官方的接口其实不是这几个type,但是为了考虑与下面的新专和mv接口做兼容,所以做了改动

示例:/new/songs

2、新碟推荐(专辑)

接口:/new/album

参数:

type: 地区分类,默认为 1 // 1:内地,2:港台,3:欧美,4:韩国,5:日本,6:其他

num: 默认 10

这里和官方接口的参数是一致的

示例:/new/album

3、新 MV 推荐

接口:/new/mv

参数:

type: 类型,默认为 0 // 0: 精选 1:内地,2:港台,3:欧美,4:韩国,5:日本

官方这个参数就更乱了,中英结合,还把日本拼成了 janpan,真是捉鸡

示例:/new/mv

歌手

1、歌手介绍

接口:/singer/desc

参数:

singermid: 必填

获取歌手的一些详细信息介绍

示例:/singer/desc?singermid=0025NhlN2yWrP4

2、获取热门歌曲

接口:/singer/songs

参数:

singermid: 必填

num: 返回歌曲数量

page: 页数 默认为第一页

示例:/singer/songs?singermid=0025NhlN2yWrP4&page=1&num=20

3、获取歌手专辑

接口:/singer/album

参数:

singermid: 必填

pageNo: 默认 1

pageSize: 默认 20

示例:/singer/album?singermid=0025NhlN2yWrP4

4、获取mv

接口:/singer/mv

参数:

singermid: 必填

pageNo: 默认 1

pageSize: 默认 20

示例:/singer/mv?singermid=0025NhlN2yWrP4

5、相似歌手

接口:/singer/sim

参数:

singermid: 必填

官方接口是有返回数量参数的,但是最多只返回10个,所以这里就写死返回 10 个

示例:/singer/sim?singermid=0025NhlN2yWrP4

6、获取歌手分类

接口:/singer/category

这个接口没有参数,会返回 地区:area,类型:genre,首字母:index,性别/组合:sex 这些分类项的各个数据

示例:/singer/category

7、根据分类获取歌手列表

接口:/singer/list

参数:

area: 地区,默认 -100

genre: 风格,默认 -100

index: 首字母,默认 -100

sex: 性别/组合,默认 -100

pageNo: 默认 1

这个接口固定返回 80 条信息

示例:/singer/list

专辑

1、获取专辑信息

接口:/album

参数:

albummid: 必填

示例:/album?albummid=002MAeob3zLXwZ

2、获取专辑内的歌曲

接口:/album/songs

参数:

albummid: 必填

示例:/album/songs?albummid=002MAeob3zLXwZ

评论

1、获取评论

接口:/comment

参数:

id: singid, albumid, tid, topid, vid 必填

pageNo: 默认 1

pageSize: 默认 20

type: 默认 0 // 0:获取最新评论,1:获取热评

biztype: 获取评论类型 1: 歌曲 2: 专辑 3: 歌单 4: 排行榜 5: mv

pageNo 为 1 且 type 为 0 时,会返回15条热评 hot_comment

返回结果说明:ispraise 表示这条评论是否被赞过,1: 是,0: 否;enable_delete 表示这条评论是否能被删除,1: 是,0: 否

上述的判断以 cookie 中的 uin 账号为准

示例:/comment?id=97773

2、发送评论

接口:/comment/send

类型:仅支持 post

该接口需要用户登陆 cookie

参数:

id: singid, albumid, tid, topid, vid 必填

biztype: 发送评论类型 1: 歌曲 2: 专辑 3: 歌单 4: 排行榜 5: mv

content: 评论内容,必填,不超过300字

3、删除评论

接口:/comment/del

该接口需要用户登陆 cookie

参数:

id: commentid 必填

只要登陆情况下,一般这个接口返回的都是操作成功,不管 id 是否存真实在(是鹅厂这样返回的!)

4、点赞评论

接口:/comment/like

该接口需要用户登陆 cookie

参数:

id: commentid 必填

type: 1:点赞,2:取消赞,默认 1

电台

1、电台分类

接口:/radio/category

返回电台场景分类以及场景下的各个电台

示例:/radio/category

2、获取电台歌曲

接口:/radio

参数:

id: 电台id,从上面的分类接口中获取

获取电台中歌曲,其中个性电台需要登陆 cookie

示例:/radio?id=568

MV

1、获取 MV 信息

接口:/mv

参数:

id: 视频的 vid,必填

返回 info 为 MV 信息,recommend 为相关推荐的 MV

示例:/mv?id=t0032kwa29w

2、获取 MV 播放链接

接口:/mv/url

参数:

id: 视频的 vid , 必填,多个用,分割

返回的链接都是可以直接播放的完整mv视频

示例:/mv/url?id=t0032kwa29w

3、获取 MV 分类

接口:/mv/category

和获取歌手分类接口类似

示例:/mv/category

4、根据分类获取 MV 列表

接口:/mv/list

参数

pageNo: 默认 1

pageSize: 默认 20

area: 地区,默认 15 全部,具体数值从上面分类接口获取

version: MV 类型,默认 7 全部,具体数值从上面分类接口获取

示例:/mv/list

排行榜

1、获取榜单列表

接口:/top/category

参数:

showDetail: 是否显示前三歌曲简单信息和榜单介绍,0,不显示,1 显示,默认 0

这个接口列出了几个榜单的分类,包含了榜单名、榜单 id、更新时间、播放量,(榜单介绍、前三歌曲非必传回)

示例:/top/category

2、获取榜单详情

接口:/top

参数

id: 默认 4,从上面的列表中取值

pageSize: 默认 100 // 部分接口不支持这个字段,所以这里默认选择100

period: 榜单的时间,从上面的列表中取值,非必填

time: 默认当前时间,如果有 period,此参数无效

返回说明

time: 当前榜单的发布时间,可能是天,也可能是周

timeType: 当前榜单的时间格式 YYYY_WYYYY-MM-DD

rank: 在榜单的排名

rankType: 1 上升,2 减少,3 持平,4 新歌,6 上升百分比

rankValue: 排名改变值

传入的 timeperiod并非必定与传回参数相同,比如,当榜单最新时间为 2019_49, 而传入 period=2019_50时,会返回 2019_49的榜单, 虽然这里不传或传入错误的 period 也会返回正确的数值,但是实际是通过第一次请求返回的结果来验证 period 是否正确,如果不正确会再进行第二次请求, 因此会造成返回的比较慢,尽量都传入上一个接口中返回的 period

关注、粉丝

1、获取关注的歌手列表

接口:/user/follow/singers

该接口需要用户登陆 cookie

参数

pageNo: 默认 1

pageSize: 默认 20

id: 用户的 qq 号,默认为当前登陆用户

2、获取关注的用户列表

接口:/user/follow/users

该接口需要用户登陆 cookie

参数

pageNo: 默认 1

pageSize: 默认 20

id: 用户的 qq 号,默认为当前登陆用户

3、获取用户的粉丝列表

接口:/user/fans

该接口需要用户登陆 cookie

参数

pageNo: 默认 1

pageSize: 默认 20

id: 用户的 qq 号,默认为当前登陆用户

4、关注/取消关注 歌手

接口:/user/follow

该接口需要用户登陆 cookie

singermid: 关注的歌手 mid,必填

operation: 操作,1:关注,2:取消关注,默认为 1

接口调用统计

接口的数据统计包含系统、ip、路径、浏览器等信息,已经忽略掉 node 接口自身调用的情况,数据为用 json 方式存储 (我会说是因为我不会用数据库嘛 /data 下还包含了很多其他接口,不过大部分都是用户不需要的,给管理员调用的,所以大家在源码里自己探索吧

1、获取数据统计

接口: /data

参数

type: 默认 ip,可选:ip, browser, browserVersion, os, osVersion, path, url, host

startTime: 默认当前时间

endTime: 默认当前时间

这个接口会返回各个数据的统计结果

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].