跳到主要内容

网易云代理 T3

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

/cm/ncm/captcha/safe/sent​

发送安全验证码

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明: 登录后调用此接口, 传入手机号, 可发送安全验证码

必选参数 : phone: 手机号

接口地址 : /captcha/safe/sent

调用例子 : /captcha/safe/sent?phone=13XXXXXXXXX

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/captcha/safe/sent' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/captcha/sent​

发送验证码

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 调用此接口 ,传入手机号码, 可发送验证码

必选参数 : phone: 手机号码

可选参数 : ctcode: 国家区号,默认 86 即中国

接口地址 : /captcha/sent

调用例子 : /captcha/sent?phone=13xxx

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/captcha/sent' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/captcha/sent/v1​

新版发送验证码

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 调用此接口 ,传入手机号码, 可发送验证码

必选参数 : phone: 手机号码

可选参数 : ctcode: 国家区号,默认 86 即中国

接口地址 : /captcha/sent/v1

调用例子 : /captcha/sent/v1?phone=13xxx

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/captcha/sent/v1' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/captcha/verify​

验证验证码

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 调用此接口 ,传入手机号码和验证码, 可校验验证码是否正确

必选参数 : phone: 手机号码

captcha: 验证码

可选参数 :

ctcode: 国家区号,默认 86 即中国

接口地址 : /captcha/verify

调用例子 : /captcha/verify?phone=13xxx&captcha=1597

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/captcha/verify' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/login​

登录

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 登录有三个接口,建议使用encodeURIComponent对密码编码或者使用POST请求,避免某些特殊字符无法解析,如#(#在 url 中会被识别为 hash,而不是 query)

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

!> 因网易增加了网易云盾验证,密码登录暂时不要使用,尽量使用短信验证码登录和二维码登录,否则调用某些接口会触发需要验证的错误

!> 二开作者注: 在v4.29.18版本中修复了短信登录的问题, 现在可以正常使用了

1. 手机登录​

必选参数 : phone: 手机号码

password: 密码

可选参数 : countrycode: 国家码，用于国外手机号登录，例如美国传入：1

md5_password: md5 加密后的密码,传入后 password 参数将失效

captcha: 验证码,使用 /captcha/sent 或 /captcha/sent/v1接口传入手机号获取验证码,调用此接口传入验证码,可使用验证码登录,传入后 password 参数将失效

sca: 网易易盾滑块验证token, 获取方式未知

接口地址 : /login/cellphone

调用例子 : /login/cellphone?phone=xxx&password=yyy /login/cellphone?phone=xxx&md5_password=yyy /login/cellphone?phone=xxx&captcha=1234

2. 邮箱登录​

必选参数 :

email: 163 网易邮箱

password: 密码

可选参数 :

md5_password: md5 加密后的密码,传入后 password 将失效

接口地址 : /login

调用例子 : /[email protected]&password=yyy

完成登录后 , 会在浏览器保存一个 Cookies 用作登录凭证 , 大部分 API 都需要用到这个 Cookies,非跨域情况请求会自动带上 Cookies,跨域情况参考调用前须知

v3.30.0 后支持手动传入 cookie,登录接口返回内容新增 cookie 字段,保存到本地后,get 请求带上?cookie=xxx (先使用 encodeURIComponent() 编码 cookie 值) 或者 post 请求 body 带上 cookie 即可,如:/user/cloud?cookie=xxx 或者

{
    ...,
    cookie:"xxx"
}

另外的 cookie 说明: 可以直接从浏览器中获取 cookie 值, 只需要其中 key 为MUSIC_U的数据即可 请求

GET https://example.com/search?keywords=HELLO&cookie=MUSIC_U%3Dxxxx
POST https://example.com/search?keywords=HELLO
body {
  ...,
  "cookie": "MUSIC_U=xxxx"
}
3. 二维码登录​

说明: 二维码登录涉及到 3 个接口,调用务必带上时间戳,防止缓存

1. 二维码 key 生成接口​

说明: 调用此接口可生成一个 key

接口地址 : /login/qr/key

2. 二维码生成接口​

说明: 调用此接口传入上一个接口生成的 key 可生成二维码图片的 base64 和二维码信息,可使用 base64 展示图片,或者使用二维码信息内容自行使用第三方二维码生成库渲染二维码

必选参数: key,由第一个接口生成

可选参数: qrimg 传入后会额外返回二维码图片 base64 编码

接口地址 : /login/qr/create

调用例子 : /login/qr/create?key=xxx

3. 二维码检测扫码状态接口​

说明: 轮询此接口可获取二维码扫码状态,800 为二维码过期,801 为等待扫码,802 为待确认,803 为授权登录成功(803 状态码下会返回 cookies),如扫码后返回 502,则需加上 noCookie 参数,如&noCookie=true

必选参数: key,由第一个接口生成

接口地址 : /login/qr/check

调用例子 : /login/qr/check?key=xxx

调用可参考项目文件例子

/public/qrlogin.html (访问地址:http://localhost:3000/qrlogin.html)

/public/qrlogin-nocookie.html (访问地址:http://localhost:3000/qrlogin-nocookie.html)

3. 游客登录​

说明 : 直接调用此接口, 可获取游客 cookie,如果遇到其他接口未登录状态报 400 状态码需要验证的错误,可使用此接口获取游客 cookie 避免报错

接口地址 : /register/anonimous

注意​

调用登录接口的速度比调用其他接口慢 , 因为登录过程调用了加密算法

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/login' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/login/cellphone​

登录

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 登录有三个接口,建议使用encodeURIComponent对密码编码或者使用POST请求,避免某些特殊字符无法解析,如#(#在 url 中会被识别为 hash,而不是 query)

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

!> 因网易增加了网易云盾验证,密码登录暂时不要使用,尽量使用短信验证码登录和二维码登录,否则调用某些接口会触发需要验证的错误

!> 二开作者注: 在v4.29.18版本中修复了短信登录的问题, 现在可以正常使用了

1. 手机登录​

必选参数 : phone: 手机号码

password: 密码

可选参数 : countrycode: 国家码，用于国外手机号登录，例如美国传入：1

md5_password: md5 加密后的密码,传入后 password 参数将失效

captcha: 验证码,使用 /captcha/sent 或 /captcha/sent/v1接口传入手机号获取验证码,调用此接口传入验证码,可使用验证码登录,传入后 password 参数将失效

sca: 网易易盾滑块验证token, 获取方式未知

接口地址 : /login/cellphone

调用例子 : /login/cellphone?phone=xxx&password=yyy /login/cellphone?phone=xxx&md5_password=yyy /login/cellphone?phone=xxx&captcha=1234

2. 邮箱登录​

必选参数 :

email: 163 网易邮箱

password: 密码

可选参数 :

md5_password: md5 加密后的密码,传入后 password 将失效

接口地址 : /login

调用例子 : /[email protected]&password=yyy

完成登录后 , 会在浏览器保存一个 Cookies 用作登录凭证 , 大部分 API 都需要用到这个 Cookies,非跨域情况请求会自动带上 Cookies,跨域情况参考调用前须知

v3.30.0 后支持手动传入 cookie,登录接口返回内容新增 cookie 字段,保存到本地后,get 请求带上?cookie=xxx (先使用 encodeURIComponent() 编码 cookie 值) 或者 post 请求 body 带上 cookie 即可,如:/user/cloud?cookie=xxx 或者

{
    ...,
    cookie:"xxx"
}

另外的 cookie 说明: 可以直接从浏览器中获取 cookie 值, 只需要其中 key 为MUSIC_U的数据即可 请求

GET https://example.com/search?keywords=HELLO&cookie=MUSIC_U%3Dxxxx
POST https://example.com/search?keywords=HELLO
body {
  ...,
  "cookie": "MUSIC_U=xxxx"
}
3. 二维码登录​

说明: 二维码登录涉及到 3 个接口,调用务必带上时间戳,防止缓存

1. 二维码 key 生成接口​

说明: 调用此接口可生成一个 key

接口地址 : /login/qr/key

2. 二维码生成接口​

说明: 调用此接口传入上一个接口生成的 key 可生成二维码图片的 base64 和二维码信息,可使用 base64 展示图片,或者使用二维码信息内容自行使用第三方二维码生成库渲染二维码

必选参数: key,由第一个接口生成

可选参数: qrimg 传入后会额外返回二维码图片 base64 编码

接口地址 : /login/qr/create

调用例子 : /login/qr/create?key=xxx

3. 二维码检测扫码状态接口​

说明: 轮询此接口可获取二维码扫码状态,800 为二维码过期,801 为等待扫码,802 为待确认,803 为授权登录成功(803 状态码下会返回 cookies),如扫码后返回 502,则需加上 noCookie 参数,如&noCookie=true

必选参数: key,由第一个接口生成

接口地址 : /login/qr/check

调用例子 : /login/qr/check?key=xxx

调用可参考项目文件例子

/public/qrlogin.html (访问地址:http://localhost:3000/qrlogin.html)

/public/qrlogin-nocookie.html (访问地址:http://localhost:3000/qrlogin-nocookie.html)

3. 游客登录​

说明 : 直接调用此接口, 可获取游客 cookie,如果遇到其他接口未登录状态报 400 状态码需要验证的错误,可使用此接口获取游客 cookie 避免报错

接口地址 : /register/anonimous

注意​

调用登录接口的速度比调用其他接口慢 , 因为登录过程调用了加密算法

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/login/cellphone' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/login/qr/check​

登录

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 登录有三个接口,建议使用encodeURIComponent对密码编码或者使用POST请求,避免某些特殊字符无法解析,如#(#在 url 中会被识别为 hash,而不是 query)

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

!> 因网易增加了网易云盾验证,密码登录暂时不要使用,尽量使用短信验证码登录和二维码登录,否则调用某些接口会触发需要验证的错误

!> 二开作者注: 在v4.29.18版本中修复了短信登录的问题, 现在可以正常使用了

1. 手机登录​

必选参数 : phone: 手机号码

password: 密码

可选参数 : countrycode: 国家码，用于国外手机号登录，例如美国传入：1

md5_password: md5 加密后的密码,传入后 password 参数将失效

captcha: 验证码,使用 /captcha/sent 或 /captcha/sent/v1接口传入手机号获取验证码,调用此接口传入验证码,可使用验证码登录,传入后 password 参数将失效

sca: 网易易盾滑块验证token, 获取方式未知

接口地址 : /login/cellphone

调用例子 : /login/cellphone?phone=xxx&password=yyy /login/cellphone?phone=xxx&md5_password=yyy /login/cellphone?phone=xxx&captcha=1234

2. 邮箱登录​

必选参数 :

email: 163 网易邮箱

password: 密码

可选参数 :

md5_password: md5 加密后的密码,传入后 password 将失效

接口地址 : /login

调用例子 : /[email protected]&password=yyy

完成登录后 , 会在浏览器保存一个 Cookies 用作登录凭证 , 大部分 API 都需要用到这个 Cookies,非跨域情况请求会自动带上 Cookies,跨域情况参考调用前须知

v3.30.0 后支持手动传入 cookie,登录接口返回内容新增 cookie 字段,保存到本地后,get 请求带上?cookie=xxx (先使用 encodeURIComponent() 编码 cookie 值) 或者 post 请求 body 带上 cookie 即可,如:/user/cloud?cookie=xxx 或者

{
    ...,
    cookie:"xxx"
}

另外的 cookie 说明: 可以直接从浏览器中获取 cookie 值, 只需要其中 key 为MUSIC_U的数据即可 请求

GET https://example.com/search?keywords=HELLO&cookie=MUSIC_U%3Dxxxx
POST https://example.com/search?keywords=HELLO
body {
  ...,
  "cookie": "MUSIC_U=xxxx"
}
3. 二维码登录​

说明: 二维码登录涉及到 3 个接口,调用务必带上时间戳,防止缓存

1. 二维码 key 生成接口​

说明: 调用此接口可生成一个 key

接口地址 : /login/qr/key

2. 二维码生成接口​

说明: 调用此接口传入上一个接口生成的 key 可生成二维码图片的 base64 和二维码信息,可使用 base64 展示图片,或者使用二维码信息内容自行使用第三方二维码生成库渲染二维码

必选参数: key,由第一个接口生成

可选参数: qrimg 传入后会额外返回二维码图片 base64 编码

接口地址 : /login/qr/create

调用例子 : /login/qr/create?key=xxx

3. 二维码检测扫码状态接口​

说明: 轮询此接口可获取二维码扫码状态,800 为二维码过期,801 为等待扫码,802 为待确认,803 为授权登录成功(803 状态码下会返回 cookies),如扫码后返回 502,则需加上 noCookie 参数,如&noCookie=true

必选参数: key,由第一个接口生成

接口地址 : /login/qr/check

调用例子 : /login/qr/check?key=xxx

调用可参考项目文件例子

/public/qrlogin.html (访问地址:http://localhost:3000/qrlogin.html)

/public/qrlogin-nocookie.html (访问地址:http://localhost:3000/qrlogin-nocookie.html)

3. 游客登录​

说明 : 直接调用此接口, 可获取游客 cookie,如果遇到其他接口未登录状态报 400 状态码需要验证的错误,可使用此接口获取游客 cookie 避免报错

接口地址 : /register/anonimous

注意​

调用登录接口的速度比调用其他接口慢 , 因为登录过程调用了加密算法

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/login/qr/check' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/login/qr/create​

登录

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 登录有三个接口,建议使用encodeURIComponent对密码编码或者使用POST请求,避免某些特殊字符无法解析,如#(#在 url 中会被识别为 hash,而不是 query)

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

!> 因网易增加了网易云盾验证,密码登录暂时不要使用,尽量使用短信验证码登录和二维码登录,否则调用某些接口会触发需要验证的错误

!> 二开作者注: 在v4.29.18版本中修复了短信登录的问题, 现在可以正常使用了

1. 手机登录​

必选参数 : phone: 手机号码

password: 密码

可选参数 : countrycode: 国家码，用于国外手机号登录，例如美国传入：1

md5_password: md5 加密后的密码,传入后 password 参数将失效

captcha: 验证码,使用 /captcha/sent 或 /captcha/sent/v1接口传入手机号获取验证码,调用此接口传入验证码,可使用验证码登录,传入后 password 参数将失效

sca: 网易易盾滑块验证token, 获取方式未知

接口地址 : /login/cellphone

调用例子 : /login/cellphone?phone=xxx&password=yyy /login/cellphone?phone=xxx&md5_password=yyy /login/cellphone?phone=xxx&captcha=1234

2. 邮箱登录​

必选参数 :

email: 163 网易邮箱

password: 密码

可选参数 :

md5_password: md5 加密后的密码,传入后 password 将失效

接口地址 : /login

调用例子 : /[email protected]&password=yyy

完成登录后 , 会在浏览器保存一个 Cookies 用作登录凭证 , 大部分 API 都需要用到这个 Cookies,非跨域情况请求会自动带上 Cookies,跨域情况参考调用前须知

v3.30.0 后支持手动传入 cookie,登录接口返回内容新增 cookie 字段,保存到本地后,get 请求带上?cookie=xxx (先使用 encodeURIComponent() 编码 cookie 值) 或者 post 请求 body 带上 cookie 即可,如:/user/cloud?cookie=xxx 或者

{
    ...,
    cookie:"xxx"
}

另外的 cookie 说明: 可以直接从浏览器中获取 cookie 值, 只需要其中 key 为MUSIC_U的数据即可 请求

GET https://example.com/search?keywords=HELLO&cookie=MUSIC_U%3Dxxxx
POST https://example.com/search?keywords=HELLO
body {
  ...,
  "cookie": "MUSIC_U=xxxx"
}
3. 二维码登录​

说明: 二维码登录涉及到 3 个接口,调用务必带上时间戳,防止缓存

1. 二维码 key 生成接口​

说明: 调用此接口可生成一个 key

接口地址 : /login/qr/key

2. 二维码生成接口​

说明: 调用此接口传入上一个接口生成的 key 可生成二维码图片的 base64 和二维码信息,可使用 base64 展示图片,或者使用二维码信息内容自行使用第三方二维码生成库渲染二维码

必选参数: key,由第一个接口生成

可选参数: qrimg 传入后会额外返回二维码图片 base64 编码

接口地址 : /login/qr/create

调用例子 : /login/qr/create?key=xxx

3. 二维码检测扫码状态接口​

说明: 轮询此接口可获取二维码扫码状态,800 为二维码过期,801 为等待扫码,802 为待确认,803 为授权登录成功(803 状态码下会返回 cookies),如扫码后返回 502,则需加上 noCookie 参数,如&noCookie=true

必选参数: key,由第一个接口生成

接口地址 : /login/qr/check

调用例子 : /login/qr/check?key=xxx

调用可参考项目文件例子

/public/qrlogin.html (访问地址:http://localhost:3000/qrlogin.html)

/public/qrlogin-nocookie.html (访问地址:http://localhost:3000/qrlogin-nocookie.html)

3. 游客登录​

说明 : 直接调用此接口, 可获取游客 cookie,如果遇到其他接口未登录状态报 400 状态码需要验证的错误,可使用此接口获取游客 cookie 避免报错

接口地址 : /register/anonimous

注意​

调用登录接口的速度比调用其他接口慢 , 因为登录过程调用了加密算法

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/login/qr/create' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/login/qr/key​

登录

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 登录有三个接口,建议使用encodeURIComponent对密码编码或者使用POST请求,避免某些特殊字符无法解析,如#(#在 url 中会被识别为 hash,而不是 query)

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

!> 因网易增加了网易云盾验证,密码登录暂时不要使用,尽量使用短信验证码登录和二维码登录,否则调用某些接口会触发需要验证的错误

!> 二开作者注: 在v4.29.18版本中修复了短信登录的问题, 现在可以正常使用了

1. 手机登录​

必选参数 : phone: 手机号码

password: 密码

可选参数 : countrycode: 国家码，用于国外手机号登录，例如美国传入：1

md5_password: md5 加密后的密码,传入后 password 参数将失效

captcha: 验证码,使用 /captcha/sent 或 /captcha/sent/v1接口传入手机号获取验证码,调用此接口传入验证码,可使用验证码登录,传入后 password 参数将失效

sca: 网易易盾滑块验证token, 获取方式未知

接口地址 : /login/cellphone

调用例子 : /login/cellphone?phone=xxx&password=yyy /login/cellphone?phone=xxx&md5_password=yyy /login/cellphone?phone=xxx&captcha=1234

2. 邮箱登录​

必选参数 :

email: 163 网易邮箱

password: 密码

可选参数 :

md5_password: md5 加密后的密码,传入后 password 将失效

接口地址 : /login

调用例子 : /[email protected]&password=yyy

完成登录后 , 会在浏览器保存一个 Cookies 用作登录凭证 , 大部分 API 都需要用到这个 Cookies,非跨域情况请求会自动带上 Cookies,跨域情况参考调用前须知

v3.30.0 后支持手动传入 cookie,登录接口返回内容新增 cookie 字段,保存到本地后,get 请求带上?cookie=xxx (先使用 encodeURIComponent() 编码 cookie 值) 或者 post 请求 body 带上 cookie 即可,如:/user/cloud?cookie=xxx 或者

{
    ...,
    cookie:"xxx"
}

另外的 cookie 说明: 可以直接从浏览器中获取 cookie 值, 只需要其中 key 为MUSIC_U的数据即可 请求

GET https://example.com/search?keywords=HELLO&cookie=MUSIC_U%3Dxxxx
POST https://example.com/search?keywords=HELLO
body {
  ...,
  "cookie": "MUSIC_U=xxxx"
}
3. 二维码登录​

说明: 二维码登录涉及到 3 个接口,调用务必带上时间戳,防止缓存

1. 二维码 key 生成接口​

说明: 调用此接口可生成一个 key

接口地址 : /login/qr/key

2. 二维码生成接口​

说明: 调用此接口传入上一个接口生成的 key 可生成二维码图片的 base64 和二维码信息,可使用 base64 展示图片,或者使用二维码信息内容自行使用第三方二维码生成库渲染二维码

必选参数: key,由第一个接口生成

可选参数: qrimg 传入后会额外返回二维码图片 base64 编码

接口地址 : /login/qr/create

调用例子 : /login/qr/create?key=xxx

3. 二维码检测扫码状态接口​

说明: 轮询此接口可获取二维码扫码状态,800 为二维码过期,801 为等待扫码,802 为待确认,803 为授权登录成功(803 状态码下会返回 cookies),如扫码后返回 502,则需加上 noCookie 参数,如&noCookie=true

必选参数: key,由第一个接口生成

接口地址 : /login/qr/check

调用例子 : /login/qr/check?key=xxx

调用可参考项目文件例子

/public/qrlogin.html (访问地址:http://localhost:3000/qrlogin.html)

/public/qrlogin-nocookie.html (访问地址:http://localhost:3000/qrlogin-nocookie.html)

3. 游客登录​

说明 : 直接调用此接口, 可获取游客 cookie,如果遇到其他接口未登录状态报 400 状态码需要验证的错误,可使用此接口获取游客 cookie 避免报错

接口地址 : /register/anonimous

注意​

调用登录接口的速度比调用其他接口慢 , 因为登录过程调用了加密算法

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/login/qr/key' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/login/refresh​

（文档未收录）

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游模块读取的参数​

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

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

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/login/refresh' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/login/status​

登录状态

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 调用此接口,可获取登录状态

接口地址 : /login/status

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/login/status' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/logout​

（文档未收录）

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游模块读取的参数​

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

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

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/logout' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/rebind​

更换绑定手机

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 调用此接口 ,可更换绑定手机(流程:先发送验证码到原手机号码,再发送验证码到新手机号码然后再调用此接口)

必选参数 : oldcaptcha: 原手机验证码

captcha: 新手机验证码

phone : 手机号码

ctcode : 国家区号,默认 86 即中国

接口地址 : /rebind

调用例子 : /rebind?phone=xxx&oldcaptcha=1234&captcha=5678

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/rebind' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/register/anonimous​

登录

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 登录有三个接口,建议使用encodeURIComponent对密码编码或者使用POST请求,避免某些特殊字符无法解析,如#(#在 url 中会被识别为 hash,而不是 query)

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

!> 因网易增加了网易云盾验证,密码登录暂时不要使用,尽量使用短信验证码登录和二维码登录,否则调用某些接口会触发需要验证的错误

!> 二开作者注: 在v4.29.18版本中修复了短信登录的问题, 现在可以正常使用了

1. 手机登录​

必选参数 : phone: 手机号码

password: 密码

可选参数 : countrycode: 国家码，用于国外手机号登录，例如美国传入：1

md5_password: md5 加密后的密码,传入后 password 参数将失效

captcha: 验证码,使用 /captcha/sent 或 /captcha/sent/v1接口传入手机号获取验证码,调用此接口传入验证码,可使用验证码登录,传入后 password 参数将失效

sca: 网易易盾滑块验证token, 获取方式未知

接口地址 : /login/cellphone

调用例子 : /login/cellphone?phone=xxx&password=yyy /login/cellphone?phone=xxx&md5_password=yyy /login/cellphone?phone=xxx&captcha=1234

2. 邮箱登录​

必选参数 :

email: 163 网易邮箱

password: 密码

可选参数 :

md5_password: md5 加密后的密码,传入后 password 将失效

接口地址 : /login

调用例子 : /[email protected]&password=yyy

完成登录后 , 会在浏览器保存一个 Cookies 用作登录凭证 , 大部分 API 都需要用到这个 Cookies,非跨域情况请求会自动带上 Cookies,跨域情况参考调用前须知

v3.30.0 后支持手动传入 cookie,登录接口返回内容新增 cookie 字段,保存到本地后,get 请求带上?cookie=xxx (先使用 encodeURIComponent() 编码 cookie 值) 或者 post 请求 body 带上 cookie 即可,如:/user/cloud?cookie=xxx 或者

{
    ...,
    cookie:"xxx"
}

另外的 cookie 说明: 可以直接从浏览器中获取 cookie 值, 只需要其中 key 为MUSIC_U的数据即可 请求

GET https://example.com/search?keywords=HELLO&cookie=MUSIC_U%3Dxxxx
POST https://example.com/search?keywords=HELLO
body {
  ...,
  "cookie": "MUSIC_U=xxxx"
}
3. 二维码登录​

说明: 二维码登录涉及到 3 个接口,调用务必带上时间戳,防止缓存

1. 二维码 key 生成接口​

说明: 调用此接口可生成一个 key

接口地址 : /login/qr/key

2. 二维码生成接口​

说明: 调用此接口传入上一个接口生成的 key 可生成二维码图片的 base64 和二维码信息,可使用 base64 展示图片,或者使用二维码信息内容自行使用第三方二维码生成库渲染二维码

必选参数: key,由第一个接口生成

可选参数: qrimg 传入后会额外返回二维码图片 base64 编码

接口地址 : /login/qr/create

调用例子 : /login/qr/create?key=xxx

3. 二维码检测扫码状态接口​

说明: 轮询此接口可获取二维码扫码状态,800 为二维码过期,801 为等待扫码,802 为待确认,803 为授权登录成功(803 状态码下会返回 cookies),如扫码后返回 502,则需加上 noCookie 参数,如&noCookie=true

必选参数: key,由第一个接口生成

接口地址 : /login/qr/check

调用例子 : /login/qr/check?key=xxx

调用可参考项目文件例子

/public/qrlogin.html (访问地址:http://localhost:3000/qrlogin.html)

/public/qrlogin-nocookie.html (访问地址:http://localhost:3000/qrlogin-nocookie.html)

3. 游客登录​

说明 : 直接调用此接口, 可获取游客 cookie,如果遇到其他接口未登录状态报 400 状态码需要验证的错误,可使用此接口获取游客 cookie 避免报错

接口地址 : /register/anonimous

注意​

调用登录接口的速度比调用其他接口慢 , 因为登录过程调用了加密算法

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/register/anonimous' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/register/cellphone​

注册(修改密码)

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 调用此接口 ,传入手机号码和验证码,密码,昵称, 可注册网易云音乐账号(同时可修改密码)

必选参数 :

captcha: 验证码

phone : 手机号码

password: 密码

nickname: 昵称

可选参数 :

countrycode: 国家码，用于国外手机号，例如美国传入：1 ,默认 86 即中国

接口地址 : /register/cellphone

调用例子 : /register/cellphone?phone=13xxx&password=xxxxx&captcha=1234&nickname=binary1345

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/register/cellphone' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/setting​

设置

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 登录后调用此接口 ,可获取用户设置

接口地址 : /setting

调用例子 : /setting

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/setting' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/user/bindingcellphone​

（文档未收录）

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游模块读取的参数​

captcha, countrycode, password, phone

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

参数模块中的读取/默认表达式
captchacaptcha: query.captcha,
countrycodecountrycode: query.countrycode || '86',
passwordpassword: query.password ? CryptoJS.MD5(query.password).toString() : '',
phonephone: query.phone,

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/user/bindingcellphone' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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

/cm/ncm/user/replacephone​

用户绑定手机

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

此路径不允许泛化代理，调用返回 403。请使用账号、绑定等项目专用接口。下面的上游资料只作协议参考。

上游参数与业务说明​

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

说明 : 登录后调用此接口 , 可以更换绑定手机

必选参数 :

phone : 手机号码

oldcaptcha: 原手机号码的验证码

captcha:新手机号码的验证码

可选参数 :

countrycode: 国家地区代码,默认 86

接口地址 : /user/replacephone

调用例子 : /user/replacephone?phone=xxx&captcha=1234&oldcaptcha=2345

调用模板​

curl 'https://music.20110208.xyz/cm/ncm/user/replacephone' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

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