当前位置：首页 > news >正文

QQMusicApi开发指南：快速构建你的音乐应用

news 2026/6/27 22:35:41

QQMusicApi开发指南：快速构建你的音乐应用

【免费下载链接】QQMusicApi基于 Express + Axios 的 QQ音乐接口 nodejs 版项目地址: https://gitcode.com/gh_mirrors/qqm/QQMusicApi

想要为你的Node.js项目添加QQ音乐功能吗？QQMusicApi正是你需要的解决方案！这个基于Express和Axios构建的API服务，让你能够轻松获取QQ音乐平台的各类数据，从歌曲搜索到播放链接，从歌单管理到用户系统，应有尽有。

🚀 快速入门：三分钟搭建音乐API服务

安装方式一：NPM包直接使用

const qqMusic = require('qq-music-api'); // 搜索周杰伦的歌曲 qqMusic.api('search', { key: '周杰伦' }) .then(res => console.log(res)) .catch(err => console.error(err));

安装方式二：本地服务部署

git clone https://gitcode.com/gh_mirrors/qqm/QQMusicApi cd QQMusicApi yarn install yarn start

默认服务将在3300端口启动，你可以通过浏览器访问http://localhost:3300来测试API服务。

🎵 核心功能详解

音乐搜索与播放

搜索功能- 支持多种类型的内容搜索：

// 搜索歌曲 qqMusic.api('search', { key: '关键词', t: 0, // 0:单曲 2:歌单 7:歌词 8:专辑 9:歌手 12:MV pageNo: 1, pageSize: 20 });

播放链接获取- 支持多种音质格式：

// 获取标准音质 qqMusic.api('song/url', { id: '0039MnYb0qxYhV' }); // 批量获取播放链接 qqMusic.api('song/urls', { id: '0039MnYb0qxYhV,004Z8Ihr0JIu5s' });

用户系统集成

Cookie管理- 部分高级功能需要用户登录：

// 设置Cookie（字符串或对象格式） qqMusic.setCookie('uin=123456; qm_keyst=xxx;'); // 刷新登录状态 qqMusic.api('user/refresh'); // 获取当前用户信息 console.log(qqMusic.uin);

歌单与排行榜

歌单操作- 丰富的歌单管理功能：

// 获取歌单详情 qqMusic.api('songlist', { id: '歌单ID' }); // 获取榜单列表 qqMusic.api('top/category', { showDetail: 1 }); // 获取榜单详情 qqMusic.api('top', { id: '榜单ID' });

🔧 项目架构解析

QQMusicApi采用模块化设计，主要包含以下核心目录：

routes/- 所有API路由处理模块
util/- 工具函数和辅助模块
node/- NPM包发布相关代码
test/- 单元测试用例

主要API模块

模块名称	功能描述	对应文件
搜索模块	歌曲、专辑、歌手搜索	`routes/search.js`
歌曲模块	歌曲信息、播放链接	`routes/song.js`
歌词模块	歌词获取与解析	`routes/lyric.js`
歌单模块	歌单详情与分类	`routes/songlist.js`
用户模块	用户信息与Cookie管理	`routes/user.js`

📊 数据格式说明

API返回统一的数据格式：

{ result: 100, // 状态码：100=成功 data: { ... }, // 实际数据 msg: '成功' // 状态描述 }

常见状态码

100- 请求成功
301- 需要用户登录
400- 未知异常
500- 参数错误

🛠️ 开发最佳实践

1. 错误处理策略

qqMusic.api('some/api') .then(res => { if(res.result !== 100) { throw new Error(`API错误: ${res.result}`); } // 处理正常数据 }) .catch(err => { console.error('API调用失败:', err); });