跳到主要内容

网易云代理 T2

详见统一请求约定，上游说明不能覆盖本站权限边界。

/cm/ncm/activate/init/profile​

初始化昵称

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 刚注册的账号(需登录),调用此接口 ,可初始化昵称 必选参数 : nickname : 昵称

接口地址 : /activate/init/profile

调用例子 : /activate/init/profile?nickname=testUser2019

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/activate/init/profile' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/ad/listening/rights/gain​

看广告领取权益（免费听歌时长 / 云贝等）

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口, 领取广告权益。权益类型由广告平台下发的配置决定, 不仅限于 30 分钟免费听歌时长, 还包括"看视频获得最高 2000 云贝"等拉新分段权益(rightsGainMethod=6)。除下方常用参数外, 权益类型/时长/扩展权益等其余字段会自动从广告下发配置补齐, 无需手动传入。

!> 警告: 通过调取接口出现的任何问题由调用者自行承担

可选参数 :

reqUid : 广告请求 ID, 通过 /ad/get 获取, 未传时自动获取

uid : 当前登录用户 ID, 不传时服务端从 Cookie 识别

rightsGainMethod : 权益领取方式, 1: 曝光, 2: 曝光+点击(默认), 3: 曝光+下载, 4: 点击+停留, 5: 曝光或点击停留, 6: 拉新曝光/下载分段权益(看视频得云贝)

type_ids : 广告位类型, 默认 ["400002_0"]

creativeType : 广告创意类型, 激励视频场景为 36, 默认 36

接口地址 : /ad/listening/rights/gain

调用例子 : /ad/listening/rights/gain

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/ad/listening/rights/gain' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/album/sub​

收藏/取消收藏专辑

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口,可收藏/取消收藏专辑

必选参数 :

id : 专辑 id

t : 1 为收藏,其他为取消收藏

接口地址 : /album/sub

调用例子 : /album/sub?t=1 /album/sub?t=0

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/album/sub' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/artist/sub​

收藏/取消收藏歌手

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口,可收藏歌手

必选参数 :

id : 歌手 id

t:操作,1 为收藏,其他为取消收藏

接口地址 : /artist/sub

调用例子 : /artist/sub?id=6452&t=1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/artist/sub' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/avatar/upload​

更新头像

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,使用'Content-Type': 'multipart/form-data'上传图片 formData(name 为'imgFile'),可更新头像(参考: https://github.com/neteasecloudmusicapienhanced/api-enhanced/blob/main/public/avatar_update.html ),支持命令行调用,参考 module_example 目录下avatar_upload.js

可选参数 :

imgSize : 图片尺寸,默认为 300

imgX : 水平裁剪偏移,方形图片可不传,默认为 0 imgY : 垂直裁剪偏移,方形图片可不传,默认为 0

接口地址 : /avatar/upload

调用例子 : /avatar/upload?imgSize=200

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/avatar/upload' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/broadcast/sub​

广播电台 - 收藏/取消收藏电台

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 登录后调用此接口, 传入电台 id, 可收藏或取消收藏广播电台

必选参数：

id: 电台 id

t: 操作类型, 1 为收藏, 其余值为取消收藏

接口地址: /broadcast/sub

调用例子: /broadcast/sub?id=5&t=1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/broadcast/sub' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/cloud​

云盘上传

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,使用'Content-Type': 'multipart/form-data'上传 mp3 formData(name 为'songFile'),可上传歌曲到云盘

参考: https://github.com/neteasecloudmusicapienhanced/api-enhanced/blob/main/public/cloud.html

访问地址: http://localhost:3000/cloud.html

支持命令行调用,参考 module_example 目录下song_upload.js

接口地址 : /cloud

调用例子 : /cloud

上传模式说明​

云盘上传支持两种模式:

1. 后端代理模式 (默认)

文件通过服务器转发到云存储,调用简单,但受服务器限制:

  • Vercel Serverless Functions 限制请求体大小为 4.5MB
  • 自建服务器需配置足够大的请求体限制

2. 客户端直传模式 (推荐用于 Vercel)

文件直接从客户端上传到云存储服务器,绕过服务器限制:

  • 支持大文件上传
  • 适合 Vercel、Netlify 等有请求体限制的平台
  • 需要前端配合实现
客户端直传相关接口​

获取上传凭证

接口地址 : /cloud/upload/token

必选参数 :

  • cookie: 网易云音乐 Cookie (在请求体中传递)
  • md5: 文件 MD5 值
  • fileSize: 文件大小(字节)
  • filename: 文件名

返回数据 :

{
  "code": 200,
  "data": {
    "needUpload": true,
    "songId": "...",
    "uploadToken": "...",
    "uploadUrl": "...",
    "resourceId": "..."
  }
}

完成上传导入

接口地址 : /cloud/upload/complete

必选参数 :

  • cookie: 网易云音乐 Cookie (在请求体中传递)
  • songId: 歌曲 ID
  • resourceId: 资源 ID
  • md5: 文件 MD5
  • filename: 文件名

可选参数 :

  • song: 歌曲名
  • artist: 艺术家
  • album: 专辑名
客户端直传流程​
  1. 客户端计算文件 MD5
  2. 调用 /cloud/upload/token 获取上传凭证
  3. 如果 needUpload 为 true,直接 PUT 文件到 uploadUrl
  4. 调用 /cloud/upload/complete 完成导入

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/cloud' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/cloud/import​

云盘导入歌曲

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 登录后调用此接口,使用此接口,可云盘导入歌曲而无需上传文件

以下情况可导入成功

1.文件已经有用户上传至云盘

2.文件是网易云音乐自己的音源

必选参数：

song: 歌名/文件名

fileType: 文件后缀

fileSize: 文件大小

bitrate: 文件比特率

md5: 文件 MD5

可选参数：

id: 歌曲 ID,情况 2 时必须正确填写

artist: 歌手 默认为未知

album: 专辑 默认为未知

接口地址: /cloud/import

调用例子: /cloud/import?song=最伟大的作品&artist=周杰伦&album=最伟大的作品&fileType=flac&fileSize=50412168&bitrate=1652&md5=d02b8ab79d91c01167ba31e349fe5275

为保证成功,请使用 获取音乐url 接口获取各文件属性

其中比特率bitrate要进行以下转换

bitrate = Math.floor(br / 1000)

导入后的文件名后缀均为 .mp3 。但用 获取音乐url 获取到的文件格式仍然是正确的。

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/cloud/import' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/cloud/match​

云盘歌曲信息匹配纠正

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,可对云盘歌曲信息匹配纠正,如需取消匹配,asid 需要传 0

必选参数 : uid: 用户 id

sid: 云盘的歌曲 id

asid: 要匹配的歌曲 id

接口地址 : /cloud/match

调用例子 : /cloud/match?uid=32953014&sid=aaa&asid=bbb /cloud/match?uid=32953014&sid=bbb&asid=0

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/cloud/match' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/cloud/upload/complete​

云盘上传

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,使用'Content-Type': 'multipart/form-data'上传 mp3 formData(name 为'songFile'),可上传歌曲到云盘

参考: https://github.com/neteasecloudmusicapienhanced/api-enhanced/blob/main/public/cloud.html

访问地址: http://localhost:3000/cloud.html

支持命令行调用,参考 module_example 目录下song_upload.js

接口地址 : /cloud

调用例子 : /cloud

上传模式说明​

云盘上传支持两种模式:

1. 后端代理模式 (默认)

文件通过服务器转发到云存储,调用简单,但受服务器限制:

  • Vercel Serverless Functions 限制请求体大小为 4.5MB
  • 自建服务器需配置足够大的请求体限制

2. 客户端直传模式 (推荐用于 Vercel)

文件直接从客户端上传到云存储服务器,绕过服务器限制:

  • 支持大文件上传
  • 适合 Vercel、Netlify 等有请求体限制的平台
  • 需要前端配合实现
客户端直传相关接口​

获取上传凭证

接口地址 : /cloud/upload/token

必选参数 :

  • cookie: 网易云音乐 Cookie (在请求体中传递)
  • md5: 文件 MD5 值
  • fileSize: 文件大小(字节)
  • filename: 文件名

返回数据 :

{
  "code": 200,
  "data": {
    "needUpload": true,
    "songId": "...",
    "uploadToken": "...",
    "uploadUrl": "...",
    "resourceId": "..."
  }
}

完成上传导入

接口地址 : /cloud/upload/complete

必选参数 :

  • cookie: 网易云音乐 Cookie (在请求体中传递)
  • songId: 歌曲 ID
  • resourceId: 资源 ID
  • md5: 文件 MD5
  • filename: 文件名

可选参数 :

  • song: 歌曲名
  • artist: 艺术家
  • album: 专辑名
客户端直传流程​
  1. 客户端计算文件 MD5
  2. 调用 /cloud/upload/token 获取上传凭证
  3. 如果 needUpload 为 true,直接 PUT 文件到 uploadUrl
  4. 调用 /cloud/upload/complete 完成导入

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/cloud/upload/complete' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/cloud/upload/token​

云盘上传

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,使用'Content-Type': 'multipart/form-data'上传 mp3 formData(name 为'songFile'),可上传歌曲到云盘

参考: https://github.com/neteasecloudmusicapienhanced/api-enhanced/blob/main/public/cloud.html

访问地址: http://localhost:3000/cloud.html

支持命令行调用,参考 module_example 目录下song_upload.js

接口地址 : /cloud

调用例子 : /cloud

上传模式说明​

云盘上传支持两种模式:

1. 后端代理模式 (默认)

文件通过服务器转发到云存储,调用简单,但受服务器限制:

  • Vercel Serverless Functions 限制请求体大小为 4.5MB
  • 自建服务器需配置足够大的请求体限制

2. 客户端直传模式 (推荐用于 Vercel)

文件直接从客户端上传到云存储服务器,绕过服务器限制:

  • 支持大文件上传
  • 适合 Vercel、Netlify 等有请求体限制的平台
  • 需要前端配合实现
客户端直传相关接口​

获取上传凭证

接口地址 : /cloud/upload/token

必选参数 :

  • cookie: 网易云音乐 Cookie (在请求体中传递)
  • md5: 文件 MD5 值
  • fileSize: 文件大小(字节)
  • filename: 文件名

返回数据 :

{
  "code": 200,
  "data": {
    "needUpload": true,
    "songId": "...",
    "uploadToken": "...",
    "uploadUrl": "...",
    "resourceId": "..."
  }
}

完成上传导入

接口地址 : /cloud/upload/complete

必选参数 :

  • cookie: 网易云音乐 Cookie (在请求体中传递)
  • songId: 歌曲 ID
  • resourceId: 资源 ID
  • md5: 文件 MD5
  • filename: 文件名

可选参数 :

  • song: 歌曲名
  • artist: 艺术家
  • album: 专辑名
客户端直传流程​
  1. 客户端计算文件 MD5
  2. 调用 /cloud/upload/token 获取上传凭证
  3. 如果 needUpload 为 true,直接 PUT 文件到 uploadUrl
  4. 调用 /cloud/upload/complete 完成导入

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/cloud/upload/token' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/comment​

发送/删除评论

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口,可发送评论或者删除评论

接口地址 : /comment

  1. 发送评论

    必选参数

    t:1 发送, 2 回复

    type: 数字,资源类型,对应歌曲,mv,专辑,歌单,电台,视频对应以下类型

    0: 歌曲

    1: mv

    2: 歌单

    3: 专辑

    4: 电台

    5: 视频

    6: 动态

    id:对应资源 id

    content :要发送的内容

    commentId :回复的评论 id (回复评论时必填)

    调用例子 : /comment?t=1&type=1&id=5436712&content=test (往广岛之恋 mv 发送评论: test)

    注意：如给动态发送评论，则不需要传 id，需要传动态的 threadId,如：/comment?t=1&type=6&threadId=A_EV_2_6559519868_32953014&content=test

  2. 删除评论

    必选参数

    t:0 删除

    type: 数字,资源类型,对应歌曲,mv,专辑,歌单,电台,视频对应以下类型

    0: 歌曲

    1: mv

    2: 歌单

    3: 专辑

    4: 电台节目

    5: 视频

    6: 动态

    7: 电台

    id:对应资源 id content :内容 id,可通过 /comment/mv 等接口获取

    调用例子 : /comment?t=0&type=1&id=5436712&commentId=1535550516319 (在广岛之恋 mv 删除评论)

    注意：如给动态删除评论，则不需要传 id，需要传动态的 threadId,如：/comment?t=0&type=6&threadId=A_EV_2_6559519868_32953014&commentId=1419516382

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/comment' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/comment/add​

（文档未收录）

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游模块读取的参数​

content, id, type

该路径未匹配到上游独立说明段。字段来自已部署模块；必填条件与默认值请对照模块，不将未验证信息标为完整响应示例。

参数模块中的读取/默认表达式
contentcontent: query.content,
idthreadId: resourceTypeMap[query.type] + query.id,
typethreadId: resourceTypeMap[query.type] + query.id,

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/comment/add' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/comment/delete​

（文档未收录）

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游模块读取的参数​

cid, id, type

该路径未匹配到上游独立说明段。字段来自已部署模块；必填条件与默认值请对照模块，不将未验证信息标为完整响应示例。

参数模块中的读取/默认表达式
cidcommentId: query.cid,
idthreadId: resourceTypeMap[query.type] + query.id,
typethreadId: resourceTypeMap[query.type] + query.id,

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/comment/delete' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/comment/like​

给评论点赞

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 传入 type, 资源 id, 和评论 id cid 和 是否点赞参数 t 即可给对 应评论点赞 ( 需要登录 )

必选参数 : id : 资源 id, 如歌曲 id,mv id

cid : 评论 id

t : 是否点赞 , 1 为点赞 ,0 为取消点赞

type: 数字 , 资源类型 , 对应歌曲 , mv, 专辑 , 歌单 , 电台, 视频对应以下类型

0: 歌曲

1: mv

2: 歌单

3: 专辑

4: 电台节目

5: 视频

6: 动态

7: 电台

接口地址 : /comment/like

调用例子 : /comment/like?id=29178366&cid=12840183&t=1&type=0 对应给 https://music.163.com/#/song?id=29178366 最热门的评论点赞

注意： 动态点赞不需要传入 id 参数，需要传入动态的 threadId 参数,如：/comment/like?type=6&cid=1419532712&threadId=A_EV_2_6559519868_32953014&t=0， threadId 可通过 /event，/user/event 接口获取

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/comment/like' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/comment/reply​

（文档未收录）

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游模块读取的参数​

cid, content, id, type

该路径未匹配到上游独立说明段。字段来自已部署模块；必填条件与默认值请对照模块，不将未验证信息标为完整响应示例。

参数模块中的读取/默认表达式
cidcommentId: query.cid,
contentcontent: query.content,
idthreadId: resourceTypeMap[query.type] + query.id,
typethreadId: resourceTypeMap[query.type] + query.id,

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/comment/reply' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/comment/report​

举报评论

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口, 传入歌曲 id 和评论 id, 举报评论

必选参数 :

id: 歌曲 id

cid: 评论 id

reason: 举报理由

接口地址 : /comment/report

*调用例子 : /comment/report?id=2058263032&cid=123456789&reason=人身攻击

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/comment/report' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/daily_signin​

签到

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 传入签到类型 ( 可不传 , 默认安卓端签到 ), 可签到 ( 需要登录 ), 其中安卓端签到可获得 3 点经验 , web/PC 端签到可获得 2 点经验

可选参数 : type: 签到类型 , 默认 0, 其中 0 为安卓端签到 ,1 为 web/PC 签到

接口地址 : /daily_signin

调用例子 : /daily_signin

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/daily_signin' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/device/kickoff​

强制下线设备

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 登录后调用此接口, 传入设备 id, 可强制下线设备的登录会话

必选参数 : key: 设备的 deviceKey, 可通过 /device/list 获取

captcha: 安全验证码, 可通过 /captcha/safe/sent 获取

接口地址 : /device/kickoff

调用例子 : /device/kickoff?key=00ALDFGEXXXXXXXXXXXXXXXXX&captcha=1234

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/device/kickoff' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/deviceinfo/center/upload​

上报设备中心设备名称

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 登录后调用此接口, 传入 deviceName, 可修改当前设备在网易云登录设备管理列表里显示的名称

必选参数 : deviceName: 期望展示的设备名称

name: deviceName 的兼容别名, 二选一即可

接口地址 : /deviceinfo/center/upload

调用例子 : /deviceinfo/center/upload?deviceName=XXXXX

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/deviceinfo/center/upload' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/digitalAlbum/ordering​

购买数字专辑

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 ,可获取购买数字专辑的地址,把地址生成二维码后,可扫描购买专辑

必选参数 :

id : 专辑的 id

payment : 支付方式， 0 为支付宝 3 为微信

quantity : 购买的数量

接口地址 : /digitalAlbum/ordering

调用例子 : /digitalAlbum/ordering?id=86286082&payment=3&quantity=1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/digitalAlbum/ordering' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/dj/difm/channel/subscribe​

DIFM电台 - 收藏频道

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 调用此接口, 可收藏DIFM频道

必选参数 :

id: 频道id

接口地址: /dj/difm/channel/subscribe

调用例子: /dj/difm/channel/subscribe?id=1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/dj/difm/channel/subscribe' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/dj/difm/channel/unsubscribe​

DIFM电台 - 取消收藏频道

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 调用此接口, 可取消收藏DIFM频道

必选参数 :

id: 频道id

接口地址: /dj/difm/channel/unsubscribe

调用例子: /dj/difm/channel/unsubscribe?id=1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/dj/difm/channel/unsubscribe' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/dj/sub​

电台 - 订阅

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 传入rid, 可订阅 dj,dj 的 rid 可通过搜索指定 type='1009' 获取其 id, 如/search?keywords= 代码时间 &type=1009

必选参数 : rid: 电台 的 id

接口地址 : /dj/sub

调用例子 : /dj/sub?rid=336355127&t=1 ( 对应关注 ' 代码时间 ') /dj/sub?rid=336355127&t=0 ( 对应取消关注 ' 代码时间 ')

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/dj/sub' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/event/del​

删除用户动态

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 ,可以删除用户动态

必选参数 : evId : 动态 id

接口地址 : /event/del

调用例子 : /event/del?evId=6712917601

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/event/del' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/event/forward​

转发用户动态

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 ,可以转发用户动态

必选参数 : uid : 用户 id

evId : 动态 id

forwards : 转发的评论

接口地址 : /event/forward

调用例子 : /event/forward?evId=6712917601&uid=32953014&forwards=测试内容

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/event/forward' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/event/privacy​

修改动态可见权限

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口，可以修改当前账号本人发布的单条动态的可见权限。此接口只负责一次原子修改；上游没有批量修改接口。如需批量操作，可先调用 /user/event/all 并按 privacySetting 筛选，再由调用方逐条调用本接口，同时自行处理限速、失败重试和部分成功。

必选参数 : evId : 动态 id

privacy : 目标可见权限。0 为所有人，1 为我关注的人，2 为仅自己，6 为互相关注的人

接口地址 : /event/privacy

调用例子 : /event/privacy?evId=6712917601&privacy=0

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/event/privacy' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/fm_trash​

垃圾桶

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 传入音乐 id, 可把该音乐从私人 FM 中移除至垃圾桶

必选参数 : id: 歌曲 id

接口地址 : /fm_trash

调用例子 : /fm_trash?id=347230

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/fm_trash' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/follow​

关注/取消关注用户

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 传入用户 id, 和操作 t,可关注/取消关注用户

必选参数 :

id : 用户 id

t : 1为关注,其他为取消关注

接口地址 : /follow

调用例子 : /follow?id=32953014&t=1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/follow' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/hug/comment​

抱一抱评论

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口,可抱一抱评论

必选参数 :

uid: 用户 id

cid: 评论 id

sid: 资源 id

接口地址 : /hug/comment

调用例子 : /hug/comment?uid=285516405&cid=1167145843&sid=863481066

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/hug/comment' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/like​

喜欢音乐

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 传入音乐 id, 可喜欢该音乐

必选参数 : id: 歌曲 id

可选参数 : like: 布尔值 , 默认为 true 即喜欢 , 若传 false, 则取消喜欢

接口地址 : /like

调用例子 : /like?id=347230

喜欢成功则返回数据的 code 为 200, 其余为失败

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/like' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/like/v1​

喜欢音乐 - 新版

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 调用此接口 , 传入音乐 id, 可喜欢该音乐

必选参数 : id: 歌曲 id

可选参数 : like: 布尔值 , 默认为 true 即喜欢 , 若传 false, 则取消喜欢

接口地址 : /like/v1

调用例子 : /like/v1?id=347230

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/like/v1' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/middle/play/do/lottery​

云小编 - 每日抽奖

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 登录后调用此接口, 消耗 200 积分进行抽奖, 每日最多抽 3 次

注意: 抽奖失败也消耗每日次数, 请先调用 /rep/ugc/user/get 查询可用积分

可选参数:

activityId: 活动 ID, 默认 6501202

drawCount: 未知, 默认 1

checkToken: 易盾反作弊 Token, 默认自动获取

接口地址: /middle/play/do/lottery

调用例子: /middle/play/do/lottery?activityId=6501202&drawCount=1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/middle/play/do/lottery' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/msg/forwards​

通知 - @我

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 ,可获取@我数据

可选参数 :

limit : 返回数量 , 默认为 30

offset : 偏移数量，用于分页 , 如 :( 页数 -1)*30, 其中 30 为 limit 的值 , 默认为 0

接口地址 : /msg/forwards

调用例子 : /msg/forwards?limit=3

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/msg/forwards' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/musician/cloudbean/obtain​

领取云豆

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 音乐人登录后调用此接口 , 可领取已完成的音乐人任务的云豆奖励

必选参数 : id : 任务 id，通过/musician/tasks获取到的userMissionId即为任务 id

period : 通过/musician/tasks获取

接口地址 : /musician/cloudbean/obtain

调用例子 : /musician/cloudbean/obtain?id=7036416928&period=1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/musician/cloudbean/obtain' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/musician/sign​

音乐人签到

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 音乐人登录后调用此接口，可以完成“登录音乐人中心”任务，然后通过/musician/cloudbean/obtain接口可以领取相应的云豆。

接口地址 : /musician/sign

调用例子 : /musician/sign

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/musician/sign' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/mv/sub​

收藏/取消收藏 MV

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口,可收藏/取消收藏 MV

必选参数 :

mvid : MV id

t : 1 为收藏,其他为取消收藏

接口地址 : /mv/sub

调用例子 : /mv/sub

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/mv/sub' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/cover/update​

歌单封面上传

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,使用'Content-Type': 'multipart/form-data'上传图片 formData(name 为'imgFile'),可更新歌单封面(参考:https://github.com/neteasecloudmusicapienhanced/api-enhanced/blob/main/public/playlist_cover_update.html)

必选参数 : id: 歌单 id 3143833470

可选参数 :

imgSize : 图片尺寸,默认为 300

imgX : 水平裁剪偏移,方形图片可不传,默认为 0 imgY : 垂直裁剪偏移,方形图片可不传,默认为 0

接口地址 : /playlist/cover/update

调用例子 : /playlist/cover/update?id=3143833470&imgSize=200

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/cover/update' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/create​

新建歌单

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 传入歌单名字可新建歌单

必选参数 : name : 歌单名

可选参数 :

privacy : 是否设置为隐私歌单，默认否，传'10'则设置成隐私歌单

type : 歌单类型,默认'NORMAL',传 'VIDEO'则为视频歌单,传 'SHARED'则为共享歌单

接口地址 : /playlist/create

调用例子 : /playlist/create?name=测试歌单,/playlist/create?name=test&type=VIDEO

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/create' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/delete​

删除歌单

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 传入歌单 id 可删除歌单

必选参数 : id : 歌单 id,可多个,用逗号隔开

接口地址 : /playlist/delete

调用例子 : /playlist/delete?id=2947311456 , /playlist/delete?id=5013464397,5013427772

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/delete' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/desc/update​

更新歌单描述

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,可以单独更新用户歌单描述

必选参数 :

id:歌单id

desc:歌单描述

接口地址 : /playlist/desc/update

调用例子 : /playlist/desc/update?id=24381616&desc=描述

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/desc/update' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/import/name/task/create​

歌单导入 - 元数据/文字/链接导入

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口, 支持通过元数据/文字/链接三种方式生成歌单; 三种方式不可同时调用

接口地址 : /playlist/import/name/task/create

可选参数 :

importStarPlaylist : 是否导入我喜欢的音乐, 此项为 true 则不生成新的歌单 playlistName : 生成的歌单名, 仅文字导入和链接导入支持, 默认为'导入音乐 '.concat(new Date().toLocaleString())

元数据导入 :

local: json 类型的字符串, 如：

let local = encodeURIComponent(
  JSON.stringify([
    {
      name: 'アイニーブルー', // 歌曲名称
      artist: 'ZLMS', // 艺术家名称
      album: 'アイニーブルー', // 专辑名称
    },
    {
      name: 'ファンタズマ',
      artist: 'sasakure.UK',
      album: '未来イヴ',
    },
  ]),
)

调用例子 : /playlist/import/name/task/create?local=${local}

文字导入 :

text: 导入的文字, 如：

let text = encodeURIComponent(`アイニーブルー ZLMS
ファンタズマ sasakure.UK`)

调用例子 : /playlist/import/name/task/create?text=${text}

链接导入 :

link: 存有歌单链接的数组类型的字符串, 如：

let link = encodeURIComponent(
  JSON.stringify([
    'https://i.y.qq.com/n2/m/share/details/taoge.html?id=7716341988&hosteuin=',
    'https://i.y.qq.com/n2/m/share/details/taoge.html?id=8010042041&hosteuin=',
  ]),
)

歌单链接来源:

  1. 将歌单分享到微信/微博/QQ 后复制链接
  2. 直接复制歌单/个人主页链接
  3. 直接复制文章链接

调用例子 : /playlist/import/name/task/create?link=${link}

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/import/name/task/create' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/name/update​

更新歌单名

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,可以单独更新用户歌单名

必选参数 :

id: 歌单id

name: 歌单名

接口地址 : /playlist/name/update

调用例子 : /playlist/name/update?id=24381616&name=歌单名

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/name/update' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/order/update​

调整歌单顺序

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,可以根据歌单 id 顺序调整歌单顺序

必选参数 :

ids: 歌单 id 列表

接口地址 : /playlist/order/update

调用例子 : /playlist/order/update?ids=[111,222]

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/order/update' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/privacy​

公开隐私歌单

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 可以调用此接口将当前用户的隐私歌单公开。

必选参数 : id : 歌单 ID

接口地址 : /playlist/privacy

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/privacy' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/subscribe​

收藏/取消收藏歌单

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 传入类型和歌单 id 可收藏歌单或者取消收藏歌单

必选参数 :

t : 类型,1:收藏,2:取消收藏

id : 歌单 id

接口地址 : /playlist/subscribe

调用例子 : /playlist/subscribe?t=1&id=106697785 /playlist/subscribe?t=2&id=106697785

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/subscribe' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/tags/update​

更新歌单标签

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,可以单独更新用户歌单标签

必选参数 :

id: 歌单id

tags: 歌单标签

接口地址 : /playlist/tags/update

调用例子 : /playlist/tags/update?id=24381616&tags=学习

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/tags/update' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/track/add​

收藏视频到视频歌单

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 可收藏视频到视频歌单 ( 需要登录 )

必选参数 :

pid : 歌单 id

ids : 视频 id,支持多个,用,隔开

接口地址 : /playlist/track/add

调用例子 : /playlist/track/add?pid=5271999357&ids=186041

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/track/add' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/track/delete​

删除视频歌单里的视频

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 可删除视频歌单里的视频 ( 需要登录 ) 必选参数 :

pid : 歌单 id

ids : 视频 id,支持多个,用,隔开

接口地址 : /playlist/track/delete

调用例子 : /playlist/track/delete?pid=5271999357&ids=186041

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/track/delete' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/tracks​

对歌单添加或删除歌曲

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 可以添加歌曲到歌单或者从歌单删除某首歌曲 ( 需要登录 )

!> 警告: 在v4.29.7版本后, 在网易云登陆后请求要带上timestamp字段, 否则会导致请求不合法

必选参数 :

op: 从歌单增加单曲为 add, 删除为 del

pid: 歌单 id tracks: 歌曲 id,可多个,用逗号隔开

接口地址 : /playlist/tracks

调用例子 : /playlist/tracks?op=add&pid=24381616&tracks=347231 ( 对应把歌曲添加到 ' 我 ' 的歌单 , 测试的时候请把这里的 pid 换成你自己的, id 和 tracks 不对可能会报 502 错误)

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/tracks' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/update​

更新歌单

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,可以更新用户歌单

必选参数 :

id:歌单id

name:歌单名字

desc:歌单描述

tags:歌单tag ,多个用 `;` 隔开,只能用官方规定标签

接口地址 : /playlist/update

调用例子 : /playlist/update?id=24381616&name=新歌单&desc=描述&tags=欧美

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/update' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/playlist/update/playcount​

歌单更新播放量

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用后可更新歌单播放量

必选参数 : id : 歌单 id

接口地址 : /playlist/update/playcount

调用例子 : /playlist/update/playcount?id=24381616

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/playlist/update/playcount' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/recommend/songs/dislike​

每日推荐歌曲-不感兴趣

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 1。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 日推歌曲标记为不感兴趣( 同时会返回一个新推荐歌曲, 需要登录 )

必选参数 : id: 歌曲 id

接口地址 : /recommend/songs/dislike

调用例子 : /recommend/songs/dislike?id=168091

返回数据 :

{
  "data":{
    "name":"破碎太阳之心",
    "id":2009592201,
    "position":0,
    "alias":[],
    ...
  },
  "code":200
}

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/recommend/songs/dislike' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/relay/play/state/submit​

提交歌曲播放状态

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口可提交歌曲播放状态，支持会话追踪和播放模式记录，未传入 sessionId 时后端会自动生成

必选参数 : id: 歌曲 id

可选参数 : sessionId: 播放会话 ID（12 位大写字母和数字），不传则自动生成, progress: 播放进度（秒），默认 0, playMode: 播放模式，默认 list_loop, type: 资源类型，默认 song

接口地址 : /relay/play/state/submit

调用例子 : /relay/play/state/submit?id=518066366&progress=30

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/relay/play/state/submit' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/rep/ugc/activity/collect​

云小编 - 领取任务积分

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 完成任务后调用此接口, 领取云小编任务积分

可选参数:

activityId: 活动 ID, 调用 /rep/ugc/activity/get 获取, 默认 5001

接口地址: /rep/ugc/activity/collect

调用例子: /rep/ugc/activity/collect?activityId=5001

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/rep/ugc/activity/collect' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/rep/ugc/exam/start​

（文档未收录）

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游模块读取的参数​

examType

该路径未匹配到上游独立说明段。字段来自已部署模块；必填条件与默认值请对照模块，不将未验证信息标为完整响应示例。

参数模块中的读取/默认表达式
examTypeif (!query.examType) ; examType: query.examType,

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/rep/ugc/exam/start' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/rep/ugc/exam/submit​

（文档未收录）

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游模块读取的参数​

answer, examType, questionId, taskId

该路径未匹配到上游独立说明段。字段来自已部署模块；必填条件与默认值请对照模块，不将未验证信息标为完整响应示例。

参数模块中的读取/默认表达式
answerif (!query.examType || !query.taskId || !query.questionId || !query.answer) ; answer: query.answer,
examTypeif (!query.examType || !query.taskId || !query.questionId || !query.answer) ; examType: query.examType,
questionIdif (!query.examType || !query.taskId || !query.questionId || !query.answer) ; questionId: query.questionId,
taskIdif (!query.examType || !query.taskId || !query.questionId || !query.answer) ; taskId: query.taskId,

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/rep/ugc/exam/submit' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/rep/ugc/user/collect-vip​

云小编 - 领取一日会员

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 达成领取条件 (/rep/ugc/user/vip) 后调用此接口, 领取一日会员

可选参数:

activityId: 活动 ID, 调用 /rep/ugc/activity/get 获取, 默认 5001

接口地址: /rep/ugc/user/collect-vip

调用例子: /rep/ugc/user/collect-vip?activityId=5001

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/rep/ugc/user/collect-vip' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/rep/ugc/user/sign​

云小编 - 每日签到

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 登录后调用此接口, 进行云小编签到, 领取 5 积分, 签到后 /rep/ugc/user/get 返回 data.signed = 1

接口地址: /rep/ugc/user/sign

调用例子: /rep/ugc/user/sign

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/rep/ugc/user/sign' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/resource/like​

资源点赞( MV,电台,视频)

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 可对 MV,电台,视频点赞

必选参数 :

type:资源类型,对应以下类型

0: 歌曲

1: mv

2: 歌单

3: 专辑

4: 电台节目

5: 视频

6: 动态

7: 电台

t: 操作,1 为点赞,其他为取消点赞

id: 资源 id

接口地址 : /resource/like

调用例子 : /resource/like?t=1&type=1&id=5436712

注意：如给动态点赞，不需要传入 id，需要传入 threadId,可通过 event,/user/event 接口获取，如： /resource/like?t=1&type=6&threadId=A_EV_2_6559519868_32953014

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/resource/like' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/sati/resource/sub​

助眠解压 - 收藏

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 调用此接口, 收藏声音

必选参数 :

id: id, /sati/tag/list接口返回的trackId

可选参数 :

cancel: 是否取消收藏, 默认不取消

接口地址: /sati/resource/sub

调用例子: /sati/resource/sub?id=167003

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/sati/resource/sub' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/sati/resource/sub/list​

助眠解压 - 收藏列表

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 调用此接口, 获取收藏列表

接口地址: /sati/resource/sub/list

调用例子: /sati/resource/sub/list

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/sati/resource/sub/list' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/scrobble​

听歌打卡

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 传入音乐 id, 来源 id，歌曲时间 time，更新听歌排行数据

必选参数 : id: 歌曲 id, sourceid: 歌单或专辑 id

可选参数 : time: 歌曲播放时间,单位为秒

接口地址 : /scrobble

调用例子 : /scrobble?id=518066366&sourceid=36780169&time=291

听歌打卡 V2 (NCBL 加密版)​

说明 : 调用此接口，使用桌面客户端 NCBL 加密日志格式上报听歌记录

必选参数 : id: 歌曲 id, time: 播放时长(秒)

可选参数 : sourceid: 来源列表 id, source: 来源名称(默认 list), name: 歌曲名, artist: 艺术家, bitrate: 码率(默认 320), level: 音质等级(默认 exhigh), total: 歌曲总时长(秒)

接口地址 : /scrobble/v1

调用例子 : /scrobble/v1?id=518066366&sourceid=36780169&time=291

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/scrobble' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/scrobble/v1​

听歌打卡

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 传入音乐 id, 来源 id，歌曲时间 time，更新听歌排行数据

必选参数 : id: 歌曲 id, sourceid: 歌单或专辑 id

可选参数 : time: 歌曲播放时间,单位为秒

接口地址 : /scrobble

调用例子 : /scrobble?id=518066366&sourceid=36780169&time=291

听歌打卡 V2 (NCBL 加密版)​

说明 : 调用此接口，使用桌面客户端 NCBL 加密日志格式上报听歌记录

必选参数 : id: 歌曲 id, time: 播放时长(秒)

可选参数 : sourceid: 来源列表 id, source: 来源名称(默认 list), name: 歌曲名, artist: 艺术家, bitrate: 码率(默认 320), level: 音质等级(默认 exhigh), total: 歌曲总时长(秒)

接口地址 : /scrobble/v1

调用例子 : /scrobble/v1?id=518066366&sourceid=36780169&time=291

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/scrobble/v1' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/send/album​

发送私信(带专辑)

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 传入用户 id 和要发送的信息,专辑 id, 可以发送专辑私信,返回内容为消息 id

必选参数 :

user_ids : 用户 id,多个需用逗号隔开

id : 要发送专辑的 id

msg : 要发送的信息

接口地址 : /send/album

调用例子 : /send/album?user_ids=1&id=351318&msg=测试

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/send/album' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/send/playlist​

发送私信(带歌单)

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 传入用户 id 和要发送的信息和歌单 id, 可以发送带歌单的私信(注:不能发送重复的歌单)

必选参数 :

user_ids : 用户 id,多个需用逗号隔开

msg : 要发送的信息

接口地址 : /send/playlist

调用例子 : /send/playlist?msg=test&user_ids=475625142&playlist=705123491,/send/playlist?msg=test2&user_ids=475625142,32953014&playlist=705123493

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/send/playlist' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/send/song​

发送私信(带歌曲)

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 传入用户 id 和要发送的信息,音乐 id, 可以发送音乐私信,返回内容为历史私信

必选参数 :

user_ids : 用户 id,多个需用逗号隔开

id : 要发送音乐的 id

msg : 要发送的信息

接口地址 : /send/song

调用例子 : /send/song?user_ids=1&id=351318&msg=测试

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/send/song' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/send/text​

发送私信

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 传入用户 id 和要发送的信息, 可以发送私信,返回内容为历史私信,包含带歌单的私信信息(注:不能发送私信给自己)

必选参数 :

user_ids : 用户 id,多个需用逗号隔开

msg : 要发送的信息

接口地址 : /send/text

调用例子 : /send/text?user_ids=32953014&msg=test,/send/text?user_ids=32953014,475625142&msg=test

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/send/text' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/share/resource​

分享文本、歌曲、歌单、mv、电台、电台节目到动态

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 ,可以分享文本、歌曲、歌单、mv、电台、电台节目,专辑到动态

必选参数 : id : 资源 id （歌曲，歌单，mv，电台，电台节目对应 id）

可选参数 : type: 资源类型，默认歌曲 song，可传 song,playlist,mv,djradio,djprogram, album

msg: 内容，140 字限制，支持 emoji，@用户名（/user/follows接口获取的用户名，用户名后和内容应该有空格），图片暂不支持

接口地址 : /share/resource

调用例子 : /share/resource?id=1297494209&msg=测试 /share/resource?type=djradio&id=336355127 /share/resource?type=djprogram&id=2061034798 /share/resource?type=djprogram&id=2061034798&msg=测试@binaryify 测试 /share/resource?type=noresource&msg=测试

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/share/resource' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/sign/happy/info​

乐签信息

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口, 可获取乐签信息

接口地址 : /sign/happy/info

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/sign/happy/info' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/signin/progress​

签到进度

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口 , 可获得签到进度

可选参数 : moduleId : 模块 id，默认为 '1207signin-1207signin'

接口地址 : /signin/progress

调用例子 : /signin/progress?moduleId=1207signin-1207signin

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/signin/progress' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/song/like​

喜欢歌曲 - 新版

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口, 传入歌曲 id 用户id和喜欢状态, 可喜欢/取消喜欢歌曲

必选参数 :

id: 歌曲 id uid: 用户 id like: 喜欢状态, true 表示喜欢, false 表示取消喜欢

接口地址 : /song/like

调用例子 : /song/like?id=2058263032&uid=32953014&like=true

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/song/like' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/song/lyrics/mark/add​

歌词摘录 - 添加/修改摘录歌词

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 登录后调用此接口, 传入歌曲 id, 可以添加/修改摘录歌词

必选参数：

id: 歌曲 id

data: 存储歌词摘录信息的对象数组的字符串，如:

let data = encodeURIComponent(
  JSON.stringify([
    {
      translateType: 1,
      startTimeStamp: 800,
      translateLyricsText: '让我逃走吧、声音已经枯萎',
      originalLyricsText: '逃がし てくれって声を枯らした',
    },
  ]),
)

若需要修改摘录信息, 则需要填入参数markId, 修改对应的摘录信息

接口地址: /song/lyrics/mark/add

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/song/lyrics/mark/add' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/song/lyrics/mark/del​

歌词摘录 - 删除摘录歌词

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 登录后调用此接口, 传入摘录歌词 id, 删除摘录歌词

必选参数：

id: 摘录歌词 id

接口地址: /song/lyrics/mark/del

调用例子: /song/lyrics/mark?id=2083850

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/song/lyrics/mark/del' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/song/order/update​

调整歌曲顺序

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 2。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口,可以根据歌曲 id 顺序调整歌曲顺序

必选参数 : pid: 歌单 id

ids: 歌曲 id 列表

接口地址 : /song/order/update

调用例子 : /song/order/update?pid=2039116066&ids=[5268328,1219871]

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/song/order/update' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/thinktank/audit/resource/update​

云小编 - 提交任务

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

注意: 投票结果会在后台审核, 一致 +3 积分, 不一致 -2 积分

可选参数:

type: 任务类型, 1: 歌曲曲风审核, 2: 歌曲语种审核, 3: 歌曲原唱审核, 4: 情绪标签审核, 默认 4

必选参数:

taskId: 任务 ID, 调用 /thinktank/audit/resource/detail 获取 data.taskId

judgement: 审核结果, 1: 同意, 2: 否决, 3: 跳过 (不算次数)

接口地址: /thinktank/audit/resource/update

调用例子: /thinktank/audit/resource/update?type=4&taskId=123456&judgement=1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/thinktank/audit/resource/update' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/topic/sublist​

收藏的专栏

权限层级 T2 · 网关缓存 3600 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口,可获取收藏的专栏

可选参数 :

limit: 取出歌单数量 , 默认为 50

offset: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)*50, 其中 50 为 limit 的值

接口地址 : /topic/sublist

调用例子 : /topic/sublist?limit=2&offset=1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/topic/sublist' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/user/binding​

获取用户绑定信息

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 可以获取用户绑定信息

必选参数 : uid : 用户 id

接口地址 : /user/binding

调用例子 : /user/binding?uid=32953014

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/user/binding' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/user/cloud/del​

云盘歌曲删除

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 可删除云盘歌曲

必选参数 : id: 歌曲 id,可多个,用逗号隔开

接口地址 : /user/cloud/del

调用例子 : /user/cloud/del

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/user/cloud/del' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/user/social/status/edit​

用户状态 - 编辑

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口, 编辑当前用户状态， 所需参数可在接口/user/social/status/support获取

接口地址 : /user/social/status/edit

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/user/social/status/edit' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/user/subcount​

获取用户信息 , 歌单，收藏，mv, dj 数量

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 可以获取用户信息

接口地址 : /user/subcount

调用例子 : /user/subcount

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/user/subcount' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/user/update​

更新用户信息

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 4。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 传入相关信息,可以更新用户信息

必选参数 :

gender: 性别 0:保密 1:男性 2:女性

birthday: 出生日期,时间戳 unix timestamp

nickname: 用户昵称

province: 省份id

city: 城市id

signature：用户签名

接口地址 : /user/update

调用例子 : /user/update?gender=0&signature=测试签名&city=440300&nickname=binary&birthday=1525918298004&province=440000

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/user/update' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/video/sub​

收藏视频

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 3。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 调用此接口,可收藏视频

必选参数 :

id : 视频 id

t : 1 为收藏,其他为取消收藏

接口地址 : /video/sub

调用例子 : /video/sub

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/video/sub' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/vip/growthpoint/get​

领取 vip 成长值

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 可获取已完成的会员任务的成长值奖励

必选参数 : ids : 通过/vip/tasks获取到的unGetIds

接口地址 : /vip/growthpoint/get

调用例子 : /vip/growthpoint/get?ids=7043206830_7 /vip/growthpoint/get?ids=8613118351_1,8607552957_1

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/vip/growthpoint/get' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/vip/growthpoint/getall​

一键领取所有 vip 成长值

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 一键领取所有已完成的会员任务成长值奖励

接口地址 : /vip/growthpoint/getall

调用例子 : /vip/growthpoint/getall

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/vip/growthpoint/getall' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/vip/sign​

黑胶乐签打卡

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 登录后调用此接口, 进行黑胶乐签打卡

接口地址: /vip/sign

调用例子: /vip/sign

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/vip/sign' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/voice/delete​

播客删除

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 可以删除播客

接口地址: /voice/delete

必选参数：

ids: 播客 id，即 voiceListId,多个以逗号隔开

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/voice/delete' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/voice/upload​

播客上传声音

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 登录后调用此接口,使用'Content-Type': 'multipart/form-data'上传声音文件 formData(name 为songFile),可通过 formData(name 为imgFile)同时上传声音封面。例子在 /public/voice_upload.html 访问地址: /voice_upload.html

接口地址: /voice/upload

必选参数：

songFile: 声音文件

voiceListId: 播客 id

categoryId: 分类 id

secondCategoryId: 次级分类 id

description: 声音介绍

可选参数：

imgFile: 声音封面图片文件,上传后会自动生成图片 id。与coverImgId同时传入时,优先使用imgFile

coverImgId: 已上传的声音封面图片 id,未传入imgFile时使用该值

songName: 声音名称

privacy: 设为隐私声音,播客如果是隐私播客,则必须设为 1

publishTime: 默认立即发布,定时发布的话需传入时间戳

autoPublish: 是否发布动态,是则传入 1

autoPublishText: 动态文案

orderNo: 排序,默认为 1

composedSongs: 包含歌曲(歌曲 id),多个用逗号隔开

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/voice/upload' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/voicelist/trans​

播客声音排序

权限层级 T2 · 网关缓存 600 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明: 调整声音在列表中的顺序, 每个声音都有固定的序号, 例如将 4 的声音移动到 1 后, 原来的 1、2、3 增加为 2、3、4, 其他不变

接口地址: /voicelist/trans

必选参数： limit: 取出歌单数量 , 默认为 200

offset: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)*200, 其中 200 为 limit 的值

position: 位置, 最小为 1, 最大为歌曲数量, 超过最大则为移动到最底, 小于 1 报错

programId: 播客声音 id, 即 voiceId

radioId: 电台 id, 即 voiceListId

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/voicelist/trans' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/yunbei/rcmd/song​

云贝推歌

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口 , 传入歌曲 id, 可以进行云贝推歌

必选参数 : id : 歌曲 id

可选参数 : reason : 推歌理由

yunbeiNum: 云贝数量,默认 10

接口地址 : /yunbei/rcmd/song

调用例子 : /yunbei/rcmd/song?id=65528 /yunbei/rcmd/song?id=65528&reason=人间好声音推荐给你听

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/yunbei/rcmd/song' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/yunbei/sign​

云贝签到

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 : 登录后调用此接口可进行云贝签到

接口地址 : /yunbei/sign

调用例子 : /yunbei/sign

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/yunbei/sign' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/yunbei/task/finish​

云贝完成任务

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

必选参数 :

userTaskId : 任务 id

可选参数 :

depositCode: 任务 depositCode

接口地址 : /yunbei/task/finish

调用例子 : /yunbei/task/finish?userTaskId=5146243240&depositCode=0

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/yunbei/task/finish' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。

/cm/ncm/yunbei/task/finish/v1​

云贝广告任务 - 完成任务领取云贝

权限层级 T2 · 网关缓存 0 秒 · 登记阶段 5。

写操作请使用 POST、CurrentMusic Bearer、有效网易云绑定，并在 JSON 中传 confirm: true；confirm 也可按网关约定传 1。不要用 GET 发起写操作。

上游参数与业务说明​

下述来自已部署上游版本。原始路径与 Cookie 登录说明属于上游；本站统一加 /cm/ncm 前缀，禁止传 Cookie、token、realIP、randomCNIP 等保留参数。

说明 :登录后调用此接口可完成任务并领取云贝。实测仅需传 yunbeiAmount（单次云贝数，客户端从 list 接口的 singleAmount 取值，当前为 150）即可成功领取，无需真实听歌/看视频。单日上限 10 次 × 150 = 1500 云贝/天，超限返回 code:400 "单日完成任务数已达上限"。建议领取前先调用 /yunbei/task/list/v1 查询今日剩余次数。

可选参数 : yunbeiAmount: 单次云贝数，默认为 150

接口地址 : /yunbei/task/finish/v1

调用例子 : /yunbei/task/finish/v1?yunbeiAmount=150

调用模板​

curl --request POST 'https://music.20110208.xyz/cm/ncm/yunbei/task/finish/v1' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"confirm":true}'

模板须补齐该接口的业务参数；T3 模板不表示可经泛化网关调用。响应结构由上游接口决定，项目专用封装见自有路由。