NCM API Rust SDK

网易云音乐 API Rust 原生实现

从 NeteaseCloudMusicApi Enhanced 移植的 Rust 原生 SDK，无需 Node.js 运行时

项目简介

本项目是 NeteaseCloudMusicApi Enhanced 的 Rust 原生实现。通过跨站请求伪造 (CSRF) 和伪造请求头，调用网易云音乐官方 API，提供与 Node.js 版本 1:1 对应的接口。

所有 API 方法统一使用 Query 对象传参，与 Node.js 版本保持一致的调用风格，同时充分利用 Rust 的类型安全和零成本抽象特性。

特点

纯 Rust 实现 - 无需 Node.js 运行时，独立编译部署
完整加密支持 - 完整实现 weapi / eapi / linuxapi 三种加密方式
极低内存占用 - ~5MB vs Node.js ~50-100MB
异步非阻塞 - 基于 tokio + reqwest 的异步请求
300+ 开箱即用的 API 接口 - 与 Node.js 版本 1:1 对应
模块化设计 - 每个 API 独立文件，易于扩展和维护
统一的参数模式 - 所有接口使用 Query 对象传参，用法简洁一致
代理支持 - 支持 HTTP / SOCKS5 代理
IP 伪装 - 支持 realIP 和 randomCNIP 功能
HTTP 服务模式 - 内置 Axum HTTP 服务器，可直接替代 Node.js 版提供 REST API

快速开始

安装

作为 Rust 库依赖

[dependencies]
ncm-api-rs = "0.1"
tokio = { version = "1", features = ["full"] }

或从 Git 安装最新版：

[dependencies]
ncm-api-rs = { git = "https://github.com/SPlayer-Dev/ncm-api-rs.git" }
tokio = { version = "1", features = ["full"] }

安装 HTTP 服务器

通过 cargo 安装：

cargo install ncm-api-rs --features server

或从 GitHub Releases 下载预编译二进制文件，支持以下平台：

平台	架构	文件
Linux	x64	`ncm-server-vX.X.X-x86_64-unknown-linux-gnu.tar.gz`
Linux	ARM64	`ncm-server-vX.X.X-aarch64-unknown-linux-gnu.tar.gz`
macOS	x64	`ncm-server-vX.X.X-x86_64-apple-darwin.tar.gz`
macOS	Apple Silicon	`ncm-server-vX.X.X-aarch64-apple-darwin.tar.gz`
Windows	x64	`ncm-server-vX.X.X-x86_64-pc-windows-msvc.zip`

下载后解压即可运行：

# Linux / macOS
tar xzf ncm-server-*.tar.gz
./ncm-server

# Windows
# 解压 zip 后双击 ncm-server.exe 或在终端运行
ncm-server.exe

基础使用

use ncm_api_rs::{create_client, Query};

#[tokio::main]
async fn main() {
    // 创建客户端（不带 cookie）
    let client = create_client(None);

    // 搜索歌曲
    let query = Query::new()
        .param("keywords", "晴天 周杰伦")
        .param("type", "1")       // 1=歌曲
        .param("limit", "10");
    let result = client.cloudsearch(&query).await.unwrap();
    println!("{}", result.body);

    // 获取歌曲详情
    let query = Query::new().param("ids", "186016");
    let detail = client.song_detail(&query).await.unwrap();
    println!("{}", detail.body);

    // 获取歌词
    let query = Query::new().param("id", "186016");
    let lyric = client.lyric(&query).await.unwrap();
    println!("{}", lyric.body["lrc"]["lyric"]);

    // 获取播放链接
    let query = Query::new()
        .param("id", "186016")
        .param("level", "standard");
    let url = client.song_url_v1(&query).await.unwrap();
    println!("{}", url.body);
}

带 Cookie 使用（登录后的接口）

use ncm_api_rs::{create_client, Query};

#[tokio::main]
async fn main() {
    // 方式一：创建客户端时传入 cookie
    let client = create_client(Some("MUSIC_U=xxx; __csrf=xxx".to_string()));

    let query = Query::new();
    let songs = client.recommend_songs(&query).await.unwrap();

    // 方式二：在 Query 中传入 cookie（覆盖客户端 cookie）
    let query = Query::new().cookie("MUSIC_U=xxx; __csrf=xxx");
    let fm = client.personal_fm(&query).await.unwrap();
}

Query 参数说明

Query 是所有 API 的统一参数载体，支持链式调用：

let mut query = Query::new()
    // 业务参数 - 对应 Node.js 版本中 req.query 传入的参数
    .param("id", "186016")
    .param("limit", "30")
    .param("offset", "0")
    // 可选：覆盖 cookie
    .cookie("MUSIC_U=xxx");

// 可选：设置代理
query.proxy = Some("socks5://127.0.0.1:1080".to_string());
// 可选：设置真实 IP（伪装 X-Real-IP 请求头）
query.real_ip = Some("116.25.146.177".to_string());
// 可选：使用随机中国 IP
query.random_cn_ip = true;

// 读取参数
query.get("id");              // Some("186016")
query.get_or("limit", "30");  // "30"

调用前须知

本项目仅供学习使用，请尊重版权，请勿利用此项目从事商业行为或进行破坏版权行为

不要频繁调用登录接口，不然可能会被风控，登录状态还存在就不要重复调用登录接口

部分接口如登录接口不能调用太频繁，否则可能会触发 503 错误或者 IP 高频错误，若需频繁调用，需要准备 IP 代理池

由于网易限制，此项目在国外服务器或部分国内云服务上使用会受到限制，如 460 cheating异常，如需解决，可使用 real_ip 参数，传进国内 IP 解决

301 错误基本都是没登录就调用了需要登录的接口，如果登录了还是提示 301，基本都是 cookie 问题

Cookie 说明

登录接口返回的 ApiResponse 中包含 cookie 字段（Vec<String>），可以保存到本地后在后续请求中使用：

// 登录
let query = Query::new()
    .param("phone", "13xxx")
    .param("password", "xxx");
let result = client.login_cellphone(&query).await?;

// 保存 cookie
let cookies = result.cookie.join("; ");

// 后续请求使用 cookie
let query = Query::new().cookie(&cookies);
let account = client.user_account(&query).await?;

也可以直接从浏览器中获取 cookie 值，只需要其中 key 为 MUSIC_U 的数据即可：

let query = Query::new().cookie("MUSIC_U=xxxx");

realIP 参数

在国外服务器或 Vercel 等云服务上使用时，需要设置 real_ip 参数传入国内 IP：

let mut query = Query::new().param("id", "1969519579");
query.real_ip = Some("116.25.146.177".to_string());
let result = client.song_url_v1(&query).await?;

randomCNIP 参数

也可以使用随机中国 IP 功能，无需手动指定 IP：

let mut query = Query::new().param("id", "1969519579");
query.random_cn_ip = true;
let result = client.song_url_v1(&query).await?;

代理支持

在 Query 参数中设置 proxy 即可让该次请求使用代理：

let mut query = Query::new().param("id", "33894312");
query.proxy = Some("http://121.196.226.246:84".to_string());
// 也支持 socks5 代理
// query.proxy = Some("socks5://127.0.0.1:1080".to_string());
let result = client.song_url(&query).await?;

HTTP 服务模式

除了作为 Rust 库直接调用，本项目还支持以 HTTP 服务器模式运行，提供与 Node.js 版本完全兼容的 REST API 接口，前端可以无缝切换。

启动服务器

# 编译并运行（默认监听 0.0.0.0:3000）
cargo run --features server --bin ncm-server

# 或先编译再运行
cargo build --release --features server --bin ncm-server
./target/release/ncm-server

环境变量配置

变量名	说明	默认值
`NCM_HOST`	监听地址	`0.0.0.0`
`NCM_PORT`	监听端口	`3000`
`CORS_ALLOW_ORIGIN`	CORS 允许的 Origin，支持逗号分隔多个源	`*`（允许所有）

# 示例：自定义端口和 CORS
NCM_HOST=127.0.0.1 NCM_PORT=8080 CORS_ALLOW_ORIGIN=http://localhost:5173 cargo run --features server --bin ncm-server

# 示例：允许多个源
CORS_ALLOW_ORIGIN=https://a.com,https://b.com cargo run --features server --bin ncm-server

前端调用示例

接口路径与 Node.js 版完全一致，方法名中的下划线 _ 转换为斜杠 /：

// 搜索歌曲
const res = await axios.get('/cloudsearch', { params: { keywords: '海阔天空' } })

// 获取歌曲详情
const res = await axios.get('/song/detail', { params: { ids: '347230' } })

// POST 方式调用
const res = await axios.post('/login/cellphone', {
  phone: '138xxxx8000',
  password: 'xxx',
})

// 带 Cookie 调用需要登录的接口
const res = await axios.get('/user/playlist', {
  params: { uid: '32953014', cookie: 'MUSIC_U=xxx' },
})

路由映射规则

方法名	HTTP 路由	说明
`song_detail`	`/song/detail`	下划线转斜杠（默认规则）
`login_cellphone`	`/login/cellphone`	同上
`daily_signin`	`/daily_signin`	特殊路由，保留下划线
`fm_trash`	`/fm_trash`	特殊路由，保留下划线
`personal_fm`	`/personal_fm`	特殊路由，保留下划线
`avatar_upload`	`/avatar/upload`	POST multipart/form-data
`voice_upload`	`/voice/upload`	POST multipart/form-data

所有路由均支持 GET 和 POST 两种请求方式（上传接口仅 POST）。

作为库集成到你的项目

如果你已有 Axum 项目，可以直接集成路由：

use ncm_api_rs::{create_client, server::{build_app, build_app_with_config, ServerConfig}};

// 方式一：快速构建
let app = build_app(create_client(None));

// 方式二：自定义配置
let config = ServerConfig {
    host: "127.0.0.1".to_string(),
    port: 8080,
    cors_origin: Some("http://localhost:5173".to_string()),
};
let app = build_app_with_config(create_client(None), &config);

// 启动
let listener = tokio::net::TcpListener::bind("0.0.0.0:8080").await?;
axum::serve(listener, app).await?;

自动路由注册

新增 API 时无需手动注册路由。build.rs 会在编译期自动扫描 src/api/mod.rs 中的模块声明，生成对应的路由注册代码。只需：

创建 src/api/xxx_yyy.rs 文件，实现 ApiClient 方法
在 src/api/mod.rs 中添加 mod xxx_yyy;

路由 /xxx/yyy 会自动注册，无需其他操作。

API 文档

完整接口文档请查看 docs/API.md，涵盖全部接口的详细参数说明和调用示例。

接口速查表

登录相关

方法名	说明
`login`	邮箱登录
`login_cellphone`	手机号登录
`login_qr_key`	二维码 key 生成
`login_qr_create`	二维码生成
`login_qr_check`	二维码扫码状态
`login_refresh`	刷新登录
`login_status`	登录状态
`logout`	退出登录
`register_anonimous`	游客登录
`register_cellphone`	注册/修改密码
`captcha_sent`	发送验证码
`captcha_verify`	验证验证码
`cellphone_existence_check`	检测手机号是否注册
`activate_init_profile`	初始化昵称
`nickname_check`	重复昵称检测
`rebind`	更换绑定手机

用户相关

方法名	说明
`user_detail`	用户详情
`user_detail_new`	用户详情(新)
`user_account`	账号信息
`user_subcount`	收藏计数
`user_level`	用户等级
`user_binding`	绑定信息
`user_bindingcellphone`	绑定手机
`user_replacephone`	更换手机
`user_update`	更新用户信息
`user_playlist`	用户歌单
`user_playlist_create`	创建歌单列表
`user_playlist_collect`	收藏歌单列表
`user_follows`	关注列表
`user_followeds`	粉丝列表
`user_follow_mixed`	关注的用户/歌手
`user_mutualfollow_get`	是否互相关注
`user_event`	用户动态
`user_record`	播放记录
`user_dj`	用户电台
`user_audio`	用户音频
`user_comment_history`	历史评论
`user_medal`	用户徽章
`user_social_status`	用户状态
`user_social_status_edit`	编辑状态
`user_social_status_rcmd`	相同状态用户
`user_social_status_support`	支持的状态
`follow`	关注/取消关注
`pl_count`	私信和通知数量
`countries_code_list`	国家编码列表
`setting`	用户设置
`get_userids`	获取用户 ID
`avatar_upload`	上传头像

歌曲相关

方法名	说明
`song_detail`	歌曲详情
`song_url`	歌曲播放链接
`song_url_v1`	歌曲播放链接(新)
`song_url_v1_302`	302 重定向到歌曲 URL
`song_url_ncmget`	NCM 获取歌曲 URL
`song_url_match`	歌曲解锁匹配
`song_download_url`	歌曲下载链接
`song_download_url_v1`	歌曲下载链接(新)
`check_music`	音乐是否可用
`lyric`	歌词
`lyric_new`	逐字歌词
`like`	喜欢音乐
`song_like`	喜欢歌曲(新版)
`likelist`	喜欢的音乐列表
`song_like_check`	歌曲是否喜爱
`scrobble`	听歌打卡
`song_order_update`	调整歌曲顺序
`song_chorus`	副歌时间
`song_wiki_summary`	歌曲百科
`song_music_detail`	歌曲音质详情
`song_red_count`	红心数量
`song_dynamic_cover`	动态封面
`song_downlist`	会员下载记录
`song_monthdownlist`	本月下载记录
`song_singledownlist`	已购买单曲
`song_purchased`	已购买歌曲
`song_lyrics_mark`	歌词摘录信息
`song_lyrics_mark_add`	添加歌词摘录
`song_lyrics_mark_del`	删除歌词摘录
`song_lyrics_mark_user_page`	我的歌词本
`audio_match`	听歌识曲

搜索相关

方法名	说明
`search`	搜索
`cloudsearch`	搜索(更全)
`search_default`	默认搜索关键词
`search_hot`	热搜列表(简略)
`search_hot_detail`	热搜列表(详细)
`search_suggest`	搜索建议
`search_suggest_pc`	搜索建议(PC端)
`search_multimatch`	搜索多重匹配
`search_match`	搜索匹配

歌单相关

方法名	说明
`playlist_create`	新建歌单
`playlist_delete`	删除歌单
`playlist_subscribe`	收藏/取消收藏歌单
`playlist_subscribers`	歌单收藏者
`playlist_detail`	歌单详情
`playlist_detail_dynamic`	歌单详情动态
`playlist_detail_rcmd_get`	相关歌单推荐
`playlist_track_all`	歌单所有歌曲
`playlist_tracks`	添加/删除歌曲
`playlist_track_add`	收藏视频到歌单
`playlist_track_delete`	删除歌单视频
`playlist_update`	更新歌单
`playlist_desc_update`	更新歌单描述
`playlist_name_update`	更新歌单名
`playlist_tags_update`	更新歌单标签
`playlist_cover_update`	歌单封面上传
`playlist_order_update`	调整歌单顺序
`playlist_update_playcount`	更新播放量
`playlist_catlist`	歌单分类
`playlist_hot`	热门歌单分类
`playlist_category_list`	歌单分类列表
`playlist_highquality_tags`	精品歌单标签
`playlist_privacy`	歌单隐私设置
`playlist_mylike`	我喜欢的歌单
`playlist_video_recent`	最近播放视频
`playlist_import_name_task_create`	歌单导入
`playlist_import_task_status`	导入任务状态
`related_playlist`	相关歌单

评论相关

方法名	说明
`comment_music`	歌曲评论
`comment_album`	专辑评论
`comment_playlist`	歌单评论
`comment_mv`	MV 评论
`comment_dj`	电台节目评论
`comment_video`	视频评论
`comment_event`	动态评论
`comment_floor`	楼层评论
`comment_hot`	热门评论
`comment_like`	点赞评论
`comment_new`	新版评论
`comment_reply`	回复评论
`comment_delete`	删除评论
`comment_hug_list`	抱一抱列表
`comment_info_list`	评论统计
`hug_comment`	抱一抱评论
`starpick_comments_summary`	精选评论摘要

歌手相关

方法名	说明
`artists`	歌手信息
`artist_detail`	歌手详情
`artist_detail_dynamic`	歌手详情动态
`artist_songs`	歌手全部歌曲
`artist_album`	歌手专辑
`artist_desc`	歌手描述
`artist_mv`	歌手 MV
`artist_list`	歌手分类列表
`artist_sub`	收藏/取消收藏歌手
`artist_sublist`	收藏的歌手列表
`artist_top_song`	歌手热门歌曲
`artist_fans`	歌手粉丝
`artist_follow_count`	歌手关注数
`artist_new_mv`	关注歌手新 MV
`artist_new_song`	关注歌手新歌
`artist_video`	歌手视频

专辑相关

方法名	说明
`album`	专辑内容
`album_detail`	专辑详情
`album_detail_dynamic`	专辑动态信息
`album_sub`	收藏/取消收藏专辑
`album_sublist`	已收藏专辑列表
`album_newest`	最新专辑
`album_new`	新碟上架
`album_list`	数字专辑列表
`album_list_style`	专辑风格列表
`album_privilege`	专辑歌曲音质
`album_songsaleboard`	专辑销量榜

MV 相关

方法名	说明
`mv_all`	全部 MV
`mv_first`	最新 MV
`mv_exclusive_rcmd`	网易出品 MV
`mv_detail`	MV 数据
`mv_detail_info`	MV 点赞转发评论数
`mv_url`	MV 地址
`mv_sub`	收藏/取消收藏 MV
`mv_sublist`	收藏的 MV 列表
`personalized_mv`	推荐 MV
`top_mv`	MV 排行

视频相关

方法名	说明
`video_group_list`	视频标签列表
`video_category_list`	视频分类列表
`video_group`	标签下的视频
`video_timeline_all`	全部视频列表
`video_timeline_recommend`	推荐视频
`video_detail`	视频详情
`video_detail_info`	视频点赞转发评论数
`video_url`	视频播放地址
`video_sub`	收藏视频
`related_allvideo`	相关视频
`mlog_url`	Mlog 地址
`mlog_to_video`	Mlog 转视频
`mlog_music_rcmd`	Mlog 音乐推荐

电台相关

方法名	说明
`dj_banner`	电台 banner
`dj_personalize_recommend`	电台个性推荐
`dj_subscriber`	电台订阅者列表
`dj_catelist`	电台分类列表
`dj_category_excludehot`	非热门电台分类
`dj_category_recommend`	电台分类推荐
`dj_detail`	电台详情
`dj_hot`	热门电台
`dj_radio_hot`	电台 - 类别热门
`dj_program`	电台节目列表
`dj_program_detail`	电台节目详情
`dj_program_toplist`	节目排行榜
`dj_program_toplist_hours`	节目24小时榜
`dj_recommend`	电台推荐
`dj_recommend_type`	电台推荐类型
`dj_sub`	订阅/取消订阅电台
`dj_sublist`	订阅的电台列表
`dj_toplist`	电台排行榜
`dj_toplist_hours`	电台24小时榜
`dj_toplist_newcomer`	电台新人榜
`dj_toplist_pay`	付费电台榜
`dj_toplist_popular`	电台热门榜
`dj_difm_all_style_channel`	DIFM电台 - 分类
`dj_difm_channel_subscribe`	DIFM电台 - 收藏频道
`dj_difm_channel_unsubscribe`	DIFM电台 - 取消收藏频道
`dj_difm_playing_tracks_list`	DIFM电台 - 播放列表
`dj_difm_subscribe_channels_get`	DIFM电台 - 收藏列表
`dj_paygift`	付费精品
`dj_today_perfered`	今日优选
`dj_radio_top`	电台排行

推荐相关

方法名	说明
`personalized`	推荐歌单
`personalized_newsong`	推荐新音乐
`personalized_djprogram`	推荐电台
`personalized_privatecontent`	独家放送(入口)
`personalized_privatecontent_list`	独家放送列表
`recommend_songs`	每日推荐歌曲
`recommend_resource`	每日推荐歌单
`recommend_songs_dislike`	不喜欢推荐
`history_recommend_songs`	历史日推
`history_recommend_songs_detail`	历史日推详情
`program_recommend`	推荐节目
`homepage_block_page`	首页-发现
`homepage_dragon_ball`	首页圆形图标入口
`banner`	首页 Banner
`daily_signin`	每日签到
`personal_fm`	私人 FM
`personal_fm_mode`	私人 FM 模式
`fm_trash`	垃圾桶
`playmode_intelligence_list`	心动模式/智能播放
`playmode_song_vector`	随机播放模式
`simi_song`	相似歌曲
`simi_artist`	相似歌手
`simi_playlist`	相似歌单
`simi_mv`	相似 MV
`simi_user`	相似用户

排行榜相关

方法名	说明
`toplist`	所有榜单
`toplist_detail`	所有榜单摘要
`toplist_detail_v2`	所有榜单摘要 v2
`toplist_artist`	歌手榜
`top_song`	新歌速递
`top_album`	新碟上架
`top_artists`	热门歌手
`top_mv`	MV 排行
`top_playlist`	歌单(网友精选碟)
`top_playlist_highquality`	精品歌单
`top_list`	排行榜详情

云盘相关

方法名	说明
`user_cloud`	云盘数据
`user_cloud_detail`	云盘数据详情
`user_cloud_del`	云盘歌曲删除
`cloud`	云盘上传
`cloud_import`	云盘导入
`cloud_match`	云盘歌曲匹配纠正
`cloud_lyric_get`	云盘歌词
`cloud_upload_token`	上传凭证
`cloud_upload_complete`	完成上传

私信/动态相关

方法名	说明
`msg_private`	私信列表
`msg_private_history`	私信历史
`msg_comments`	评论通知
`msg_forwards`	转发通知
`msg_notices`	通知消息
`msg_recentcontact`	最近联系人
`send_text`	发送文本私信
`send_song`	发送歌曲私信
`send_playlist`	发送歌单私信
`send_album`	发送专辑私信
`share_resource`	分享到动态
`resource_like`	资源点赞
`event`	动态列表
`event_del`	删除动态
`event_forward`	转发动态

VIP/会员

方法名	说明
`vip_info`	VIP 信息
`vip_info_v2`	VIP 信息 v2
`vip_sign`	黑胶乐签打卡
`vip_sign_info`	打卡信息
`vip_tasks`	VIP 任务列表
`vip_timemachine`	时光机
`vip_growthpoint`	成长值基本信息
`vip_growthpoint_details`	成长值明细
`vip_growthpoint_get`	领取成长值奖励

云贝

方法名	说明
`yunbei`	云贝签到信息
`yunbei_info`	云贝信息
`yunbei_sign`	云贝签到
`yunbei_today`	今日云贝
`yunbei_expense`	云贝支出
`yunbei_receipt`	云贝收入
`yunbei_tasks`	云贝任务
`yunbei_tasks_todo`	待完成任务
`yunbei_task_finish`	完成任务
`yunbei_rcmd_song`	云贝推歌
`yunbei_rcmd_song_history`	推歌历史

听歌足迹

方法名	说明
`listen_data_year_report`	年度听歌足迹
`listen_data_today_song`	今日收听
`listen_data_total`	总收听时长
`listen_data_realtime_report`	本周/本月时长
`listen_data_report`	收听报告
`recent_listen_list`	最近听歌列表
`record_recent_song`	最近播放歌曲
`record_recent_album`	最近播放专辑
`record_recent_playlist`	最近播放歌单
`record_recent_dj`	最近播放电台
`record_recent_video`	最近播放视频
`record_recent_voice`	最近播放声音

风格/曲风

方法名	说明
`style_list`	曲风列表
`style_detail`	曲风详情
`style_song`	曲风歌曲
`style_album`	曲风专辑
`style_artist`	曲风歌手
`style_playlist`	曲风歌单
`style_preference`	曲风偏好

数字专辑

方法名	说明
`digital_album_detail`	数字专辑详情
`digital_album_ordering`	购买数字专辑
`digital_album_purchased`	已购数字专辑
`digital_album_sales`	数字专辑销量

声音/播客

方法名	说明
`voice_upload`	上传音频
`voice_delete`	删除音频
`voice_detail`	音频详情
`voice_lyric`	音频歌词
`voicelist_list`	声音列表
`voicelist_detail`	声音列表详情
`voicelist_my_created`	我创建的播客声音
`voicelist_search`	搜索声音列表
`voicelist_list_search`	搜索声音
`voicelist_trans`	声音转换

音乐人

方法名	说明
`musician_sign`	音乐人签到
`musician_tasks`	音乐人任务
`musician_tasks_new`	音乐人新任务
`musician_vip_tasks`	VIP 任务
`musician_data_overview`	数据概览
`musician_play_trend`	播放趋势
`musician_cloudbean`	云豆数量
`musician_cloudbean_obtain`	领取云豆

粉丝中心

方法名	说明
`fanscenter_overview_get`	粉丝中心概览
`fanscenter_trend_list`	粉丝趋势
`fanscenter_basicinfo_age_get`	年龄分布
`fanscenter_basicinfo_gender_get`	性别分布
`fanscenter_basicinfo_province_get`	省份分布

UGC 百科

方法名	说明
`ugc_song_get`	歌曲百科
`ugc_artist_get`	歌手百科
`ugc_album_get`	专辑百科
`ugc_mv_get`	MV 百科
`ugc_detail`	百科详情
`ugc_artist_search`	搜索歌手百科
`ugc_user_devote`	用户贡献

一起听

方法名	说明
`listentogether_room_create`	创建房间
`listentogether_room_check`	检查房间
`listentogether_accept`	接受邀请
`listentogether_status`	房间状态
`listentogether_heatbeat`	心跳
`listentogether_play_command`	播放指令
`listentogether_sync_list_command`	同步列表指令
`listentogether_sync_playlist_get`	获取同步歌单
`listentogether_end`	结束房间

广播电台

方法名	说明
`broadcast_category_region_get`	分类/地区信息
`broadcast_channel_list`	全部电台
`broadcast_channel_currentinfo`	电台信息
`broadcast_channel_collect_list`	我的收藏
`broadcast_sub`	收藏/取消电台

其他

方法名	说明
`hot_topic`	热门话题
`topic_detail`	话题详情
`topic_detail_event_hot`	话题热门动态
`topic_sublist`	收藏的专栏
`calendar`	音乐日历
`batch`	批量请求
`api`	通用 API 代理
`inner_version`	内部版本号
`weblog`	日志上报
`eapi_decrypt`	EAPI 解密
`sign_happy_info`	乐签信息
`signin_progress`	签到进度
`summary_annual`	年度总结
`threshold_detail_get`	达人认证门槛
`creator_authinfo_get`	创作者认证信息
`sheet_list`	乐谱列表
`sheet_preview`	乐谱预览
`aidj_content_rcmd`	AI DJ 推荐
`music_first_listen_info`	回忆坐标
`verify_get_qr`	验证二维码
`verify_qrcodestatus`	二维码状态

扩展接口

在 src/api/ 中添加新文件即可，模式非常简单：

// src/api/your_new_api.rs
use crate::request::{ApiClient, ApiResponse, CryptoType};
use crate::error::Result;
use serde_json::json;
use super::Query;

impl ApiClient {
    pub async fn your_new_api(&self, query: &Query) -> Result<ApiResponse> {
        let data = json!({
            "id": query.get_or("id", ""),
        });
        self.request("/api/your/endpoint", data, query.to_option(CryptoType::Weapi)).await
    }
}

然后在 src/api/mod.rs 中注册：

mod your_new_api;

对应的 Node.js 接口参考 NeteaseCloudMusicApi Enhanced 的 module/ 目录。

致谢

NeteaseCloudMusicApi Enhanced - 原始 Node.js 实现
Binaryify/NeteaseCloudMusicApi - 原始项目

License

WTFPL - Do What The Fuck You Want To Public License

Name		Name	Last commit message	Last commit date
Latest commit History 11 Commits
.github/workflows		.github/workflows
docs		docs
examples		examples
src		src
tests		tests
.gitignore		.gitignore
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md
build.rs		build.rs
clippy.toml		clippy.toml
rustfmt.toml		rustfmt.toml

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

NCM API Rust SDK

项目简介

特点

快速开始

安装

作为 Rust 库依赖

安装 HTTP 服务器

基础使用

带 Cookie 使用（登录后的接口）

Query 参数说明

调用前须知

Cookie 说明

realIP 参数

randomCNIP 参数

代理支持

HTTP 服务模式

启动服务器

环境变量配置

前端调用示例

路由映射规则

作为库集成到你的项目

自动路由注册

API 文档

接口速查表

扩展接口

致谢

License

About

Uh oh!

Releases 1

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

NCM API Rust SDK

项目简介

特点

快速开始

安装

作为 Rust 库依赖

安装 HTTP 服务器

基础使用

带 Cookie 使用（登录后的接口）

Query 参数说明

调用前须知

Cookie 说明

realIP 参数

randomCNIP 参数

代理支持

HTTP 服务模式

启动服务器

环境变量配置

前端调用示例

路由映射规则

作为库集成到你的项目

自动路由注册

API 文档

接口速查表

扩展接口

致谢

License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Contributors

Uh oh!

Languages