跳到主要内容

网易云代理 T0

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

/cm/ncm/ad/get​

获取广告

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口, 可获取广告

接口地址 : /ad/get

调用例子 : /ad/get

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/ad/get'

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

/cm/ncm/album​

获取专辑内容

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入专辑 id, 可获得专辑内容

必选参数 : id: 专辑 id

接口地址 : /album

调用例子 : /album?id=32311

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/album'

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

/cm/ncm/album/detail​

数字专辑详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 ,传入数字专辑 id 可获取数字专辑详情(和歌单详情有差异)

接口地址 : /album/detail

调用例子 : /album/detail?id=84547195

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/album/detail'

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

/cm/ncm/album/detail/dynamic​

专辑动态信息

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入专辑 id, 可获得专辑动态信息,如是否收藏,收藏数,评论数,分享数

必选参数 : id: 专辑 id

接口地址 : /album/detail/dynamic

调用例子 : /album/detail/dynamic?id=32311

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/album/detail/dynamic'

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

/cm/ncm/album/list​

数字专辑-新碟上架

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 ,可获取数字专辑-新碟上架

可选参数 :

limit : 返回数量 , 默认为 30

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

调用例子 : /album/list?limit=10

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/album/list'

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

/cm/ncm/album/list/style​

数字专辑-语种风格馆

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 ,可获取语种风格馆数字专辑列表

可选参数 :

limit : 返回数量 , 默认为 30

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

area 地区 Z_H:华语,E_A:欧美,KR:韩国,JP:日本

接口地址 : /album/list/style

调用例子 : /album/list/style?area=Z_H&offset=2

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/album/list/style'

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

/cm/ncm/album/new​

全部新碟

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口 ,可获取全部新碟

可选参数 :

limit : 返回数量 , 默认为 30

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

area : ALL:全部,ZH:华语,EA:欧美,KR:韩国,JP:日本

接口地址 : /album/new

调用例子 : /album/new?area=KR&limit=10

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/album/new'

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

/cm/ncm/album/newest​

最新专辑

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 ，获取云音乐首页新碟上架数据

接口地址 : /album/newest

调用例子 : /album/newest

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/album/newest'

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

/cm/ncm/album/privilege​

获取专辑歌曲的音质

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用后可获取专辑歌曲的音质

必选参数 : id : 专辑 id

接口地址 : /album/privilege

调用例子 : /album/privilege?id=168223858

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/album/privilege'

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

/cm/ncm/album/songsaleboard​

（文档未收录）

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游模块读取的参数​

albumType, type, year

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

参数模块中的读取/默认表达式
albumTypealbumType: query.albumType || 0, //0为数字专辑,1为数字单曲
typeconst type = query.type || 'daily' // daily,week,year,total
yearyear: query.year,

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/album/songsaleboard'

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

/cm/ncm/artist/album​

获取歌手专辑

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌手 id, 可获得歌手专辑内容

必选参数 : id: 歌手 id

可选参数 : limit: 取出数量 , 默认为 30

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

接口地址 : /artist/album

调用例子 : /artist/album?id=6452&limit=5 ( 周杰伦 )

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/album'

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

/cm/ncm/artist/desc​

获取歌手描述

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌手 id, 可获得歌手描述

必选参数 : id: 歌手 id

接口地址 : /artist/desc

调用例子 : /artist/desc?id=6452 ( 周杰伦 )

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/desc'

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

/cm/ncm/artist/detail​

获取歌手详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌手 id, 可获得获取歌手详情

必选参数 : id: 歌手 id

接口地址 : /artist/detail

调用例子 : /artist/detail?id=11972054 (Billie Eilish)

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/detail'

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

/cm/ncm/artist/detail/dynamic​

歌手详情动态

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用后可获取歌手详情动态部分,如是否关注,视频数

必选参数 : id : 歌手 id

接口地址 : /artist/detail/dynamic

调用例子 : /artist/detail/dynamic?id=15396

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/detail/dynamic'

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

/cm/ncm/artist/fans​

歌手粉丝

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌手 id, 可获取歌手粉丝 必选参数 : id : 歌手 id

接口地址 : /artist/fans

调用例子 : /artist/fans?id=2116&limit=10&offset=0

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/fans'

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

/cm/ncm/artist/follow/count​

歌手粉丝数量

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌手 id, 可获取歌手粉丝数量

必选参数 : id : 歌手 id

可选参数 : limit: 取出粉丝数量 , 默认为 20

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

接口地址 : /artist/follow/count

调用例子 : /artist/follow/count?id=2116

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/follow/count'

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

/cm/ncm/artist/list​

歌手分类列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取歌手分类列表

可选参数 :

limit : 返回数量 , 默认为 30

offset : 偏移数量，用于分页 , 如 : 如 :( 页数 -1)*30, 其中 30 为 limit 的值 , 默认为 0 initial: 按首字母索引查找参数,如 /artist/list?type=1&area=96&initial=b 返回内容将以 name 字段开头为 b 或者拼音开头为 b 为顺序排列, 热门传-1,#传 0

type 取值:

-1:全部
1:男歌手
2:女歌手
3:乐队

area 取值:

-1:全部
7华语
96欧美
8:日本
16韩国
0:其他

接口地址 : /artist/list

调用例子 : /artist/list?type=1&area=96&initial=b /artist/list?type=2&area=2&initial=b

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/list'

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

/cm/ncm/artist/mv​

获取歌手 mv

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌手 id, 可获得歌手 mv 信息 , 具体 mv 播放地址可调 用/mv传入此接口获得的 mvid 来拿到 , 如 : /artist/mv?id=6452,/mv?mvid=5461064

必选参数 : id: 歌手 id, 可由搜索接口获得

接口地址 : /artist/mv

调用例子 : /artist/mv?id=6452

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/mv'

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

/cm/ncm/artist/songs​

歌手全部歌曲

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取歌手全部歌曲 必选参数 :

id : 歌手 id

可选参数 :

order : hot ,time 按照热门或者时间排序

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

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

接口地址 : /artist/songs

调用例子 : /artist/songs?id=6452

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/songs'

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

/cm/ncm/artist/top/song​

歌手热门 50 首歌曲

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取歌手热门 50 首歌曲

必选参数 :

id : 歌手 id

接口地址 : /artist/top/song

调用例子 : /artist/top/song?id=6452

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/top/song'

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

/cm/ncm/artist/video​

获取歌手视频

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌手 id, 可获得歌手视频

必选参数 : id : 歌手 id

可选参数 : size : 返回数量 , 默认为 10

cursor : 返回数据的 cursor, 默认为 0 , 传入上一次返回结果的 cursor,将会返回下一页的数据

order : 排序方法, 0 表示按时间排序, 1 表示按热度排序, 默认为 0

接口地址 : /artist/video

调用例子 : /artist/video?id=2116

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artist/video'

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

/cm/ncm/artists​

获取歌手单曲

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌手 id, 可获得歌手部分信息和热门歌曲

必选参数 : id: 歌手 id, 可由搜索接口获得

接口地址 : /artists

调用例子 : /artists?id=6452

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/artists'

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

/cm/ncm/audio/match​

听歌识曲

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 使用此接口,上传音频文件或者麦克风采集声音可识别对应歌曲信息,具体调用例子参考 /audio_match_demo/index.html (项目文件: public/audio_match_demo/index.html)

接口地址: /audio/match

必选参数：

duration: 音频时长,单位秒

audioFP: 音频指纹,参考项目调用例子获取

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/audio/match'

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

/cm/ncm/banner​

banner

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取 banner( 轮播图 ) 数据

可选参数 :

type:资源类型,对应以下类型,默认为 0 即 PC

0: pc

1: android

2: iphone

3: ipad

接口地址 : /banner

调用例子 : /banner, /banner?type=2

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/banner'

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

/cm/ncm/batch​

batch 批量请求接口

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口 ,传入接口和对应原始参数(原始参数非文档里写的参数,需参考源码),可批量请求接口

接口地址 : /batch

调用例子 : 使用 GET 方式:/batch?/api/v2/banner/get={"clientType":"pc"} 使用 POST 方式传入参数:{ "/api/v2/banner/get": {"clientType":"pc"} }

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/batch'

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

/cm/ncm/broadcast/category/region/get​

广播电台 - 分类/地区信息

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 获取广播电台 - 分类/地区信息

接口地址: /broadcast/category/region/get

调用例子: /broadcast/category/region/get

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/broadcast/category/region/get'

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

/cm/ncm/broadcast/channel/currentinfo​

广播电台 - 电台信息

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 传入电台 id, 获取广播电台 - 电台信息

必选参数：

id: 电台 id

接口地址: /broadcast/channel/currentinfo

调用例子: /broadcast/channel/currentinfo?id=5

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/broadcast/channel/currentinfo'

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

/cm/ncm/broadcast/channel/list​

广播电台 - 全部电台

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 获取广播电台 - 全部电台

可选参数 :

categoryId : 类别 id, 默认为 0，可从“广播电台 - 分类/地区信息”接口获取

regionId : 地区 id, 默认为 0，可从“广播电台 - 分类/地区信息”接口获取

接口地址: /broadcast/channel/list

调用例子: /broadcast/channel/list

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/broadcast/channel/list'

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

/cm/ncm/calendar​

音乐日历

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口,传入开始和结束时间,可获取音乐日历

接口地址 : /calendar

调用例子 : /calendar?startTime=1606752000000&endTime=1609430399999

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/calendar'

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

/cm/ncm/check/music​

音乐是否可用

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口,传入歌曲 id, 可获取音乐是否可用,返回 { success: true, message: 'ok' } 或者 { success: false, message: '亲爱的,暂无版权' }

必选参数 : id : 歌曲 id

可选参数 : br: 码率,默认设置了 999000 即最大码率,如果要 320k 则可设置为 320000,其他类推

接口地址 : /check/music

调用例子 : /check/music?id=1969519579

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/check/music'

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

/cm/ncm/cloudsearch​

搜索

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游模块读取的参数​

keywords, limit, offset, type

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

参数模块中的读取/默认表达式
keywordss: query.keywords,
limitlimit: query.limit || 30,
offsetoffset: query.offset || 0,
typetype: query.type || 1, // 1: 单曲, 10: 专辑, 100: 歌手, 1000: 歌单, 1002: 用户, 1004: MV, 1006: 歌词, 1009: 电台, 1014: 视频

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/cloudsearch'

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

/cm/ncm/comment/album​

专辑评论

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该专辑的所有评论 ( 不需要 登录 )

必选参数 : id: 专辑 id

可选参数 : limit: 取出评论数量 , 默认为 20

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

before: 分页参数,取上一页最后一项的 time 获取下一页数据(获取超过 5000 条评论的时候需要用到)

接口地址 : /comment/album

调用例子 : /comment/album?id=32311

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/album'

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

/cm/ncm/comment/dj​

电台节目评论

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该 电台节目 的所有评论 ( 不需要登录 )

必选参数 : id: 电台节目的 id

可选参数 : limit: 取出评论数量 , 默认为 20

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

before: 分页参数,取上一页最后一项的 time 获取下一页数据(获取超过 5000 条评论的时候需要用到)

接口地址 : /comment/dj

调用例子 : /comment/dj?id=794062371

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/dj'

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

/cm/ncm/comment/event​

获取动态评论

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口 , 可以获取动态下评论

必选参数 : threadId : 动态 id，可通过 /event，/user/event 接口获取

接口地址 : /comment/event

调用例子 : /comment/event?threadId=A_EV_2_6559519868_32953014

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/event'

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

/cm/ncm/comment/floor​

楼层评论

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入资源 parentCommentId 和资源类型 type 和资源 id 参数, 可获得该资源的歌曲楼层评论

必选参数 : parentCommentId: 楼层评论 id

id : 资源 id

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

0: 歌曲

1: mv

2: 歌单

3: 专辑

4: 电台节目

5: 视频

6: 动态

7: 电台

可选参数 : limit: 取出评论数量 , 默认为 20

time: 分页参数,取上一页最后一项的 time 获取下一页数据

接口地址 : /comment/floor

调用例子 : /comment/floor?parentCommentId=1438569889&id=29764564&type=0

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/floor'

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

/cm/ncm/comment/hot​

热门评论

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入 type, 资源 id 可获得对应资源热门评论 ( 不需要登录 )

必选参数 :

id : 资源 id

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

0: 歌曲

1: mv

2: 歌单

3: 专辑

4: 电台节目

5: 视频

6: 动态

7: 电台

可选参数 : limit: 取出评论数量 , 默认为 20

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

before: 分页参数,取上一页最后一项的 time 获取下一页数据(获取超过 5000 条评论的时候需要用到)

接口地址 : /comment/hot

调用例子 : /comment/hot?id=186016&type=0

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/hot'

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

/cm/ncm/comment/hug/list​

评论抱一抱列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取评论抱一抱列表

必选参数 :

uid: 用户 id

cid: 评论 id

sid: 资源 id

可选参数 :

page: 页数

cursor: 上一页返回的 cursor,默认-1,第一页不需要传

idCursor: 上一页返回的 idCursor,默认-1,第一页不需要传

pageSize : 每页页数,默认 100

接口地址 : /comment/hug/list

调用例子 : /comment/hug/list?uid=285516405&cid=1167145843&sid=863481066&pageSize=2&page=1

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/hug/list'

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

/cm/ncm/comment/info/list​

评论统计数据

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入资源类型和资源 id 列表 , 可批量获取对应资源的评论统计数据 ( 不需要登录 )

必选参数 :

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

0: 歌曲

1: mv

2: 歌单

3: 专辑

4: 电台节目

5: 视频

6: 动态

7: 电台

ids: 资源 id 列表 , 多个 id 用逗号分隔 , 如 186016,347230

接口地址 : /comment/info/list

调用例子 : /comment/info/list?type=0&ids=186016,347230

返回数据 :

{
  "data": [
    {
      "latestLikedUsers": null,
      "liked": false,
      "comments": null,
      "resourceType": 4,
      "resourceId": 186016,
      "commentUpgraded": false,
      "musicianSaidCount": 0,
      "commentCountDesc": "100w+",
      "likedCount": 347,
      "commentCount": 1970844,
      "shareCount": 109721,
      "threadId": "R_SO_4_186016"
    }
  ],
  "code": 200
}

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/info/list'

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

/cm/ncm/comment/music​

歌曲评论

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该音乐的所有评论 ( 不需要登录 )

必选参数 : id: 音乐 id

可选参数 : limit: 取出评论数量 , 默认为 20

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

before: 分页参数,取上一页最后一项的 time 获取下一页数据(获取超过 5000 条评论的时候需要用到)

接口地址 : /comment/music

调用例子 : /comment/music?id=186016&limit=1 对应晴天评论

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/music'

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

/cm/ncm/comment/mv​

mv 评论

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该 mv 的所有评论 ( 不需要 登录 )

必选参数 : id: mv id

可选参数 : limit: 取出评论数量 , 默认为 20

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

before: 分页参数,取上一页最后一项的 time 获取下一页数据(获取超过 5000 条评论的时候需要用到)

接口地址 : /comment/mv

调用例子 : /comment/mv?id=5436712

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/mv'

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

/cm/ncm/comment/new​

新版评论接口

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入资源类型和资源 id,以及排序方式,可获取对应资源的评论

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

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

0: 歌曲

1: mv

2: 歌单

3: 专辑

4: 电台节目

5: 视频

6: 动态

7: 电台

可选参数 : pageNo:分页参数,第 N 页,默认为 1

pageSize:分页参数,每页多少条数据,默认 20

sortType: 排序方式, 1:按推荐排序, 2:按热度排序, 3:按时间排序

cursor: 当sortType为 3 时且页数不是第一页时需传入,值为上一条数据的 time

接口地址 : /comment/new

调用例子 : /comment/new?type=0&id=1407551413&sortType=3, /comment/new?type=0&id=1407551413&sortType=3&cursor=1602072870260&pageSize=20&pageNo=2

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/new'

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

/cm/ncm/comment/playlist​

歌单评论

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该歌单的所有评论 ( 不需要 登录 )

必选参数 : id: 歌单 id

可选参数 : limit: 取出评论数量 , 默认为 20

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

before: 分页参数,取上一页最后一项的 time 获取下一页数据(获取超过 5000 条评论的时候需要用到)

接口地址 : /comment/playlist

调用例子 : /comment/playlist?id=705123491

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/playlist'

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

/cm/ncm/comment/video​

视频评论

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该 视频 的所有评论 ( 不需要登录 )

必选参数 : id: 视频的 id

可选参数 : limit: 取出评论数量 , 默认为 20

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

before: 分页参数,取上一页最后一项的 time 获取下一页数据(获取超过 5000 条评论的时候需要用到)

接口地址 : /comment/video

调用例子 : /comment/video?id=89ADDE33C0AAE8EC14B99F6750DB954D

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/comment/video'

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

/cm/ncm/countries/code/list​

国家编码列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取国家编码列表

接口地址 : /countries/code/list

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/countries/code/list'

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

/cm/ncm/creator/authinfo/get​

（文档未收录）

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游模块读取的参数​

模块未直接读取业务参数。

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

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/creator/authinfo/get'

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

/cm/ncm/dj/banner​

电台 banner

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取电台 banner

接口地址 : /dj/banner

调用例子 : /dj/banner

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/banner'

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

/cm/ncm/dj/category/excludehot​

电台 - 非热门类型

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口, 可获得电台非热门类型

接口地址 : /dj/category/excludehot

调用例子 : /dj/category/excludehot

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/category/excludehot'

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

/cm/ncm/dj/category/recommend​

电台 - 推荐类型

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口, 可获得电台推荐类型

接口地址 : /dj/category/recommend

调用例子 : /dj/category/recommend

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/category/recommend'

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

/cm/ncm/dj/catelist​

电台 - 分类

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口 , 可获得电台类型

接口地址 : /dj/catelist

调用例子 : /dj/catelist

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/catelist'

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

/cm/ncm/dj/detail​

电台 - 详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口 , 传入rid, 可获得对应电台的详情介绍

必选参数 : rid: 电台 的 id

接口地址 : /dj/detail

调用例子 : /dj/detail?rid=336355127 ( 对应 ' 代码时间 ' 的详情介绍 )

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/detail'

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

/cm/ncm/dj/difm/all/style/channel​

DIFM电台 - 分类

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 获取DIFM电台分类

必选参数 :

sources: 来源列表, 0: 最嗨电音 1: 古典电台 2: 爵士电台

接口地址: /dj/difm/all/style/channel

调用例子: /dj/difm/all/style/channel?sources=[0]

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/difm/all/style/channel'

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

/cm/ncm/dj/difm/playing/tracks/list​

DIFM电台 - 播放列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 获取DIFM播放列表

必选参数 :

source: 来源, 0: 最嗨电音 1: 古典电台 2: 爵士电台

channelId: 频道id

可选参数 :

limit: 返回数量, 默认为 5

接口地址: /dj/difm/playing/tracks/list

调用例子: /dj/difm/playing/tracks/list?source=0&channelId=1012

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/difm/playing/tracks/list'

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

/cm/ncm/dj/hot​

热门电台

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取热门电台

可选参数 :

limit : 返回数量 , 默认为 30

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

调用例子 : /dj/hot

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/hot'

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

/cm/ncm/dj/paygift​

电台 - 付费精选

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 可以获取付费精选的电台列表 , 传入 limit 和 offset 可以进行分页

可选参数 :

limit : 返回数量 , 默认为 30

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

接口地址 : /dj/paygift

调用例子 : /dj/paygift?limit=10&offset=20

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/paygift'

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

/cm/ncm/dj/personalize/recommend​

电台个性推荐

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取电台个性推荐列表 可选参数 :

limit : 返回数量,默认为 6,总条数最多 6 条

接口地址 : /dj/personalize/recommend

调用例子 : /dj/personalize/recommend?limit=5

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/personalize/recommend'

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

/cm/ncm/dj/program​

电台 - 节目

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口 , 传入rid, 可查看对应电台的电台节目以及对应的 id, 需要 注意的是这个接口返回的 mp3Url 已经无效 , 都为 null, 但是通过调用 /song/url 这 个接口 , 传入节目 mainTrackId 仍然能获取到节目音频 , 如 /song/url?id=478446370 获取代 码时间的一个节目的音频

必选参数 : rid: 电台 的 id

可选参数 :

limit : 返回数量 , 默认为 30

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

asc : 排序方式,默认为 false (新 => 老 ) 设置 true 可改为 老 => 新

接口地址 : /dj/program

调用例子 : /dj/program?rid=336355127&limit=40 ( 对应 ' 代码时间 ' 的节目列表 )

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/program'

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

/cm/ncm/dj/program/detail​

电台 - 节目详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口传入电台节目 id,可获得电台节目详情

必选参数 : id: 电台节目 的 id

接口地址 : /dj/program/detail

调用例子 : /dj/program/detail?id=1367665101

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/program/detail'

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

/cm/ncm/dj/program/toplist​

电台 - 节目榜

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口 , 可获得电台节目榜

可选参数 :

limit : 返回数量 , 默认为 100

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

接口地址 : /dj/program/toplist

调用例子 : /dj/program/toplist?limit=1

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/program/toplist'

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

/cm/ncm/dj/program/toplist/hours​

电台 - 24 小时节目榜

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取 24 小时节目榜

可选参数 :

limit : 返回数量 , 默认为 100 (不支持 offset)

接口地址 : /dj/program/toplist/hours

调用例子 : /dj/program/toplist/hours?limit=1

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/program/toplist/hours'

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

/cm/ncm/dj/radio/hot​

电台 - 类别热门电台

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

可选参数 :

limit : 返回数量 , 默认为 30

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

cateId: 类别 id,可通过 /dj/category/recommend 接口获取

接口地址 : /dj/radio/hot

调用例子 : /dj/radio/hot?cateId=2001(创作|翻唱) /dj/radio/hot?cateId=10002 (3D|电子)

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/radio/hot'

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

/cm/ncm/dj/recommend​

电台 - 推荐

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口 , 可获得推荐电台

接口地址 : /dj/recommend

调用例子 : /dj/recommend

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/recommend'

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

/cm/ncm/dj/recommend/type​

电台 - 分类推荐

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口 , 传入分类,可获得对应类型电台列表

必选参数 : type: 电台类型 , 数字 , 可通过/dj/catelist获取 , 对应关系为 id 对应 此接口的 type, name 对应类型

接口地址 : /dj/recommend/type

调用例子 : /dj/recommend/type?type=1(明星做主播) /dj/recommend/type?type=2001 (创作|翻唱)

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/recommend/type'

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

/cm/ncm/dj/today/perfered​

电台 - 今日优选

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口, 可获得电台今日优选

接口地址 : /dj/today/perfered

调用例子 : /dj/today/perfered

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/today/perfered'

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

/cm/ncm/dj/toplist​

电台 - 新晋电台榜/热门电台榜

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口 , 可获得新晋电台榜/热门电台榜

可选参数 :

limit : 返回数量 , 默认为 100

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

type: 榜单类型, new 为新晋电台榜,hot为热门电台榜

接口地址 : /dj/toplist

调用例子 : /dj/toplist?type=hot /dj/toplist?type=new&limit=1

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/toplist'

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

/cm/ncm/dj/toplist/hours​

电台 - 24 小时主播榜

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取 24 小时主播榜

可选参数 :

limit : 返回数量 , 默认为 100 (不支持 offset)

接口地址 : /dj/toplist/hours

调用例子 : /dj/toplist/hours?limit=30

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/toplist/hours'

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

/cm/ncm/dj/toplist/newcomer​

电台 - 主播新人榜

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取主播新人榜

可选参数 :

limit : 返回数量 , 默认为 100 (不支持 offset)

接口地址 : /dj/toplist/newcomer

调用例子 : /dj/toplist/newcomer?limit=30

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/toplist/newcomer'

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

/cm/ncm/dj/toplist/pay​

电台 - 付费精品

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取付费精品电台

可选参数 :

limit : 返回数量 , 默认为 100 (不支持 offset)

接口地址 : /dj/toplist/pay

调用例子 : /dj/toplist/pay?limit=30

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/toplist/pay'

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

/cm/ncm/dj/toplist/popular​

电台 - 最热主播榜

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取最热主播榜

可选参数 :

limit : 返回数量 , 默认为 100 (不支持 offset)

接口地址 : /dj/toplist/popular

调用例子 : /dj/toplist/popular?limit=30

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/dj/toplist/popular'

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

/cm/ncm/djRadio/top​

电台排行榜获取

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取电台排行榜

接口地址: /djRadio/top

可选参数： djRadioId : 电台 id

sortIndex: 排序 1:播放数 2:点赞数 3：评论数 4：分享数 5：收藏数 默认 1

dataGapDays: 天数 7:一周 30:一个月 90:三个月 默认 7

dataType: 未知,默认 3

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/djRadio/top'

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

/cm/ncm/homepage/block/page​

首页-发现

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取 APP 首页信息

接口地址 : /homepage/block/page

可选参数 : refresh: 是否刷新数据,默认为 false

cursor: 上一条数据返回的 cursor

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/homepage/block/page'

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

/cm/ncm/homepage/dragon/ball​

首页-发现-圆形图标入口列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取 APP 首页圆形图标入口列表

接口地址 : /homepage/dragon/ball

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/homepage/dragon/ball'

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

/cm/ncm/hot/topic​

获取热门话题

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取热门话题

可选参数 : limit: 取出评论数量 , 默认为 20

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

接口地址 : /hot/topic

调用例子 : /hot/topic?limit=30&offset=30

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/hot/topic'

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

/cm/ncm/inner/version​

内部版本接口

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获得内部版本号(从 package.json 读取)

接口地址 : /inner/version

调用例子 : /inner/version

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/inner/version'

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

/cm/ncm/lbs/city/code​

多级行政区划数据

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取多级行政区划数据

可选参数 : bizCode: 业务类型,默认空字符串。传入 chart 时获取支持城市榜的城市列表,传空时获取所有城市列表

接口地址 : /lbs/city/code

调用例子 : /lbs/city/code

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/lbs/city/code'

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

/cm/ncm/lyric​

获取歌词

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

注意：该族包含项目专用封装，先查“音乐与媒体”中的同名接口。/cm/ncm/song/url 必须登录；/cm/ncm/lyric 返回归一化歌词。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入音乐 id 可获得对应音乐的歌词 ( 不需要登录 )

必选参数 : id: 音乐 id

接口地址 : /lyric

调用例子 : /lyric?id=33894312

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/lyric'

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

/cm/ncm/lyric/new​

获取逐字歌词

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 此接口的 yrc 字段即为逐字歌词 (可能有歌曲不包含逐字歌词)

必选参数 : id: 音乐 id

接口地址 : /lyric/new

调用例子 : /lyric/new?id=1824020871

相关讨论可见: Issue

歌词格式解析 :

当逐字歌词适用时，yrc的lyric字段包括形式如下的内容

  • （可能存在）JSON 歌曲元数据
{"t":0,"c":[{"tx":"作曲: "},{"tx":"柳重言","li":"http://p1.music.126.net/Icj0IcaOjH2ZZpyAM-QGoQ==/6665239487822533.jpg","or":"orpheus://nm/artist/home?id=228547&type=artist"}]}
{"t":5403,"c":[{"tx":"编曲: "},{"tx":"Alex San","li":"http://p1.music.126.net/pSbvYkrzZ1RFKqoh-fA9AQ==/109951166352922615.jpg","or":"orpheus://nm/artist/home?id=28984845&type=artist"}]}
{"t":10806,"c":[{"tx":"制作人: "},{"tx":"王菲","li":"http://p1.music.126.net/1KQVD6XWbs5IAV0xOj1ZIA==/18764265441342019.jpg","or":"orpheus://nm/artist/home?id=9621&type=artist"},{"tx":"/"},{"tx":"梁荣骏","li":"http://p1.music.126.net/QrD8drwrRcegfKLPoiiG2Q==/109951166288436155.jpg","or":"orpheus://nm/artist/home?id=189294&type=artist"}]}

该字段不一定出现；可能出现的数据意义有：

  • t : 数据显示开始时间戳 (毫秒)
  • c : 元数据 list
  • tx: 文字段
  • li: 艺术家、歌手头像图 url
  • or：云音乐 app 内路径；例中作用即打开艺术家主页
  • 逐字歌词
[16210,3460](16210,670,0)还(16880,410,0)没...
 ~~~~1 ~~~2  ~~~~3 ~~4 5 ~6 (...)

由标号解释:

  1. 歌词行显示开始时间戳 (毫秒)
  2. 歌词行显示总时长(毫秒)
  3. 逐字显示开始时间戳 (毫秒)
  4. 逐字显示时长 (毫秒)
  5. 未知
  6. 文字

yrc的version字段貌似与lyric字段格式无关

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/lyric/new'

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

/cm/ncm/mlog/music/rcmd​

歌曲相关视频

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明： 可以调用此接口获取歌曲相关视频 (区别于 MV)， 有些歌曲没有 MV 但是有用户上传的与此歌曲相关的 Mlog。 此功能仅在 网易云音乐 APP 上存在。

请注意：此接口偶尔会在相关视频后返回不相关视频，请合理使用。

必选参数 : songid : 歌曲 ID

可选参数 : mvid : 如果定义，此 mvid 对应的 MV 将会作为第一个返回。 limit : 取出的 Mlog 数量, 不包含第一个 mvid

接口地址 : /mlog/music/rcmd

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/mlog/music/rcmd'

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

/cm/ncm/mlog/to/video​

将 mlog id 转为视频 id

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入 mlog id, 可获取 video id，然后通过video/url 获取播放地址

必选参数 : id : mlog id

接口地址 : /mlog/to/video

调用例子 : /mlog/to/video?id=a1qOVPTWKS1ZrK8

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/mlog/to/video'

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

/cm/ncm/mlog/url​

获取 mlog 播放地址

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入 mlog id, 可获取 mlog 播放地址

必选参数 : id : mlog id

可选参数 : res: 分辨率 , 默认为 1080

接口地址 : /mlog/url

调用例子 : /mlog/url?id=a1qOVPTWKS1ZrK8

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/mlog/url'

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

/cm/ncm/mv/all​

全部 mv

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取全部 mv

可选参数 : area: 地区,可选值为全部,内地,港台,欧美,日本,韩国,不填则为全部 type: 类型,可选值为全部,官方版,原生,现场版,网易出品,不填则为全部

order: 排序,可选值为上升最快,最热,最新,不填则为上升最快

limit: 取出数量 , 默认为 30

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

接口地址 : /mv/all

调用例子 : /mv/all?area=港台

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/mv/all'

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

/cm/ncm/mv/detail​

获取 mv 数据

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入 mvid ( 在搜索音乐的时候传 type=1004 获得 ) , 可获取对应 MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等数据 , 其中 mv 视频 网易做了防盗链处理 , 可能不能直接播放 , 需要播放的话需要调用 ' mv 地址' 接口

必选参数 : mvid: mv 的 id

接口地址 : /mv/detail

调用例子 : /mv/detail?mvid=5436712

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/mv/detail'

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

/cm/ncm/mv/detail/info​

获取 mv 点赞转发评论数数据

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入 mvid ( 在搜索音乐的时候传 type=1004 获得 ) , 可获取对应 MV 点赞转发评论数数据

必选参数 : mvid: mv 的 id

接口地址 : /mv/detail/info

调用例子 : /mv/detail/info?mvid=5436712

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/mv/detail/info'

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

/cm/ncm/mv/exclusive/rcmd​

网易出品 mv

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取网易出品 mv

可选参数 : limit: 取出数量 , 默认为 30

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

接口地址 : /mv/exclusive/rcmd

调用例子 : /mv/exclusive/rcmd?limit=10

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/mv/exclusive/rcmd'

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

/cm/ncm/mv/first​

最新 mv

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取最新 mv

可选参数 : area: 地区,可选值为全部,内地,港台,欧美,日本,韩国,不填则为全部

可选参数 : limit: 取出数量 , 默认为 30

接口地址 : /mv/first

调用例子 : /mv/first?limit=10

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/mv/first'

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

/cm/ncm/mv/url​

mv 地址

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

媒体地址族：必须 CurrentMusic Bearer 登录后访问。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入 mv id,可获取 mv 播放地址

必选参数 : id: mv id

可选参数 : r: 分辨率,默认 1080,可从 /mv/detail 接口获取分辨率列表

接口地址 : /mv/url

调用例子 :

/mv/url?id=5436712 /mv/url?id=10896407&r=1080

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/mv/url'

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

/cm/ncm/personalized​

推荐歌单

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取推荐歌单

可选参数 : limit: 取出数量 , 默认为 30 (不支持 offset)

接口地址 : /personalized

调用例子 : /personalized?limit=1

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/personalized'

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

/cm/ncm/personalized/djprogram​

推荐电台

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取推荐电台

接口地址 : /personalized/djprogram

调用例子 : /personalized/djprogram

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/personalized/djprogram'

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

/cm/ncm/personalized/mv​

推荐 mv

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取推荐 mv

接口地址 : /personalized/mv

调用例子 : /personalized/mv

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/personalized/mv'

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

/cm/ncm/personalized/newsong​

推荐新音乐

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取推荐新音乐

可选参数 : limit: 取出数量 , 默认为 10 (不支持 offset)

接口地址 : /personalized/newsong

调用例子 : /personalized/newsong

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/personalized/newsong'

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

/cm/ncm/personalized/privatecontent​

独家放送(入口列表)

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取独家放送

接口地址 : /personalized/privatecontent

调用例子 : /personalized/privatecontent

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/personalized/privatecontent'

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

/cm/ncm/personalized/privatecontent/list​

独家放送列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取独家放送列表

可选参数 :

limit : 返回数量 , 默认为 60

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

接口地址 : /personalized/privatecontent/list

调用例子 : /personalized/privatecontent/list?limit=1&offset=2

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/personalized/privatecontent/list'

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

/cm/ncm/playlist/category/list​

（文档未收录）

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游模块读取的参数​

cat, limit

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

参数模块中的读取/默认表达式
catcat: query.cat || '全部',
limitlimit: query.limit || 24,

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/playlist/category/list'

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

/cm/ncm/playlist/catlist​

歌单分类

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取歌单分类,包含 category 信息

接口地址 : /playlist/catlist

调用例子 : /playlist/catlist

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/playlist/catlist'

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

/cm/ncm/playlist/detail​

获取歌单详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 歌单能看到歌单名字, 但看不到具体歌单内容 , 调用此接口 , 传入歌单 id, 可 以获取对应歌单内的所有的音乐(未登录状态只能获取不完整的歌单,登录后是完整的)，但是返回的 trackIds 是完整的，tracks 则是不完整的，可拿全部 trackIds 请求一次 song/detail 接口获取所有歌曲的详情 (https://github.com/Binaryify/NeteaseCloudMusicApi/issues/452)

必选参数 : id : 歌单 id

可选参数 : s : 歌单最近的 s 个收藏者,默认为 8

接口地址 : /playlist/detail

调用例子 : /playlist/detail?id=24381616

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/playlist/detail'

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

/cm/ncm/playlist/detail/dynamic​

歌单详情动态

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用后可获取歌单详情动态部分,如评论数,是否收藏,播放数

必选参数 : id : 歌单 id

接口地址 : /playlist/detail/dynamic

调用例子 : /playlist/detail/dynamic?id=24381616

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/playlist/detail/dynamic'

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

/cm/ncm/playlist/detail/rcmd/get​

相关歌单推荐

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 传入歌单 id, 获取相关歌单推荐

必选参数：

id: 歌单 id

接口地址: /playlist/detail/rcmd/get

调用例子: /playlist/detail/rcmd/get?id=8039587836

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/playlist/detail/rcmd/get'

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

/cm/ncm/playlist/highquality/tags​

精品歌单标签列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取精品歌单标签列表

接口地址 : /playlist/highquality/tags

调用例子 : /playlist/highquality/tags

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/playlist/highquality/tags'

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

/cm/ncm/playlist/hot​

热门歌单分类

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取歌单分类,包含 category 信息

接口地址 : /playlist/hot

调用例子 : /playlist/hot

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/playlist/hot'

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

/cm/ncm/playlist/subscribers​

歌单收藏者

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌单 id 可获取歌单的所有收藏者 必选参数 :

id : 歌单 id

可选参数 : limit: 取出评论数量 , 默认为 20

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

接口地址 : /playlist/subscribers

调用例子 : /playlist/subscribers?id=544215255&limit=30

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/playlist/subscribers'

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

/cm/ncm/playlist/track/all​

获取歌单所有歌曲

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 由于网易云接口限制，歌单详情只会提供 10 首歌，通过调用此接口，传入对应的歌单id，即可获得对应的所有歌曲

必选参数 : id : 歌单 id

可选参数 : limit : 限制获取歌曲的数量，默认值为当前歌单的歌曲数量

可选参数 : offset : 默认值为 0

接口地址 : /playlist/track/all

调用例子 : /playlist/track/all?id=24381616&limit=10&offset=1

注：关于offset，你可以这样理解，假设你当前的歌单有 200 首歌

你传入 limit=50&offset=0 等价于 limit=50，你会得到第 1-50 首歌曲

你传入 limit=50&offset=50，你会得到第 51-100 首歌曲

如果你设置 limit=50&offset=100，你就会得到第 101-150 首歌曲

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/playlist/track/all'

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

/cm/ncm/program/recommend​

推荐节目

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取推荐电台

接口地址 : /program/recommend

可选参数 : limit: 取出数量 , 默认为 10

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

调用例子 : /program/recommend?limit=5

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/program/recommend'

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

/cm/ncm/related/allvideo​

相关视频

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取相关视频

必选参数 : id: 视频 的 id

接口地址 : /related/allvideo

调用例子 : /related/allvideo?id=89ADDE33C0AAE8EC14B99F6750DB954D

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/related/allvideo'

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

/cm/ncm/related/playlist​

（文档未收录）

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 请替换为相关歌单推荐接口; 本接口通过 html 抓取内容, 现已无法抓取歌单

说明 : 调用此接口,传入歌单 id 可获取相关歌单(对应页面 https://music.163.com/#/playlist?id=1)

必选参数 : id : 歌单 id

接口地址 : /related/playlist

调用例子 : /related/playlist?id=1

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/related/playlist'

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

/cm/ncm/sati/resource/list​

助眠解压 - 获取标签下资源列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 获取标签下资源列表; 接口返回的trackId可以用于请求/song/url/v1接口，用于获取声音的下载地址

必选参数 :

tag: 标签, 由标签列表接口得到

接口地址: /sati/resource/list

调用例子: /sati/resource/list?tag=naturalMusic

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/sati/resource/list'

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

/cm/ncm/sati/resource/list/more​

助眠解压 - 查看同类推荐

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 查看同类推荐

必选参数 :

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

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

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

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/sati/resource/list/more'

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

/cm/ncm/sati/tag/list​

助眠解压 - 标签列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 获取标签列表

接口地址: /sati/tag/list

调用例子: /sati/tag/list

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/sati/tag/list'

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

/cm/ncm/sati/timescene/resources/get​

助眠解压 - 特定时间场景下的推荐资源

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 获取特定时间场景下的推荐资源

接口地址: /sati/timescene/resources/get

调用例子: /sati/timescene/resources/get

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/sati/timescene/resources/get'

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

/cm/ncm/search​

搜索

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入搜索关键词可以搜索该音乐 / 专辑 / 歌手 / 歌单 / 用户 , 关键词可以多个 , 以空格隔开 , 如 " 周杰伦 搁浅 "( 不需要登录 ), 可通过 /song/url 接口传入歌曲 id 获取具体的播放链接

必选参数 : keywords : 关键词

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

type: 搜索类型；默认为 1 即单曲 , 取值意义 : 1: 单曲, 10: 专辑, 100: 歌手, 1000: 歌单, 1002: 用户, 1004: MV, 1006: 歌词, 1009: 电台, 1014: 视频, 1018:综合, 2000:声音(搜索声音返回字段格式会不一样)

接口地址 : /search 或者 /cloudsearch(更全)

调用例子 : /search?keywords=海阔天空 /cloudsearch?keywords=海阔天空

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/search'

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

/cm/ncm/search/default​

默认搜索关键词

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取默认搜索关键词

接口地址 : /search/default

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/search/default'

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

/cm/ncm/search/hot​

热搜列表(简略)

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取热门搜索列表

接口地址 : /search/hot

调用例子 : /search/hot

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/search/hot'

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

/cm/ncm/search/hot/detail​

热搜列表(详细)

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取热门搜索列表

接口地址 : /search/hot/detail

调用例子 : /search/hot/detail

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/search/hot/detail'

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

/cm/ncm/search/match​

本地歌曲文件匹配网易云歌曲信息

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以为本地歌曲文件搜索匹配歌曲 ID、专辑封面等信息

必选参数：

title: 文件的标题信息，是文件属性里的标题属性，并非文件名

album: 文件的专辑信息

artist: 文件的艺术家信息

duration: 文件的时长，单位为秒

md5: 文件的 md5

接口地址: /search/match

调用例子: /search/match?title=富士山下&album=&artist=陈奕迅&duration=259.21&md5=bd708d006912a09d827f02e754cf8e56

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/search/match'

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

/cm/ncm/search/multimatch​

搜索多重匹配

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入搜索关键词可获得搜索结果

必选参数 : keywords : 关键词

接口地址 : /search/multimatch

调用例子 : /search/multimatch?keywords=海阔天空

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/search/multimatch'

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

/cm/ncm/search/suggest​

搜索建议

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入搜索关键词可获得搜索建议 , 搜索结果同时包含单曲 , 歌手 , 歌单信息

必选参数 : keywords : 关键词

可选参数 : type : 如果传 'mobile' 则返回移动端数据

接口地址 : /search/suggest

调用例子 : /search/suggest?keywords=海阔天空 /search/suggest?keywords=海阔天空&type=mobile

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/search/suggest'

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

/cm/ncm/search/suggest/pc​

搜索建议 - PC端

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口, 传入搜索关键词, 获取搜索建议

必选参数 :

keyword: 搜索关键词

接口地址 : /search/suggest/pc

调用例子 : /search/suggest/pc?keyword=海阔天空

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/search/suggest/pc'

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

/cm/ncm/sheet/list​

乐谱列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取歌曲的乐谱列表

接口地址: /sheet/list

必选参数: id: 歌曲 ID

调用例子: /sheet/list?id=1815684465

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/sheet/list'

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

/cm/ncm/sheet/preview​

乐谱内容

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 登录后调用此接口获取乐谱的内容

接口地址: /sheet/preview

必选参数: id: 乐谱 ID

调用例子: /sheet/preview?id=143190

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/sheet/preview'

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

/cm/ncm/simi/artist​

获取相似歌手

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌手 id, 可获得相似歌手

必选参数 : id: 歌手 id

接口地址 : /simi/artist

调用例子 : /simi/artist?id=6452 ( 对应和周杰伦相似歌手 )

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/simi/artist'

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

/cm/ncm/simi/mv​

相似 mv

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入 mvid 可获取相似 mv

必选参数 : mvid: mv id

接口地址 : /simi/mv

调用例子 : /simi/mv?mvid=5436712

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/simi/mv'

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

/cm/ncm/simi/playlist​

获取相似歌单

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌曲 id, 可获得相似歌单

必选参数 : id: 歌曲 id

接口地址 : /simi/playlist

调用例子 : /simi/playlist?id=347230 ( 对应 ' 光辉岁月 ' 相似歌单 )

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/simi/playlist'

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

/cm/ncm/simi/song​

获取相似音乐

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌曲 id, 可获得相似歌曲

必选参数 : id: 歌曲 id

接口地址 : /simi/song

调用例子 : /simi/song?id=347230 ( 对应 ' 光辉岁月 ' 相似歌曲 )

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/simi/song'

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

/cm/ncm/simi/user​

获取最近 5 个听了这首歌的用户

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入歌曲 id, 最近 5 个听了这首歌的用户

必选参数 : id: 歌曲 id

接口地址 : /simi/user

调用例子 : /simi/user?id=347230 ( 对应 ' 光辉岁月 ' 相似歌曲 )

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/simi/user'

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

/cm/ncm/song/chorus​

副歌时间

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 传入歌曲 id, 获取副歌时间

必选参数：

id: 歌曲 id

接口地址: /song/chorus

调用例子: /song/chorus?id=2058263032

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/chorus'

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

/cm/ncm/song/copyright/rcmd​

灰色歌曲的其他版本推荐

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口, 传入灰色歌曲 id, 获取该歌曲的其他可播放版本推荐

必选参数 :

songid: 歌曲 id, 可使用 id 代替

接口地址 : /song/copyright/rcmd

调用例子 : /song/copyright/rcmd?songid=27946878

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/copyright/rcmd'

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

/cm/ncm/song/creators​

歌曲创作者信息

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口, 传入音乐 id 可获得对应音乐的创作者信息

必选参数 : id: 音乐 id

接口地址 : /song/creators

调用例子 : /song/creators?id=33894312

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/creators'

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

/cm/ncm/song/detail​

获取歌曲详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

注意：该族包含项目专用封装，先查“音乐与媒体”中的同名接口。/cm/ncm/song/url 必须登录；/cm/ncm/lyric 返回归一化歌词。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入音乐 id(支持多个 id, 用 , 隔开), 可获得歌曲详情(dt 为歌曲时长)

必选参数 : ids: 音乐 id, 如 ids=347230

接口地址 : /song/detail

调用例子 : /song/detail?ids=347230,/song/detail?ids=347230,347231

返回字段说明(感谢 @tuxzz 整理):

name: String, 歌曲标题
id: u64, 歌曲ID
pst: 0，功能未知
t: enum,
  0: 一般类型
  1: 通过云盘上传的音乐，网易云不存在公开对应
    如果没有权限将不可用，除了歌曲长度以外大部分信息都为null。
    可以通过 `/api/v1/playlist/manipulate/tracks` 接口添加到播放列表。
    如果添加到“我喜欢的音乐”，则仅自己可见，除了长度以外各种信息均为未知，且无法播放。
    如果添加到一般播放列表，虽然返回code 200，但是并没有效果。
    网页端打开会看到404画面。
    属于这种歌曲的例子: https://music.163.com/song/1345937107
  2: 通过云盘上传的音乐，网易云存在公开对应
    如果没有权限则只能看到信息，但无法直接获取到文件。
    可以通过 `/api/v1/playlist/manipulate/tracks` 接口添加到播放列表。
    如果添加到“我喜欢的音乐”，则仅自己可见，且无法播放。
    如果添加到一般播放列表，则自己会看到显示“云盘文件”，且云盘会多出其对应的网易云公开歌曲。其他人看到的是其对应的网易云公开歌曲。
    网页端打开会看到404画面。
    属于这种歌曲的例子: https://music.163.com/song/435005015
ar: Vec<Artist>, 歌手列表
alia: Vec<String>,
  别名列表，第一个别名会被显示作副标题
  例子: https://music.163.com/song/536623501
pop: 小数，常取[0.0, 100.0]中离散的几个数值, 表示歌曲热度
st: 0: 功能未知
rt: Option<String>, None、空白字串、或者类似`600902000007902089`的字符串，功能未知
fee: enum,
  0: 免费或无版权
  1: VIP 歌曲
  4: 购买专辑
  8: 非会员可免费播放低音质，会员可播放高音质及下载
  fee 为 1 或 8 的歌曲均可单独购买 2 元单曲
v: u64, 常为[1, ?]任意数字, 代表歌曲当前信息版本
version: u64, 常为[1, ?]任意数字, 代表歌曲当前信息版本
crbt: Option<String>, None或字符串表示的十六进制，功能未知
cf: Option<String>, 空白字串或者None，功能未知
al: Album, 专辑，如果是DJ节目(dj_type != 0)或者无专辑信息(single == 1)，则专辑id为0
dt: u64, 歌曲时长
hr: Option<Quality>, Hi-Res质量文件信息
sq: Option<Quality>, 无损质量文件信息
h: Option<Quality>, 高质量文件信息
m: Option<Quality>, 中质量文件信息
l: Option<Quality>, 低质量文件信息
a: Option<未知>, 常为None, 功能未知
cd: Option<String>, None或如"04", "1/2", "3", "null"的字符串，表示歌曲属于专辑中第几张CD，对应音频文件的Tag
no: u32, 表示歌曲属于CD中第几曲，0表示没有这个字段，对应音频文件的Tag
rtUrl: Option<String(?)>, 常为None, 功能未知
rtUrls: Vec<String(?)>, 常为空列表, 功能未知
djId: u64,
  0: 不是DJ节目
  其他：是DJ节目，表示DJ ID
copyright: u32, 0, 1, 2: 功能未知
s_id: u64, 对于t == 2的歌曲，表示匹配到的公开版本歌曲ID
mark: u64, 一些歌曲属性，用按位与操作获取对应位置的值
  8192 立体声?(不是很确定)
  131072 纯音乐
  262144 支持 杜比全景声(Dolby Atmos)
  1048576 脏标 🅴
  17179869184 支持 Hi-Res
  其他未知，理论上有从1到2^63共64种不同的信息
  专辑信息的mark字段也同理
  例子:id 1859245776 和 1859306637 为同一首歌，前者 mark & 1048576 == 1048576,后者 mark & 1048576 == 0，因此前者是脏版。

originCoverType: enum
  0: 未知
  1: 原曲
  2: 翻唱
originSongSimpleData: Option<SongSimpleData>, 对于翻唱曲，可选提供原曲简单格式的信息
single: enum,
  0: 有专辑信息或者是DJ节目
  1: 未知专辑
noCopyrightRcmd: Option<NoCopyrightRcmd>, 不能判断出歌曲有无版权
mv: u64, 非零表示有MV ID
rtype: 常为0，功能未知
rurl: Option<String(?)>, 常为None，功能未知
mst: u32, 偶尔为0, 常为9，功能未知
cp: u64, 功能未知
publishTime: i64, 毫秒为单位的Unix时间戳
pc: 云盘歌曲信息，如果不存在该字段，则为非云盘歌曲
privilege:权限相关信息
  cs:bool,是否为云盘歌曲
  st:小于0时为灰色歌曲, 使用上传云盘的方法解灰后 st == 0
  toast:bool,是否「由于版权保护，您所在的地区暂时无法使用。」
  flLevel:免费用户的该歌曲播放音质
  plLevel:当前用户的该歌曲最高试听音质
  dlLevel:当前用户的该歌曲最高下载音质
  maxBrLevel；歌曲最高音质

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/detail'

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

/cm/ncm/song/download/url​

获取客户端歌曲下载 url

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

媒体地址族：必须 CurrentMusic Bearer 登录后访问。

上游参数与业务说明​

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

说明 : 使用 /song/url 接口获取的是歌曲试听 url, 但存在部分歌曲在非 VIP 账号上可以下载无损音质而不能试听无损音质, 使用此接口可使非 VIP 账号获取这些歌曲的无损音频

必选参数 : id : 音乐 id (仅支持单首歌曲)

可选参数 : br : 码率, 默认设置了 999000 即最大码率, 如果要 320k 则可设置为 320000, 其他类推

接口地址 : /song/download/url

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/download/url'

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

/cm/ncm/song/download/url/v1​

获取客户端歌曲下载链接 - 新版

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

媒体地址族：必须 CurrentMusic Bearer 登录后访问。

上游参数与业务说明​

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

说明 : 使用 /song/url/v1 接口获取的是歌曲试听 url, 非 VIP 账号最高只能获取 极高 音质，但免费类型的歌曲(fee == 0)使用本接口可最高获取Hi-Res音质的 url。

必选参数 : id : 音乐 id level: 播放音质等级, 分为 standard => 标准,higher => 较高, exhigh=>极高, lossless=>无损, hires=>Hi-Res, jyeffect => 高清臻音, dolby => 杜比全景声, vivid => 臻音全景声, jymaster => 超清母带, sky => 沉浸环绕声

接口地址 : /song/download/url/v1

调用例子 : /song/download/url/v1?id=2155423468&level=hires

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/download/url/v1'

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

/cm/ncm/song/dynamic/cover​

歌曲动态封面

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 登录后调用此接口, 传入歌曲 id, 获取歌曲动态封面

必选参数 :

id: 歌曲 id

接口地址 : /song/dynamic/cover

调用例子 : /song/dynamic/cover?id=2101179024

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/dynamic/cover'

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

/cm/ncm/song/music/detail​

歌曲音质详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口获取歌曲各个音质的文件信息，与 获取歌曲详情 接口相比，多出高清臻音、杜比全景声、臻音全景声、超清母带、沉浸环绕声等音质的信息

必选参数：

id: 歌曲 id

接口地址: /song/music/detail

调用例子: /song/music/detail?id=2082700997

返回字段说明 :

"br": 比特率Bit Rate,
"size": 文件大小,
"vd": Volume Delta,
"sr": 采样率Sample Rate

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/music/detail'

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

/cm/ncm/song/red/count​

歌曲红心数量

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口获取歌曲的红心用户数量

必选参数：

id: 歌曲 id

接口地址: /song/red/count

调用例子: /song/red/count?id=186016

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/red/count'

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

/cm/ncm/song/simi/get​

插播相似歌曲

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口, 传入歌曲 id, 可获取插播相似歌曲

必选参数 : id: 歌曲 id

接口地址 : /song/simi/get

调用例子 : /song/simi/get?id=39227633

离线访问此文档​

此文档同时也是 Progressive Web Apps(PWA), 加入了 serviceWorker, 可离线访问

关于此文档​

此文档由 docsify 生成 docsify 是一个动态生成文档网站的工具。不同于 GitBook、Hexo 的地方是它不会生成将 .md 转成 .html 文件，所有转换工作都是在运行时进行。

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/simi/get'

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

/cm/ncm/song/url​

获取音乐 url

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

媒体地址族：必须 CurrentMusic Bearer 登录后访问。

注意：该族包含项目专用封装，先查“音乐与媒体”中的同名接口。/cm/ncm/song/url 必须登录；/cm/ncm/lyric 返回归一化歌词。

上游参数与业务说明​

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

说明 : 使用歌单详情接口后 , 能得到的音乐的 id, 但不能得到的音乐 url, 调用此接口, 传入的音乐 id( 可多个 , 用逗号隔开 ), 可以获取对应的音乐的 url,未登录状态或者非会员返回试听片段(返回字段包含被截取的正常歌曲的开始时间和结束时间)

遇到 403 错误时，请在 head 标签内加入 <meta name="referrer" content="no-referrer">

必选参数 : id : 音乐 id

可选参数 : br: 码率,默认设置了 999000 即最大码率,如果要 320k 则可设置为 320000,其他类推

接口地址 : /song/url

调用例子 : /song/url?id=1969519579 /song/url?id=1969519579,33894312

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/url'

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

/cm/ncm/song/url/match​

直接获取灰色歌曲链接

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

媒体地址族：必须 CurrentMusic Bearer 登录后访问。

注意：该族包含项目专用封装，先查“音乐与媒体”中的同名接口。/cm/ncm/song/url 必须登录；/cm/ncm/lyric 返回归一化歌词。

上游参数与业务说明​

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

说明 : 技术部分来自于 UnblockNeteaseMusic 的支持

必选参数 : id : 音乐 id

可选参数 : source: 选择要解灰的音源, 不支持多音源

接口地址 : /song/url/match

调用例子 : /song/url/match?id=1969519579 /song/url/match?id=1969519579

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/url/match'

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

/cm/ncm/song/url/v1​

获取音乐 url - 新版

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

媒体地址族：必须 CurrentMusic Bearer 登录后访问。

注意：该族包含项目专用封装，先查“音乐与媒体”中的同名接口。/cm/ncm/song/url 必须登录；/cm/ncm/lyric 返回归一化歌词。

上游参数与业务说明​

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

说明 : 使用注意事项同上

必选参数 : id : 音乐 id level: 播放音质等级, 分为 standard => 标准,higher => 较高, exhigh=>极高, lossless=>无损, hires=>Hi-Res, jyeffect => 高清臻音, dolby => 杜比全景声, vivid => 臻音全景声, jymaster => 超清母带, sky => 沉浸环绕声 unblock: 是否使用使用歌曲解锁, 分为true和false

可选参数 : immerseType: 沉浸声环绕声类型, 分为c512 => 新版c51类型, ste2 => 新版环绕立体声类型, aac2 => 新版aac类型, c51 => c51类型, ste => 环绕立体声类型, aac => aac类型, 仅在 level=sky 时生效, 默认为 c51

接口地址 : /song/url/v1

调用例子 : /song/url/v1?id=1969519579&level=exhigh /song/url/v1?id=1969519579,33894312&level=lossless /song/url/v1?id=1969519579&level=sky&immerseType=ste /song/url/v1?id=1969519579&level=vivid

说明：杜比全景声音质需要设备支持，不同的设备可能会返回不同码率的 url。cookie 需要传入os=pc保证返回正常码率的 url。

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/url/v1'

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

/cm/ncm/song/url/v1/302​

302到音乐 url - 新版

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

媒体地址族：必须 CurrentMusic Bearer 登录后访问。

注意：该族包含项目专用封装，先查“音乐与媒体”中的同名接口。/cm/ncm/song/url 必须登录；/cm/ncm/lyric 返回归一化歌词。

上游参数与业务说明​

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

说明 : 只允许传入单个id，会使用302重定向请求到目标url

必选参数 : id : 音乐 id level: 播放音质等级, 分为 standard => 标准,higher => 较高, exhigh=>极高, lossless=>无损, hires=>Hi-Res, jyeffect => 高清臻音, dolby => 杜比全景声, vivid => 臻音全景声, jymaster => 超清母带, sky => 沉浸环绕声 unblock: 是否使用使用歌曲解锁, 分为true和false

接口地址 : /song/url/v1/302

调用例子 : /song/url/v1/302?id=1969519579&level=exhigh

说明：杜比全景声音质需要设备支持，不同的设备可能会返回不同码率的 url。cookie 需要传入os=pc保证返回正常码率的 url。

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/url/v1/302'

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

/cm/ncm/song/wiki/info​

音乐百科

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取歌曲的音乐百科信息

接口地址: /song/wiki/info

必选参数: id: 歌曲 ID

调用例子: /song/wiki/info?id=1958384591

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/wiki/info'

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

/cm/ncm/song/wiki/summary​

音乐百科 - 简要信息

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取歌曲的音乐百科简要信息

由于此接口返回内容过于复杂, 请按需取用

接口地址: /song/wiki/summary

必选参数: id: 歌曲 ID

调用例子: /song/wiki/summary?id=1958384591

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/song/wiki/summary'

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

/cm/ncm/starpick/comments/summary​

云村星评馆 - 简要评论

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取首页推荐的星评馆评论信息

接口地址: /starpick/comments/summary

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/starpick/comments/summary'

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

/cm/ncm/style/album​

曲风-专辑

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取该曲风对应的专辑

接口地址: /style/album

必选参数: tagId: 曲风 ID

可选参数 : size : 返回数量 , 默认为 20

cursor : 返回数据的 cursor, 默认为 0 , 传入上一次返回结果的 cursor,将会返回下一页的数据

sort: 排序方式，0: 按热度排序，1: 按时间排序

调用例子: /style/album?tagId=1000 /style/album?tagId=1010&sort=1

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/style/album'

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

/cm/ncm/style/artist​

曲风-歌手

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取该曲风对应的歌手

接口地址: /style/artist

必选参数: tagId: 曲风 ID

可选参数 : size : 返回数量 , 默认为 20

cursor : 返回数据的 cursor, 默认为 0 , 传入上一次返回结果的 cursor,将会返回下一页的数据

调用例子: /style/artist?tagId=1000

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/style/artist'

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

/cm/ncm/style/detail​

曲风详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取该曲风的描述信息

接口地址: /style/detail

必选参数: tagId: 曲风 ID

调用例子: /style/detail?tagId=1000

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/style/detail'

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

/cm/ncm/style/list​

曲风列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口获取曲风列表及其对应的 tagId

接口地址: /style/list

调用例子: /style/list

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/style/list'

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

/cm/ncm/style/playlist​

曲风-歌单

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取该曲风对应的歌单

接口地址: /style/playlist

必选参数: tagId: 曲风 ID

可选参数 : size : 返回数量 , 默认为 20

cursor : 返回数据的 cursor, 默认为 0 , 传入上一次返回结果的 cursor,将会返回下一页的数据

调用例子: /style/playlist?tagId=1000

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/style/playlist'

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

/cm/ncm/style/song​

曲风-歌曲

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取该曲风对应的歌曲

接口地址: /style/song

必选参数: tagId: 曲风 ID

可选参数 : size : 返回数量 , 默认为 20

cursor : 返回数据的 cursor, 默认为 0 , 传入上一次返回结果的 cursor,将会返回下一页的数据

sort: 排序方式，0: 按热度排序，1: 按时间排序

调用例子: /style/song?tagId=1000 /style/song?tagId=1010&sort=1

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/style/song'

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

/cm/ncm/threshold/detail/get​

（文档未收录）

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游模块读取的参数​

模块未直接读取业务参数。

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

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/threshold/detail/get'

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

/cm/ncm/top/album​

新碟上架

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取新碟上架列表 , 如需具体音乐信息需要调用获取专辑列表接 口 /album , 然后传入 id, 如 /album?id=32311

可选参数 :

area: ALL:全部,ZH:华语,EA:欧美,KR:韩国,JP:日本

type : new:全部 hot:热门,默认为 new

year : 年,默认本年

month : 月,默认本月

接口地址 : /top/album

调用例子 : /top/album?offset=0&limit=30&year=2019&month=6

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/top/album'

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

/cm/ncm/top/artists​

热门歌手

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取热门歌手数据

可选参数 : limit: 取出数量 , 默认为 50

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

接口地址 : /top/artists

调用例子 : /top/artists?offset=0&limit=30

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/top/artists'

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

/cm/ncm/top/list​

（文档未收录）

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 请使用歌单详情接口,传入排行榜 id 获取排行榜详情数据(排行榜也是歌单的一种)

说明 : 调用此接口 , 传入榜单 id, 可获取不同排行榜数据(v3.34.0 之后不再支持 idx 参数)

必选参数 : id: 榜单 id,通过所有榜单接口获取

接口地址 : /top/list

调用例子 : /top/list?id=2809577409

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/top/list'

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

/cm/ncm/top/mv​

mv 排行

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取 mv 排行

可选参数 : limit: 取出数量 , 默认为 30

area: 地区,可选值为内地,港台,欧美,日本,韩国,不填则为全部

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

接口地址 : /top/mv

调用例子 : /top/mv?limit=10

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/top/mv'

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

/cm/ncm/top/playlist​

歌单 ( 网友精选碟 )

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取网友精选碟歌单

可选参数 : order: 可选值为 'new' 和 'hot', 分别对应最新和最热 , 默认为 'hot'

cat: tag, 比如 " 华语 "、" 古风 " 、" 欧美 "、" 流行 ", 默认为 "全部",可从歌单分类接口获取(/playlist/catlist)

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

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

接口地址 : /top/playlist

调用例子 : /top/playlist?limit=10&order=new

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/top/playlist'

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

/cm/ncm/top/playlist/highquality​

获取精品歌单

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取精品歌单

可选参数 : cat: tag, 比如 " 华语 "、" 古风 " 、" 欧美 "、" 流行 ", 默认为 "全部",可从精品歌单标签列表接口获取(/playlist/highquality/tags)

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

before: 分页参数,取上一页最后一个歌单的 updateTime 获取下一页数据

接口地址 : /top/playlist/highquality

调用例子 : /top/playlist/highquality?before=1503639064232&limit=3

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/top/playlist/highquality'

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

/cm/ncm/top/song​

新歌速递

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取新歌速递

必选参数 :

type: 地区类型 id,对应以下:

全部:0

华语:7

欧美:96

日本:8

韩国:16

接口地址 : /top/song

调用例子 : /top/song?type=96

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/top/song'

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

/cm/ncm/topic/detail​

获取话题详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取话题详情

接口地址 : /topic/detail

调用例子 : /topic/detail?actid=111551188

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/topic/detail'

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

/cm/ncm/topic/detail/event/hot​

获取话题详情热门动态

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取话题详情热门动态

接口地址 : /topic/detail/event/hot

调用例子 : /topic/detail/event/hot?actid=111551188

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/topic/detail/event/hot'

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

/cm/ncm/toplist​

所有榜单

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取所有榜单 接口地址 : /toplist

调用例子 : /toplist

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/toplist'

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

/cm/ncm/toplist/artist​

歌手榜

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取排行榜中的歌手榜

可选参数 :

type : 地区
1: 华语
2: 欧美
3: 韩国
4: 日本

接口地址 : /toplist/artist

调用例子 : /toplist/artist

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/toplist/artist'

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

/cm/ncm/toplist/detail​

所有榜单内容摘要

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取所有榜单内容摘要

接口地址 : /toplist/detail

调用例子 : /toplist/detail

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/toplist/detail'

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

/cm/ncm/toplist/detail/v2​

（文档未收录）

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游模块读取的参数​

模块未直接读取业务参数。

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

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/toplist/detail/v2'

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

/cm/ncm/verify/getQr​

验证接口-二维码生成

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 进行某些操作,如关注用户,可能会触发验证,可调用这个接口生成二维码,使用 app 扫码后可解除验证

接口地址: /verify/getQr

必选参数：

vid: 触发验证后,接口返回的 verifyId

type:触发验证后,接口返回的 verifyType

token:触发验证后,接口返回的 verifyToken

evid:触发验证后,接口返回的 params 的 event_id

sign:触发验证后,接口返回的 params 的 sign

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/verify/getQr'

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

/cm/ncm/verify/qrcodestatus​

验证接口-二维码检测

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 使用此接口,传入/verify/getQr接口返回的qr字符串,可检测二维码扫描状态

接口地址: /verify/qrcodestatus

必选参数：

qr: /verify/getQr接口返回的qr字符串

返回结果说明:

qrCodeStatus:0,detailReason:0 二维码生成成功

qrCodeStatus:0,detailReason:303 账号不一致

qrCodeStatus:10,detailReason:0 二维码已扫描,并且手机号相同

qrCodeStatus:20,detailReason:0 验证成功 qrCodeStatus:21,detailReason:0 二维码已失效

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/verify/qrcodestatus'

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

/cm/ncm/video/category/list​

获取视频分类列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取视频分类列表

接口地址 : /video/category/list

调用例子 : /video/category/list

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/video/category/list'

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

/cm/ncm/video/detail​

视频详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取视频详情

必选参数 : id: 视频 的 id

接口地址 : /video/detail

调用例子 : /video/detail?id=89ADDE33C0AAE8EC14B99F6750DB954D

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/video/detail'

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

/cm/ncm/video/detail/info​

获取视频点赞转发评论数数据

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入 vid ( 视频 id ) , 可获取对应视频点赞转发评论数数据 必选参数 : vid: 视频 id

接口地址 : /video/detail/info

调用例子 : /video/detail/info?vid=89ADDE33C0AAE8EC14B99F6750DB954D

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/video/detail/info'

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

/cm/ncm/video/group​

获取视频标签/分类下的视频

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入标签/分类id,可获取到相关的视频,分页参数只能传入 offset

必选参数 : id: videoGroup 的 id

可选参数 : offset: 默认 0

接口地址 : /video/group

调用例子 : /video/group?id=9104

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/video/group'

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

/cm/ncm/video/group/list​

获取视频标签列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口 , 可获取视频标签列表

接口地址 : /video/group/list

调用例子 : /video/group/list

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/video/group/list'

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

/cm/ncm/video/timeline/all​

获取全部视频列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口,可获取视频分类列表,分页参数只能传入 offset

可选参数 : offset: 默认 0

接口地址 : /video/timeline/all

调用例子 : /video/timeline/all

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/video/timeline/all'

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

/cm/ncm/video/timeline/recommend​

获取推荐视频

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明 : 调用此接口, 可获取推荐视频,分页参数只能传入 offset

可选参数 : offset: 默认 0

接口地址 : /video/timeline/recommend

调用例子 : /video/timeline/recommend?offset=10

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/video/timeline/recommend'

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

/cm/ncm/video/url​

获取视频播放地址

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

媒体地址族：必须 CurrentMusic Bearer 登录后访问。

上游参数与业务说明​

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

说明 : 调用此接口 , 传入视频 id,可获取视频播放地址

必选参数 : id: 视频 的 id

接口地址 : /video/url

调用例子 : /video/url?id=89ADDE33C0AAE8EC14B99F6750DB954D

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/video/url'

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

/cm/ncm/voice/detail​

播客声音详情

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

媒体地址族：必须 CurrentMusic Bearer 登录后访问。

上游参数与业务说明​

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

说明: 获取播客里的声音详情

接口地址: /voice/detail

必选参数： id: 播客声音 id(voiceId)

返回结果的displayStatus参数对应:

同上

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/voice/detail'

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

/cm/ncm/voice/lyric​

获取声音歌词

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 调用此接口可以获取声音歌词

接口地址: /voice/lyric

必选参数： id: 声音 id

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/voice/lyric'

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

/cm/ncm/voicelist/detail​

播客列表详情

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 可以获取播客封面、分类、名称、简介等

接口地址: /voicelist/detail

必选参数：

id: 播客 id，即 voiceListId

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/voicelist/detail'

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

/cm/ncm/voicelist/list​

播客声音列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 可以获取播客里的声音

接口地址: /voicelist/list

必选参数： voiceListId: 播客 id

返回结果的displayStatus参数对应:

AUDITING 审核中
ONLY_SELF_SEE 仅自己可见
ONLINE 已发布

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

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

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/voicelist/list'

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

/cm/ncm/voicelist/list/search​

播客声音搜索

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 可以搜索播客里的声音

接口地址: /voicelist/list/search

可选参数

  • 状态（非必填）：

    • displayStatus: null（默认）：返回所有状态的声音
    • displayStatus: "ONLINE"：已发布的声音
    • displayStatus: "AUDITING"：审核中的声音
    • displayStatus: "ONLY_SELF_SEE"：尽自己可见的声音
    • displayStatus: "SCHEDULE_PUBLISH"：定时发布的声音
    • displayStatus: "TRANSCODE_FAILED"：上传失败的声音
    • displayStatus: "PUBLISHING"：发布中的声音
    • displayStatus: "FAILED"：发布失败的声音

  • limit: 20：每次返回的声音数量（最多 200 个）

  • 搜索关键词：

    • name: null：返回所有的声音
    • name: [关键词]：返回包含指定关键词的声音文件

  • offset: 0：偏移量，用于分页，默认为 0，表示从第一个声音开始获取

  • 博客：

    • radioId: null：返回所有电台的声音
    • radioId: [播客id]：返回特定播客的声音

  • 是否公开：

    • type: null：返回所有类型的声音
    • type: "PUBLIC"：返回公开的声音
    • type: "PRIVATE"：返回隐私的声音

  • 是否付费：

    • voiceFeeType: null（默认）：返回所有类型的声音
    • voiceFeeType: -1：返回所有类型的声音
    • voiceFeeType: 0：返回免费的声音
    • voiceFeeType: 1：返回收费的声音

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/voicelist/list/search'

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

/cm/ncm/voicelist/search​

播客列表

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

公开只读，按当前网关策略处理。项目专用路由若与此路径同名，专用路由规则优先。

上游参数与业务说明​

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

说明: 可以获取播客列表

接口地址: /voicelist/search

必选参数：

keyword: 搜索关键词

可选参数：

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

offset: 偏移数量 , 用于分页 , 默认为 30

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/voicelist/search'

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