API.md

# NCM API Rust SDK 接口文档

> 本文档对应 [NeteaseCloudMusicApi Enhanced](https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced) 的 Rust SDK 版本，涵盖所有已实现的接口。
>
> 所有接口方法均挂载在 `ApiClient` 上，通过 `Query` 对象传参。使用前请先阅读 [README](../README.md) 了解基本用法。

---

## 目录

- [登录相关](#登录相关)
- [用户相关](#用户相关)
- [歌曲相关](#歌曲相关)
- [搜索相关](#搜索相关)
- [歌单相关](#歌单相关)
- [评论相关](#评论相关)
- [歌手相关](#歌手相关)
- [专辑相关](#专辑相关)
- [MV 相关](#mv-相关)
- [视频相关](#视频相关)
- [电台相关](#电台相关)
- [推荐相关](#推荐相关)
- [排行榜相关](#排行榜相关)
- [云盘相关](#云盘相关)
- [私信相关](#私信相关)
- [VIP/会员](#vip会员)
- [云贝](#云贝)
- [听歌足迹](#听歌足迹)
- [风格/曲风](#风格曲风)
- [数字专辑](#数字专辑)
- [声音/播客](#声音播客)
- [音乐人](#音乐人)
- [粉丝中心](#粉丝中心)
- [UGC 百科](#ugc-百科)
- [一起听](#一起听)
- [广播电台](#广播电台)
- [其他](#其他)

---

## 登录相关

---

#### 邮箱登录

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

**必选参数 :** `email` : 163 网易邮箱 ; `password` : 密码

**可选参数 :** `md5_password` : md5 加密后的密码，传入后 `password` 将失效

**方法名 :** `login`

**调用例子 :**
```rust
let query = Query::new()
    .param("email", "xxx@163.com")
    .param("password", "yyy");
let result = client.login(&query).await?;
```

---

#### 手机登录

说明 : 手机号码登录

**必选参数 :** `phone` : 手机号码

**可选参数 :**

- `password` : 密码
- `countrycode` : 国家码，用于国外手机号登录，例如美国传入 `1`
- `md5_password` : md5 加密后的密码，传入后 `password` 参数将失效
- `captcha` : 验证码，使用 `captcha_sent` 接口传入手机号获取验证码，调用此接口传入验证码可使用验证码登录，传入后 `password` 参数将失效

**方法名 :** `login_cellphone`

**调用例子 :**
```rust
let query = Query::new()
    .param("phone", "13xxx")
    .param("password", "yyy");
let result = client.login_cellphone(&query).await?;

// 或使用验证码登录
let query = Query::new()
    .param("phone", "13xxx")
    .param("captcha", "1234");
let result = client.login_cellphone(&query).await?;
```

---

#### 二维码 key 生成

说明 : 调用此接口可生成一个二维码登录用的 key

**方法名 :** `login_qr_key`

**调用例子 :**
```rust
let query = Query::new();
let result = client.login_qr_key(&query).await?;
```

---

#### 二维码生成

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

**必选参数 :** `key` : 由 `login_qr_key` 接口生成

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

**方法名 :** `login_qr_create`

**调用例子 :**
```rust
let query = Query::new()
    .param("key", "xxx")
    .param("qrimg", "true");
let result = client.login_qr_create(&query).await?;
```

---

#### 二维码检测扫码状态

说明 : 轮询此接口可获取二维码扫码状态，800 为二维码过期，801 为等待扫码，802 为待确认，803 为授权登录成功（803 状态码下会返回 cookies）

**必选参数 :** `key` : 由 `login_qr_key` 接口生成

**方法名 :** `login_qr_check`

**调用例子 :**
```rust
let query = Query::new().param("key", "xxx");
let result = client.login_qr_check(&query).await?;
```

---

#### 游客登录

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

**方法名 :** `register_anonimous`

**调用例子 :**
```rust
let query = Query::new();
let result = client.register_anonimous(&query).await?;
```

---

#### 刷新登录

说明 : 调用此接口，可刷新登录状态，返回内容包含新的 cookie（不支持刷新二维码登录的 cookie）

**方法名 :** `login_refresh`

**调用例子 :**
```rust
let query = Query::new();
let result = client.login_refresh(&query).await?;
```

---

#### 登录状态

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

**方法名 :** `login_status`

**调用例子 :**
```rust
let query = Query::new();
let result = client.login_status(&query).await?;
```

---

#### 退出登录

说明 : 调用此接口，可退出登录

**方法名 :** `logout`

**调用例子 :**
```rust
let query = Query::new();
let result = client.logout(&query).await?;
```

---

#### 发送验证码

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

**必选参数 :** `phone` : 手机号码

**可选参数 :** `ctcode` : 国家区号，默认 86 即中国

**方法名 :** `captcha_sent`

**调用例子 :**
```rust
let query = Query::new().param("phone", "13xxx");
let result = client.captcha_sent(&query).await?;
```

---

#### 验证验证码

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

**必选参数 :** `phone` : 手机号码 ; `captcha` : 验证码

**可选参数 :** `ctcode` : 国家区号，默认 86 即中国

**方法名 :** `captcha_verify`

**调用例子 :**
```rust
let query = Query::new()
    .param("phone", "13xxx")
    .param("captcha", "1597");
let result = client.captcha_verify(&query).await?;
```

---

#### 注册(修改密码)

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

**必选参数 :** `captcha` : 验证码 ; `phone` : 手机号码 ; `password` : 密码 ; `nickname` : 昵称

**可选参数 :** `countrycode` : 国家码，用于国外手机号，例如美国传入 `1`，默认 86 即中国

**方法名 :** `register_cellphone`

**调用例子 :**
```rust
let query = Query::new()
    .param("phone", "13xxx")
    .param("password", "xxxxx")
    .param("captcha", "1234")
    .param("nickname", "binary1345");
let result = client.register_cellphone(&query).await?;
```

---

#### 检测手机号码是否已注册

说明 : 调用此接口，可检测手机号码是否已注册

**必选参数 :** `phone` : 手机号码

**可选参数 :** `countrycode` : 国家码，用于国外手机号，例如美国传入 `1`，默认 86 即中国

**方法名 :** `cellphone_existence_check`

**调用例子 :**
```rust
let query = Query::new().param("phone", "13xxx");
let result = client.cellphone_existence_check(&query).await?;
```

---

#### 初始化昵称

说明 : 刚注册的账号（需登录），调用此接口，可初始化昵称

**必选参数 :** `nickname` : 昵称

**方法名 :** `activate_init_profile`

**调用例子 :**
```rust
let query = Query::new().param("nickname", "testUser2019");
let result = client.activate_init_profile(&query).await?;
```

---

#### 重复昵称检测

说明 : 调用此接口，可检测昵称是否重复，并提供备用昵称

**必选参数 :** `nickname` : 昵称

**方法名 :** `nickname_check`

**调用例子 :**
```rust
let query = Query::new().param("nickname", "binaryify");
let result = client.nickname_check(&query).await?;
```

---

#### 更换绑定手机

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

**必选参数 :** `oldcaptcha` : 原手机验证码 ; `captcha` : 新手机验证码 ; `phone` : 手机号码 ; `ctcode` : 国家区号，默认 86 即中国

**方法名 :** `rebind`

**调用例子 :**
```rust
let query = Query::new()
    .param("phone", "xxx")
    .param("oldcaptcha", "1234")
    .param("captcha", "5678");
let result = client.rebind(&query).await?;
```

---

### 用户相关

---

#### 获取用户详情

说明 : 登录后调用此接口，传入用户 id，可以获取用户详情

**必选参数 :** `uid` : 用户 id

**方法名 :** `user_detail`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_detail(&query).await?;
```

---

#### 获取用户详情（新版）

说明 : 登录后调用此接口，传入用户 id，可以获取用户详情（新版接口，返回更全面的信息）

**必选参数 :** `uid` : 用户 id

**方法名 :** `user_detail_new`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_detail_new(&query).await?;
```

---

#### 获取账号信息

说明 : 登录后调用此接口，可获取用户账号信息

**方法名 :** `user_account`

**调用例子 :**
```rust
let query = Query::new();
let result = client.user_account(&query).await?;
```

---

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

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

**方法名 :** `user_subcount`

**调用例子 :**
```rust
let query = Query::new();
let result = client.user_subcount(&query).await?;
```

---

#### 获取用户等级信息

说明 : 登录后调用此接口，可以获取用户等级信息，包含当前登录天数，听歌次数，下一等级需要的登录天数和听歌次数，当前等级进度

**方法名 :** `user_level`

**调用例子 :**
```rust
let query = Query::new();
let result = client.user_level(&query).await?;
```

---

#### 获取用户绑定信息

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

**必选参数 :** `uid` : 用户 id

**方法名 :** `user_binding`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_binding(&query).await?;
```

---

#### 用户绑定手机

说明 : 登录后调用此接口，可以绑定手机号码

**必选参数 :** `phone` : 手机号码 ; `captcha` : 验证码

**可选参数 :** `password` : 密码 ; `countrycode` : 国家地区代码，默认 86

**方法名 :** `user_bindingcellphone`

**调用例子 :**
```rust
let query = Query::new()
    .param("phone", "13xxx")
    .param("captcha", "1234");
let result = client.user_bindingcellphone(&query).await?;
```

---

#### 用户更换绑定手机

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

**必选参数 :** `phone` : 手机号码 ; `oldcaptcha` : 原手机号码的验证码 ; `captcha` : 新手机号码的验证码

**可选参数 :** `countrycode` : 国家地区代码，默认 86

**方法名 :** `user_replacephone`

**调用例子 :**
```rust
let query = Query::new()
    .param("phone", "xxx")
    .param("captcha", "1234")
    .param("oldcaptcha", "2345");
let result = client.user_replacephone(&query).await?;
```

---

#### 更新用户信息

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

**必选参数 :** `gender` : 性别 0:保密 1:男性 2:女性 ; `birthday` : 出生日期，时间戳 unix timestamp ; `nickname` : 用户昵称 ; `province` : 省份 id ; `city` : 城市 id ; `signature` : 用户签名

**方法名 :** `user_update`

**调用例子 :**
```rust
let query = Query::new()
    .param("gender", "0")
    .param("signature", "测试签名")
    .param("city", "440300")
    .param("nickname", "binary")
    .param("birthday", "1525918298004")
    .param("province", "440000");
let result = client.user_update(&query).await?;
```

---

#### 更新头像

说明 : 登录后调用此接口，可更新头像

**可选参数 :** `imgSize` : 图片尺寸，默认为 300 ; `imgX` : 水平裁剪偏移，方形图片可不传，默认为 0 ; `imgY` : 垂直裁剪偏移，方形图片可不传，默认为 0

**方法名 :** `avatar_upload`

**调用例子 :**
```rust
let query = Query::new().param("imgSize", "200");
let result = client.avatar_upload(&query).await?;
```

---

#### 获取用户歌单

说明 : 登录后调用此接口，传入用户 id，可以获取用户歌单

**必选参数 :** `uid` : 用户 id

**可选参数 :** `limit` : 返回数量，默认为 30 ; `offset` : 偏移数量，用于分页，默认为 0

**方法名 :** `user_playlist`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_playlist(&query).await?;
```

---

#### 用户的创建歌单列表

说明 : 调用此接口，传入用户 id，获取用户的创建歌单列表

**必选参数 :** `uid` : 用户 id

**可选参数 :** `limit` : 返回数量，默认为 100 ; `offset` : 偏移数量，用于分页，默认为 0

**方法名 :** `user_playlist_create`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_playlist_create(&query).await?;
```

---

#### 用户的收藏歌单列表

说明 : 调用此接口，传入用户 id，获取用户的收藏歌单列表

**必选参数 :** `uid` : 用户 id

**可选参数 :** `limit` : 返回数量，默认为 100 ; `offset` : 偏移数量，用于分页，默认为 0

**方法名 :** `user_playlist_collect`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_playlist_collect(&query).await?;
```

---

#### 获取用户关注列表

说明 : 登录后调用此接口，传入用户 id，可以获取用户关注列表

**必选参数 :** `uid` : 用户 id

**可选参数 :** `limit` : 返回数量，默认为 30 ; `offset` : 偏移数量，用于分页，默认为 0

**方法名 :** `user_follows`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_follows(&query).await?;
```

---

#### 获取用户粉丝列表

说明 : 登录后调用此接口，传入用户 id，可以获取用户粉丝列表

**必选参数 :** `uid` : 用户 id

**可选参数 :** `limit` : 返回数量，默认为 30 ; `offset` : 偏移数量，用于分页，默认为 0

**方法名 :** `user_followeds`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_followeds(&query).await?;
```

---

#### 当前账号关注的用户/歌手

说明 : 调用此接口，可获得当前账号关注的用户/歌手

**可选参数 :** `size` : 返回数量，默认为 30 ; `cursor` : 返回数据的 cursor，默认为 0，传入上一次返回结果的 cursor 将会返回下一页的数据 ; `scene` : 场景，0 表示所有关注，1 表示关注的歌手，2 表示关注的用户，默认为 0

**方法名 :** `user_follow_mixed`

**调用例子 :**
```rust
let query = Query::new().param("scene", "1");
let result = client.user_follow_mixed(&query).await?;
```

---

#### 用户是否互相关注

说明 : 登录后调用此接口，传入用户 id，可判断用户是否互相关注

**必选参数 :** `uid` : 用户 id

**方法名 :** `user_mutualfollow_get`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_mutualfollow_get(&query).await?;
```

---

#### 获取用户动态

说明 : 登录后调用此接口，传入用户 id，可以获取用户动态

**必选参数 :** `uid` : 用户 id

**可选参数 :** `limit` : 返回数量，默认为 30 ; `lasttime` : 返回数据的 `lasttime`，默认 -1，传入上一次返回结果的 lasttime，将会返回下一页的数据

**方法名 :** `user_event`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_event(&query).await?;
```

---

#### 获取用户播放记录

说明 : 登录后调用此接口，传入用户 id，可获取用户播放记录

**必选参数 :** `uid` : 用户 id

**可选参数 :** `type` : type=1 时只返回 weekData，type=0 时返回 allData

**方法名 :** `user_record`

**调用例子 :**
```rust
let query = Query::new()
    .param("uid", "32953014")
    .param("type", "1");
let result = client.user_record(&query).await?;
```

---

#### 获取用户电台

说明 : 登录后调用此接口，传入用户 id，可以获取用户电台

**必选参数 :** `uid` : 用户 id

**方法名 :** `user_dj`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_dj(&query).await?;
```

---

#### 用户电台

说明 : 调用此接口，传入用户 id 可获取用户创建的电台

**必选参数 :** `uid` : 用户 id

**方法名 :** `user_audio`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_audio(&query).await?;
```

---

#### 获取用户历史评论

说明 : 登录后调用此接口，传入用户 id，可以获取用户历史评论

**必选参数 :** `uid` : 用户 id

**可选参数 :** `limit` : 返回数量，默认为 10 ; `time` : 上一条数据的 time，第一页不需要传，默认为 0

**方法名 :** `user_comment_history`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_comment_history(&query).await?;
```

---

#### 用户徽章

说明 : 调用此接口，传入用户 id，获取用户徽章

**必选参数 :** `uid` : 用户 id

**方法名 :** `user_medal`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_medal(&query).await?;
```

---

#### 用户状态

说明 : 登录后调用此接口，传入用户 id，获取用户社交状态

**必选参数 :** `uid` : 用户 id

**方法名 :** `user_social_status`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.user_social_status(&query).await?;
```

---

#### 用户状态 - 编辑

说明 : 登录后调用此接口，编辑当前用户状态，所需参数可在 `user_social_status_support` 接口获取

**方法名 :** `user_social_status_edit`

**调用例子 :**
```rust
let query = Query::new();
let result = client.user_social_status_edit(&query).await?;
```

---

#### 用户状态 - 相同状态的用户

说明 : 登录后调用此接口，获取相同状态的用户

**方法名 :** `user_social_status_rcmd`

**调用例子 :**
```rust
let query = Query::new();
let result = client.user_social_status_rcmd(&query).await?;
```

---

#### 用户状态 - 支持设置的状态

说明 : 登录后调用此接口，获取支持设置的状态

**方法名 :** `user_social_status_support`

**调用例子 :**
```rust
let query = Query::new();
let result = client.user_social_status_support(&query).await?;
```

---

#### 关注/取消关注用户

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

**必选参数 :** `id` : 用户 id ; `t` : `1` 为关注，其他为取消关注

**方法名 :** `follow`

**调用例子 :**
```rust
let query = Query::new()
    .param("id", "32953014")
    .param("t", "1");
let result = client.follow(&query).await?;
```

---

#### 私信和通知接口

说明 : 登录后调用此接口，可获取私信和通知数量信息

**方法名 :** `pl_count`

**调用例子 :**
```rust
let query = Query::new();
let result = client.pl_count(&query).await?;
```

---

#### 国家编码列表

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

**方法名 :** `countries_code_list`

**调用例子 :**
```rust
let query = Query::new();
let result = client.countries_code_list(&query).await?;
```

---

#### 设置

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

**方法名 :** `setting`

**调用例子 :**
```rust
let query = Query::new();
let result = client.setting(&query).await?;
```

---

#### 根据 nickname 获取 userid

说明 : 使用此接口，传入用户昵称，可获取对应的用户 id，支持批量获取，多个昵称用分号(;)隔开

**必选参数 :** `nicknames` : 用户昵称，多个用分号(;)隔开

**方法名 :** `get_userids`

**调用例子 :**
```rust
let query = Query::new().param("nicknames", "test1;test2");
let result = client.get_userids(&query).await?;
```

---

### 歌曲相关

---

#### 获取歌曲详情

说明 : 调用此接口，传入音乐 id（支持多个 id，用逗号隔开），可获得歌曲详情

**必选参数 :** `ids` : 音乐 id，如 `ids=347230` 或者 `ids=347230,347231`

**方法名 :** `song_detail`

**调用例子 :**
```rust
let query = Query::new().param("ids", "347230,347231");
let result = client.song_detail(&query).await?;
```

---

#### 获取音乐 url

说明 : 使用歌单详情接口后，能得到的音乐的 id，但不能得到的音乐 url，调用此接口，传入的音乐 id（可多个，用逗号隔开），可以获取对应的音乐的 url，未登录状态或者非会员返回试听片段

**必选参数 :** `id` : 音乐 id

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

**方法名 :** `song_url`

**调用例子 :**
```rust
let query = Query::new().param("id", "1969519579");
let result = client.song_url(&query).await?;
```

---

#### 获取音乐 url - 新版

说明 : 使用注意事项同上

**必选参数 :** `id` : 音乐 id ; `level` : 播放音质等级，分为 `standard` => 标准，`higher` => 较高，`exhigh` => 极高，`lossless` => 无损，`hires` => Hi-Res，`jyeffect` => 高清环绕声，`sky` => 沉浸环绕声，`dolby` => 杜比全景声，`jymaster` => 超清母带

**方法名 :** `song_url_v1`

**调用例子 :**
```rust
let query = Query::new()
    .param("id", "1969519579")
    .param("level", "exhigh");
let result = client.song_url_v1(&query).await?;
```

---

#### 302 到音乐 url - 新版

说明 : 只允许传入单个 id，会使用 302 重定向请求到目标 url

**必选参数 :** `id` : 音乐 id ; `level` : 播放音质等级（同 `song_url_v1`）

**方法名 :** `song_url_v1_302`

**调用例子 :**
```rust
let query = Query::new()
    .param("id", "1969519579")
    .param("level", "exhigh");
let result = client.song_url_v1_302(&query).await?;
```

---

#### 歌曲播放链接 (ncmget)

说明 : ncmget 占位接口，始终返回空数据

**方法名 :** `song_url_ncmget`

**调用例子 :**
```rust
let query = Query::new();
let result = client.song_url_ncmget(&query).await?;
```

---

#### 直接获取灰色歌曲链接

说明 : 网易云歌曲解灰功能。注意：此功能依赖外部 unblockmusic-utils，Rust SDK 暂不支持，调用会返回不支持的错误。

**必选参数 :** `id` : 音乐 id

**可选参数 :** `source` : 选择要解灰的音源，不支持多音源

**方法名 :** `song_url_match`

**调用例子 :**
```rust
let query = Query::new().param("id", "1969519579");
let result = client.song_url_match(&query).await?;
// 注意: Rust SDK 暂不支持此功能，会返回 500 状态码
```

---

#### 获取客户端歌曲下载 url

说明 : 使用 `/song/url` 接口获取的是歌曲试听 url，但存在部分歌曲在非 VIP 账号上可以下载无损音质而不能试听无损音质，使用此接口可使非 VIP 账号获取这些歌曲的无损音频

**必选参数 :** `id` : 音乐 id（仅支持单首歌曲）

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

**方法名 :** `song_download_url`

**调用例子 :**
```rust
let query = Query::new().param("id", "1969519579");
let result = client.song_download_url(&query).await?;
```

---

#### 获取客户端歌曲下载链接 - 新版

说明 : 使用 `song_url_v1` 接口获取的是歌曲试听 url，非 VIP 账号最高只能获取极高音质，但免费类型的歌曲（fee == 0）使用本接口可最高获取 Hi-Res 音质的 url

**必选参数 :** `id` : 音乐 id ; `level` : 播放音质等级（同 `song_url_v1`）

**方法名 :** `song_download_url_v1`

**调用例子 :**
```rust
let query = Query::new()
    .param("id", "2155423468")
    .param("level", "hires");
let result = client.song_download_url_v1(&query).await?;
```

---

#### 音乐是否可用

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

**必选参数 :** `id` : 歌曲 id

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

**方法名 :** `check_music`

**调用例子 :**
```rust
let query = Query::new().param("id", "1969519579");
let result = client.check_music(&query).await?;
```

---

#### 获取歌词

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

**必选参数 :** `id` : 音乐 id

**方法名 :** `lyric`

**调用例子 :**
```rust
let query = Query::new().param("id", "33894312");
let result = client.lyric(&query).await?;
```

---

#### 获取逐字歌词

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

**必选参数 :** `id` : 音乐 id

**方法名 :** `lyric_new`

**调用例子 :**
```rust
let query = Query::new().param("id", "1824020871");
let result = client.lyric_new(&query).await?;
```

---

#### 喜欢音乐

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

**必选参数 :** `id` : 歌曲 id

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

**方法名 :** `like`

**调用例子 :**
```rust
let query = Query::new().param("id", "347230");
let result = client.like(&query).await?;
```

---

#### 喜欢音乐列表

说明 : 调用此接口，传入用户 id，可获取已喜欢音乐 id 列表（id 数组）

**必选参数 :** `uid` : 用户 id

**方法名 :** `likelist`

**调用例子 :**
```rust
let query = Query::new().param("uid", "32953014");
let result = client.likelist(&query).await?;
```

---

#### 歌曲是否喜爱

说明 : 调用此接口，传入歌曲 id 列表，可检查歌曲是否被喜爱

**必选参数 :** `ids` : 歌曲 id 列表，如 `[2058263032,1497529942]`

**方法名 :** `song_like_check`

**调用例子 :**
```rust
let query = Query::new().param("ids", "[2058263032,1497529942]");
let result = client.song_like_check(&query).await?;
```

---

#### 听歌打卡

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

**必选参数 :** `id` : 歌曲 id ; `sourceid` : 歌单或专辑 id

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

**方法名 :** `scrobble`

**调用例子 :**
```rust
let query = Query::new()
    .param("id", "518066366")
    .param("sourceid", "36780169")
    .param("time", "291");
let result = client.scrobble(&query).await?;
```

---

#### 调整歌曲顺序

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

**必选参数 :** `pid` : 歌单 id ; `ids` : 歌曲 id 列表

**方法名 :** `song_order_update`

**调用例子 :**
```rust
let query = Query::new()
    .param("pid", "2039116066")
    .param("ids", "[5268328,1219871]");
let result = client.song_order_update(&query).await?;
```

---

#### 副歌时间

说明 : 调用此接口，传入歌曲 id，获取副歌时间

**必选参数 :** `id` : 歌曲 id

**方法名 :** `song_chorus`

**调用例子 :**
```rust
let query = Query::new().param("id", "2058263032");
let result = client.song_chorus(&query).await?;
```

---

#### 歌曲百科摘要

说明 : 调用此接口，传入歌曲 id，可获取歌曲百科摘要信息

**必选参数 :** `id` : 歌曲 id

**方法名 :** `song_wiki_summary`

**调用例子 :**
```rust
let query = Query::new().param("id", "1958384591");
let result = client.song_wiki_summary(&query).await?;
```

---

#### 歌曲音质详情

说明 : 调用此接口获取歌曲各个音质的文件信息，与获取歌曲详情接口相比，多出高清环绕声、沉浸环绕声、超清母带等音质的信息

**必选参数 :** `id` : 歌曲 id

**方法名 :** `song_music_detail`

**调用例子 :**
```rust
let query = Query::new().param("id", "2082700997");
let result = client.song_music_detail(&query).await?;
```

---

#### 歌曲红心数量

说明 : 调用此接口获取歌曲的红心用户数量

**必选参数 :** `id` : 歌曲 id

**方法名 :** `song_red_count`

**调用例子 :**
```rust
let query = Query::new().param("id", "186016");
let result = client.song_red_count(&query).await?;
```

---

#### 歌曲动态封面

说明 : 登录后调用此接口，传入歌曲 id，获取歌曲动态封面

**必选参数 :** `id` : 歌曲 id

**方法名 :** `song_dynamic_cover`

**调用例子 :**
```rust
let query = Query::new().param("id", "2101179024");
let result = client.song_dynamic_cover(&query).await?;
```

---

#### 会员下载歌曲记录

说明 : 调用此接口，可获得当前账号会员下载歌曲记录

**可选参数 :** `limit` : 返回数量，默认为 20 ; `offset` : 偏移数量，用于分页，默认为 0

**方法名 :** `song_downlist`

**调用例子 :**
```rust
let query = Query::new();
let result = client.song_downlist(&query).await?;
```

---

#### 会员本月下载歌曲记录

说明 : 调用此接口，可获得当前账号会员本月下载歌曲记录

**可选参数 :** `limit` : 返回数量，默认为 20 ; `offset` : 偏移数量，用于分页，默认为 0

**方法名 :** `song_monthdownlist`

**调用例子 :**
```rust
let query = Query::new();
let result = client.song_monthdownlist(&query).await?;
```

---

#### 已购买单曲下载记录

说明 : 调用此接口，可获得当前账号已购买单曲下载记录

**可选参数 :** `limit` : 返回数量，默认为 20 ; `offset` : 偏移数量，用于分页，默认为 0

**方法名 :** `song_singledownlist`

**调用例子 :**
```rust
let query = Query::new();
let result = client.song_singledownlist(&query).await?;
```

---

#### 已购单曲

说明 : 登录后调用此接口可获取已购买的单曲

**可选参数 :** `limit` : 返回数量，默认为 20 ; `offset` : 偏移数量，用于分页，默认为 0

**方法名 :** `song_purchased`

**调用例子 :**
```rust
let query = Query::new().param("limit", "10");
let result = client.song_purchased(&query).await?;
```

---

#### 歌词摘录 - 歌词摘录信息

说明 : 登录后调用此接口，传入歌曲 id，获取歌词摘录信息

**必选参数 :** `id` : 歌曲 id

**方法名 :** `song_lyrics_mark`

**调用例子 :**
```rust
let query = Query::new().param("id", "2058263032");
let result = client.song_lyrics_mark(&query).await?;
```

---

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

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

**必选参数 :** `id` : 歌曲 id ; `data` : 存储歌词摘录信息的对象数组的字符串

**可选参数 :** `markId` : 若需要修改摘录信息，则需要填入此参数

**方法名 :** `song_lyrics_mark_add`

**调用例子 :**
```rust
let query = Query::new()
    .param("id", "2058263032")
    .param("data", "[{\"translateType\":1,\"startTimeStamp\":800,\"translateLyricsText\":\"让我逃走吧\",\"originalLyricsText\":\"逃がしてくれって声を枯らした\"}]");
let result = client.song_lyrics_mark_add(&query).await?;
```

---

#### 歌词摘录 - 删除摘录歌词

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

**必选参数 :** `id` : 摘录歌词 id

**方法名 :** `song_lyrics_mark_del`

**调用例子 :**
```rust
let query = Query::new().param("id", "2083850");
let result = client.song_lyrics_mark_del(&query).await?;
```

---

#### 歌词摘录 - 我的歌词本

说明 : 登录后调用此接口，获取我的歌词本

**可选参数 :** `limit` : 返回数量，默认为 20 ; `offset` : 偏移数量，用于分页，默认为 0

**方法名 :** `song_lyrics_mark_user_page`

**调用例子 :**
```rust
let query = Query::new();
let result = client.song_lyrics_mark_user_page(&query).await?;
```

---

#### 听歌识曲

说明 : 使用此接口，上传音频文件或者麦克风采集声音可识别对应歌曲信息

**必选参数 :** `duration` : 音频时长，单位秒 ; `audioFP` : 音频指纹

**方法名 :** `audio_match`

**调用例子 :**
```rust
let query = Query::new()
    .param("duration", "30")
    .param("audioFP", "...");
let result = client.audio_match(&query).await?;
```

---

### 搜索相关

---

#### 搜索

说明 : 调用此接口，传入搜索关键词可以搜索该音乐 / 专辑 / 歌手 / 歌单 / 用户，关键词可以多个，以空格隔开（不需要登录），可通过 `song_url` 接口传入歌曲 id 获取具体的播放链接

**必选参数 :** `keywords` : 关键词

**可选参数 :** `limit` : 返回数量，默认为 30 ; `offset` : 偏移数量，用于分页，默认为 0 ; `type` : 搜索类型，默认为 1 即单曲，取值意义：1: 单曲，10: 专辑，100: 歌手，1000: 歌单，1002: 用户，1004: MV，1006: 歌词，1009: 电台，1014: 视频，1018: 综合，2000: 声音

**方法名 :** `search`

**调用例子 :**
```rust
let query = Query::new()
    .param("keywords", "海阔天空")
    .param("type", "1")
    .param("limit", "30");
let result = client.search(&query).await?;
```

---

#### 搜索（综合）

说明 : 调用此接口，传入搜索关键词可以搜索该音乐 / 专辑 / 歌手 / 歌单 / 用户（返回结果更全面）

**必选参数 :** `keywords` : 关键词

**可选参数 :** `limit` : 返回数量，默认为 30 ; `offset` : 偏移数量，用于分页，默认为 0 ; `type` : 搜索类型（同 `search`）

**方法名 :** `cloudsearch`

**调用例子 :**
```rust
let query = Query::new()
    .param("keywords", "海阔天空");
let result = client.cloudsearch(&query).await?;
```

---

#### 默认搜索关键词

说明 : 调用此接口，可获取默认搜索关键词

**方法名 :** `search_default`

**调用例子 :**
```rust
let query = Query::new();
let result = client.search_default(&query).await?;
```

---

#### 热搜列表(简略)

说明 : 调用此接口，可获取热门搜索列表

**方法名 :** `search_hot`

**调用例子 :**
```rust
let query = Query::new();
let result = client.search_hot(&query).await?;
```

---

#### 热搜列表(详细)

说明 : 调用此接口，可获取热门搜索列表（详细版）

**方法名 :** `search_hot_detail`

**调用例子 :**
```rust
let query = Query::new();
let result = client.search_hot_detail(&query).await?;
```

---

#### 搜索建议

说明 : 调用此接口，传入搜索关键词可获得搜索建议，搜索结果同时包含单曲、歌手、歌单信息

**必选参数 :** `keywords` : 关键词

**可选参数 :** `type` : 如果传 `mobile` 则返回移动端数据

**方法名 :** `search_suggest`

**调用例子 :**
```rust
let query = Query::new().param("keywords", "海阔天空");
let result = client.search_suggest(&query).await?;
```

---

#### 搜索多重匹配

说明 : 调用此接口，传入搜索关键词可获得搜索结果

**必选参数 :** `keywords` : 关键词

**方法名 :** `search_multimatch`

**调用例子 :**
```rust
let query = Query::new().param("keywords", "海阔天空");
let result = client.search_multimatch(&query).await?;
```

---

#### 本地歌曲文件匹配网易云歌曲信息

说明 : 调用此接口可以为本地歌曲文件搜索匹配歌曲 ID、专辑封面等信息

**必选参数 :** `title` : 文件的标题信息 ; `album` : 文件的专辑信息 ; `artist` : 文件的艺术家信息 ; `duration` : 文件的时长，单位为秒 ; `md5` : 文件的 md5

**方法名 :** `search_match`

**调用例子 :**
```rust
let query = Query::new()
    .param("title", "富士山下")
    .param("album", "")
    .param("artist", "陈奕迅")
    .param("duration", "259.21")
    .param("md5", "bd708d006912a09d827f02e754cf8e56");
let result = client.search_match(&query).await?;
```

---

## 歌单相关

### 新建歌单

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

**必选参数 :** `name` : 歌单名

**可选参数 :** `privacy` : 是否设置为隐私歌单，默认否，传'10'则设置成隐私歌单

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

**方法名 :** `playlist_create`

**调用例子 :**
```rust
let query = Query::new().param("name", "测试歌单");
let result = client.playlist_create(&query).await?;

// 创建视频歌单
let query = Query::new().param("name", "test").param("type", "VIDEO");
let result = client.playlist_create(&query).await?;
```

### 删除歌单

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

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

**方法名 :** `playlist_delete`

**调用例子 :**
```rust
let query = Query::new().param("id", "2947311456");
let result = client.playlist_delete(&query).await?;
```

### 收藏/取消收藏歌单

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

**必选参数 :** `t` : 类型,1:收藏,2:取消收藏

`id` : 歌单 id

**方法名 :** `playlist_subscribe`

**调用例子 :**
```rust
let query = Query::new().param("t", "1").param("id", "106697785");
let result = client.playlist_subscribe(&query).await?;
```

### 歌单收藏者

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

**必选参数 :** `id` : 歌单 id

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

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

**方法名 :** `playlist_subscribers`

**调用例子 :**
```rust
let query = Query::new().param("id", "544215255").param("limit", "30");
let result = client.playlist_subscribers(&query).await?;
```

### 获取歌单详情

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

**必选参数 :** `id` : 歌单 id

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

**方法名 :** `playlist_detail`

**调用例子 :**
```rust
let query = Query::new().param("id", "24381616");
let result = client.playlist_detail(&query).await?;
```

### 歌单详情动态

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

**必选参数 :** `id` : 歌单 id

**方法名 :** `playlist_detail_dynamic`

**调用例子 :**
```rust
let query = Query::new().param("id", "24381616");
let result = client.playlist_detail_dynamic(&query).await?;
```

### 相关歌单推荐

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

**必选参数 :** `id` : 歌单 id

**方法名 :** `playlist_detail_rcmd_get`

**调用例子 :**
```rust
let query = Query::new().param("id", "8039587836");
let result = client.playlist_detail_rcmd_get(&query).await?;
```

### 获取歌单所有歌曲

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

**必选参数 :** `id` : 歌单 id

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

`offset` : 默认值为 0

**方法名 :** `playlist_track_all`

**调用例子 :**
```rust
let query = Query::new().param("id", "24381616").param("limit", "10").param("offset", "0");
let result = client.playlist_track_all(&query).await?;
```

### 对歌单添加或删除歌曲

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

**必选参数 :** `op` : 从歌单增加单曲为 add, 删除为 del

`pid` : 歌单 id

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

**方法名 :** `playlist_tracks`

**调用例子 :**
```rust
let query = Query::new()
    .param("op", "add")
    .param("pid", "24381616")
    .param("tracks", "347231");
let result = client.playlist_tracks(&query).await?;
```

### 收藏视频到视频歌单

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

**必选参数 :** `pid` : 歌单 id

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

**方法名 :** `playlist_track_add`

**调用例子 :**
```rust
let query = Query::new().param("pid", "5271999357").param("ids", "186041");
let result = client.playlist_track_add(&query).await?;
```

### 删除视频歌单里的视频

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

**必选参数 :** `pid` : 歌单 id

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

**方法名 :** `playlist_track_delete`

**调用例子 :**
```rust
let query = Query::new().param("pid", "5271999357").param("ids", "186041");
let result = client.playlist_track_delete(&query).await?;
```

### 更新歌单

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

**必选参数 :** `id` : 歌单 id

`name` : 歌单名字

`desc` : 歌单描述

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

**方法名 :** `playlist_update`

**调用例子 :**
```rust
let query = Query::new()
    .param("id", "24381616")
    .param("name", "新歌单")
    .param("desc", "描述")
    .param("tags", "欧美");
let result = client.playlist_update(&query).await?;
```

### 更新歌单描述

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

**必选参数 :** `id` : 歌单 id

`desc` : 歌单描述

**方法名 :** `playlist_desc_update`

**调用例子 :**
```rust
let query = Query::new().param("id", "24381616").param("desc", "描述");
let result = client.playlist_desc_update(&query).await?;
```

### 更新歌单名

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

**必选参数 :** `id` : 歌单 id

`name` : 歌单名

**方法名 :** `playlist_name_update`

**调用例子 :**
```rust
let query = Query::new().param("id", "24381616").param("name", "歌单名");
let result = client.playlist_name_update(&query).await?;
```

### 更新歌单标签

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

**必选参数 :** `id` : 歌单 id

`tags` : 歌单标签

**方法名 :** `playlist_tags_update`

**调用例子 :**
```rust
let query = Query::new().param("id", "24381616").param("tags", "学习");
let result = client.playlist_tags_update(&query).await?;
```

### 歌单封面上传

说明 : 登录后调用此接口,使用 `'Content-Type': 'multipart/form-data'` 上传图片 formData(name 为'imgFile'),可更新歌单封面

**必选参数 :** `id` : 歌单 id

**可选参数 :** `imgSize` : 图片尺寸,默认为 300

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

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

**方法名 :** `playlist_cover_update`

**调用例子 :**
```rust
let query = Query::new().param("id", "3143833470").param("imgSize", "200");
let result = client.playlist_cover_update(&query).await?;
```

### 调整歌单顺序

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

**必选参数 :** `ids` : 歌单 id 列表

**方法名 :** `playlist_order_update`

**调用例子 :**
```rust
let query = Query::new().param("ids", "[111,222]");
let result = client.playlist_order_update(&query).await?;
```

### 歌单更新播放量

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

**必选参数 :** `id` : 歌单 id

**方法名 :** `playlist_update_playcount`

**调用例子 :**
```rust
let query = Query::new().param("id", "24381616");
let result = client.playlist_update_playcount(&query).await?;
```

### 歌单分类

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

**方法名 :** `playlist_catlist`

**调用例子 :**
```rust
let query = Query::new();
let result = client.playlist_catlist(&query).await?;
```

### 热门歌单分类

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

**方法名 :** `playlist_hot`

**调用例子 :**
```rust
let query = Query::new();
let result = client.playlist_hot(&query).await?;
```

### 歌单分类列表

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

**可选参数 :** `cat` : 分类标签, 默认为 "全部"

`limit` : 返回数量 , 默认为 24

**方法名 :** `playlist_category_list`

**调用例子 :**
```rust
let query = Query::new().param("cat", "华语").param("limit", "10");
let result = client.playlist_category_list(&query).await?;
```

### 精品歌单标签列表

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

**方法名 :** `playlist_highquality_tags`

**调用例子 :**
```rust
let query = Query::new();
let result = client.playlist_highquality_tags(&query).await?;
```

### 公开隐私歌单

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

**必选参数 :** `id` : 歌单 ID

**方法名 :** `playlist_privacy`

**调用例子 :**
```rust
let query = Query::new().param("id", "12345678");
let result = client.playlist_privacy(&query).await?;
```

### 获取点赞过的视频

说明 : 调用此接口, 可获取获取点赞过的视频

**方法名 :** `playlist_mylike`

**调用例子 :**
```rust
let query = Query::new();
let result = client.playlist_mylike(&query).await?;
```

### 最近播放的视频

说明 : 调用此接口 , 可获取最近播放的视频 ( 需要登录 )

**方法名 :** `playlist_video_recent`

**调用例子 :**
```rust
let query = Query::new();
let result = client.playlist_video_recent(&query).await?;
```

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

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

**可选参数 :** `local` : json 类型的字符串 (元数据导入)

`text` : 导入的文字 (文字导入)

`link` : 存有歌单链接的数组类型的字符串 (链接导入)

`importStarPlaylist` : 是否导入"我喜欢的音乐", 此项为 true 则不生成新的歌单

`playlistName` : 生成的歌单名, 仅文字导入和链接导入支持

**方法名 :** `playlist_import_name_task_create`

**调用例子 :**
```rust
// 文字导入
let query = Query::new().param("text", "海阔天空 Beyond");
let result = client.playlist_import_name_task_create(&query).await?;
```

### 歌单导入 - 任务状态

说明 : 调用此接口, 传入导入歌单任务 id, 获取任务状态

**必选参数 :** `id` : 任务 id

**方法名 :** `playlist_import_task_status`

**调用例子 :**
```rust
let query = Query::new().param("id", "123834369");
let result = client.playlist_import_task_status(&query).await?;
```

### 相关歌单

说明 : 请替换为相关歌单推荐接口(`playlist_detail_rcmd_get`); 本接口通过 html 抓取内容, 现已无法抓取歌单

**必选参数 :** `id` : 歌单 id

**方法名 :** `related_playlist`

**调用例子 :**
```rust
let query = Query::new().param("id", "1");
let result = client.related_playlist(&query).await?;
```

---

## 评论相关

### 歌曲评论

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

**必选参数 :** `id` : 音乐 id

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

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

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

**方法名 :** `comment_music`

**调用例子 :**
```rust
let query = Query::new().param("id", "186016").param("limit", "1");
let result = client.comment_music(&query).await?;
```

### 专辑评论

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

**必选参数 :** `id` : 专辑 id

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

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

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

**方法名 :** `comment_album`

**调用例子 :**
```rust
let query = Query::new().param("id", "32311");
let result = client.comment_album(&query).await?;
```

### 歌单评论

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

**必选参数 :** `id` : 歌单 id

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

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

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

**方法名 :** `comment_playlist`

**调用例子 :**
```rust
let query = Query::new().param("id", "705123491");
let result = client.comment_playlist(&query).await?;
```

### mv 评论

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

**必选参数 :** `id` : mv id

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

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

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

**方法名 :** `comment_mv`

**调用例子 :**
```rust
let query = Query::new().param("id", "5436712");
let result = client.comment_mv(&query).await?;
```

### 电台节目评论

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

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

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

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

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

**方法名 :** `comment_dj`

**调用例子 :**
```rust
let query = Query::new().param("id", "794062371");
let result = client.comment_dj(&query).await?;
```

### 视频评论

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

**必选参数 :** `id` : 视频的 id

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

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

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

**方法名 :** `comment_video`

**调用例子 :**
```rust
let query = Query::new().param("id", "89ADDE33C0AAE8EC14B99F6750DB954D");
let result = client.comment_video(&query).await?;
```

### 获取动态评论

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

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

**方法名 :** `comment_event`

**调用例子 :**
```rust
let query = Query::new().param("threadId", "A_EV_2_6559519868_32953014");
let result = client.comment_event(&query).await?;
```

### 楼层评论

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

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

`id` : 资源 id

`type` : 数字 , 资源类型 , 对应歌曲 , mv, 专辑 , 歌单 , 电台, 视频对应以下类型: 0: 歌曲, 1: mv, 2: 歌单, 3: 专辑, 4: 电台节目, 5: 视频, 6: 动态, 7: 电台

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

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

**方法名 :** `comment_floor`

**调用例子 :**
```rust
let query = Query::new()
    .param("parentCommentId", "1438569889")
    .param("id", "29764564")
    .param("type", "0");
let result = client.comment_floor(&query).await?;
```

### 热门评论

说明 : 调用此接口 , 传入 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`

**调用例子 :**
```rust
let query = Query::new().param("id", "186016").param("type", "0");
let result = client.comment_hot(&query).await?;
```

### 给评论点赞

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

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

`cid` : 评论 id

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

`type` : 数字 , 资源类型 , 对应歌曲 , mv, 专辑 , 歌单 , 电台, 视频对应以下类型: 0: 歌曲, 1: mv, 2: 歌单, 3: 专辑, 4: 电台节目, 5: 视频, 6: 动态, 7: 电台

**方法名 :** `comment_like`

**调用例子 :**
```rust
let query = Query::new()
    .param("id", "29178366")
    .param("cid", "12840183")
    .param("t", "1")
    .param("type", "0");
let result = client.comment_like(&query).await?;
```

### 新版评论接口

说明 : 调用此接口 , 传入资源类型和资源 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`

**调用例子 :**
```rust
let query = Query::new()
    .param("type", "0")
    .param("id", "1407551413")
    .param("sortType", "3");
let result = client.comment_new(&query).await?;
```

### 评论抱一抱列表

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

**必选参数 :** `uid` : 用户 id

`cid` : 评论 id

`sid` : 资源 id

**可选参数 :** `page` : 页数

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

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

`pageSize` : 每页页数,默认 100

**方法名 :** `comment_hug_list`

**调用例子 :**
```rust
let query = Query::new()
    .param("uid", "285516405")
    .param("cid", "1167145843")
    .param("sid", "863481066")
    .param("pageSize", "2")
    .param("page", "1");
let result = client.comment_hug_list(&query).await?;
```

### 评论统计数据

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

**必选参数 :** `type` : 数字 , 资源类型 , 对应以下类型: 0: 歌曲, 1: mv, 2: 歌单, 3: 专辑, 4: 电台节目, 5: 视频, 6: 动态, 7: 电台

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

**方法名 :** `comment_info_list`

**调用例子 :**
```rust
let query = Query::new().param("type", "0").param("ids", "186016,347230");
let result = client.comment_info_list(&query).await?;
```

### 抱一抱评论

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

**必选参数 :** `uid` : 用户 id

`cid` : 评论 id

`sid` : 资源 id

**方法名 :** `hug_comment`

**调用例子 :**
```rust
let query = Query::new()
    .param("uid", "285516405")
    .param("cid", "1167145843")
    .param("sid", "863481066");
let result = client.hug_comment(&query).await?;
```

### 云村星评馆 - 简要评论

说明 : 调用此接口可以获取首页推荐的星评馆评论信息

**方法名 :** `starpick_comments_summary`

**调用例子 :**
```rust
let query = Query::new();
let result = client.starpick_comments_summary(&query).await?;
```

---

## 歌手相关

### 获取歌手单曲

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

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

**方法名 :** `artists`

**调用例子 :**
```rust
let query = Query::new().param("id", "6452");
let result = client.artists(&query).await?;
```

### 获取歌手详情

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

**必选参数 :** `id` : 歌手 id

**方法名 :** `artist_detail`

**调用例子 :**
```rust
let query = Query::new().param("id", "11972054");
let result = client.artist_detail(&query).await?;
```

### 歌手详情动态

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

**必选参数 :** `id` : 歌手 id

**方法名 :** `artist_detail_dynamic`

**调用例子 :**
```rust
let query = Query::new().param("id", "15396");
let result = client.artist_detail_dynamic(&query).await?;
```

### 歌手全部歌曲

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

**必选参数 :** `id` : 歌手 id

**可选参数 :** `order` : `hot` ,`time` 按照热门或者时间排序

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

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

**方法名 :** `artist_songs`

**调用例子 :**
```rust
let query = Query::new().param("id", "6452");
let result = client.artist_songs(&query).await?;
```

### 获取歌手专辑

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

**必选参数 :** `id` : 歌手 id

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

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

**方法名 :** `artist_album`

**调用例子 :**
```rust
let query = Query::new().param("id", "6452").param("limit", "5");
let result = client.artist_album(&query).await?;
```

### 获取歌手描述

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

**必选参数 :** `id` : 歌手 id

**方法名 :** `artist_desc`

**调用例子 :**
```rust
let query = Query::new().param("id", "6452");
let result = client.artist_desc(&query).await?;
```

### 获取歌手 mv

说明 : 调用此接口 , 传入歌手 id, 可获得歌手 mv 信息 , 具体 mv 播放地址可调用 `mv_detail` 传入此接口获得的 mvid 来拿到

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

**方法名 :** `artist_mv`

**调用例子 :**
```rust
let query = Query::new().param("id", "6452");
let result = client.artist_mv(&query).await?;
```

### 歌手分类列表

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

**可选参数 :** `limit` : 返回数量 , 默认为 30

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

`initial` : 按首字母索引查找参数, 热门传-1,#传 0

`type` : 取值: -1:全部, 1:男歌手, 2:女歌手, 3:乐队

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

**方法名 :** `artist_list`

**调用例子 :**
```rust
let query = Query::new()
    .param("type", "1")
    .param("area", "96")
    .param("initial", "b");
let result = client.artist_list(&query).await?;
```

### 收藏/取消收藏歌手

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

**必选参数 :** `id` : 歌手 id

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

**方法名 :** `artist_sub`

**调用例子 :**
```rust
let query = Query::new().param("id", "6452").param("t", "1");
let result = client.artist_sub(&query).await?;
```

### 收藏的歌手列表

说明 : 调用此接口,可获取收藏的歌手列表

**可选参数 :** `limit` : 取出数量 , 默认为 25

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

**方法名 :** `artist_sublist`

**调用例子 :**
```rust
let query = Query::new();
let result = client.artist_sublist(&query).await?;
```

### 歌手热门 50 首歌曲

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

**必选参数 :** `id` : 歌手 id

**方法名 :** `artist_top_song`

**调用例子 :**
```rust
let query = Query::new().param("id", "6452");
let result = client.artist_top_song(&query).await?;
```

### 歌手粉丝

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

**必选参数 :** `id` : 歌手 id

**可选参数 :** `limit` : 取出数量 , 默认为 20

`offset` : 偏移数量 , 用于分页

**方法名 :** `artist_fans`

**调用例子 :**
```rust
let query = Query::new().param("id", "2116").param("limit", "10").param("offset", "0");
let result = client.artist_fans(&query).await?;
```

### 歌手粉丝数量

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

**必选参数 :** `id` : 歌手 id

**方法名 :** `artist_follow_count`

**调用例子 :**
```rust
let query = Query::new().param("id", "2116");
let result = client.artist_follow_count(&query).await?;
```

### 关注歌手新 MV

说明 : 登录后调用此接口可获取关注歌手新 MV

**可选参数 :** `limit` : 取出数量 , 默认为 20

`before` : 上一页数据返回的 publishTime 的数据

**方法名 :** `artist_new_mv`

**调用例子 :**
```rust
let query = Query::new().param("limit", "1");
let result = client.artist_new_mv(&query).await?;
```

### 关注歌手新歌

说明 : 登录后调用此接口可获取关注歌手新歌

**可选参数 :** `limit` : 取出数量 , 默认为 20

`before` : 上一页数据返回的 publishTime 的数据

**方法名 :** `artist_new_song`

**调用例子 :**
```rust
let query = Query::new().param("limit", "1");
let result = client.artist_new_song(&query).await?;
```

### 获取歌手视频

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

**必选参数 :** `id` : 歌手 id

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

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

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

**方法名 :** `artist_video`

**调用例子 :**
```rust
let query = Query::new().param("id", "2116");
let result = client.artist_video(&query).await?;
```

---

## 专辑相关

### 获取专辑内容

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

**必选参数 :** `id` : 专辑 id

**方法名 :** `album`

**调用例子 :**
```rust
let query = Query::new().param("id", "32311");
let result = client.album(&query).await?;
```

### 数字专辑详情

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

**必选参数 :** `id` : 专辑 id

**方法名 :** `album_detail`

**调用例子 :**
```rust
let query = Query::new().param("id", "84547195");
let result = client.album_detail(&query).await?;
```

### 专辑动态信息

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

**必选参数 :** `id` : 专辑 id

**方法名 :** `album_detail_dynamic`

**调用例子 :**
```rust
let query = Query::new().param("id", "32311");
let result = client.album_detail_dynamic(&query).await?;
```

### 收藏/取消收藏专辑

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

**必选参数 :** `id` : 专辑 id

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

**方法名 :** `album_sub`

**调用例子 :**
```rust
let query = Query::new().param("id", "32311").param("t", "1");
let result = client.album_sub(&query).await?;
```

### 获取已收藏专辑列表

说明 : 调用此接口 , 可获得已收藏专辑列表

**可选参数 :** `limit` : 取出数量 , 默认为 25

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

**方法名 :** `album_sublist`

**调用例子 :**
```rust
let query = Query::new();
let result = client.album_sublist(&query).await?;
```

### 最新专辑

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

**方法名 :** `album_newest`

**调用例子 :**
```rust
let query = Query::new();
let result = client.album_newest(&query).await?;
```

### 全部新碟

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

**可选参数 :** `limit` : 返回数量 , 默认为 30

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

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

**方法名 :** `album_new`

**调用例子 :**
```rust
let query = Query::new().param("area", "KR").param("limit", "10");
let result = client.album_new(&query).await?;
```

### 数字专辑-新碟上架

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

**可选参数 :** `limit` : 返回数量 , 默认为 30

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

**方法名 :** `album_list`

**调用例子 :**
```rust
let query = Query::new().param("limit", "10");
let result = client.album_list(&query).await?;
```

### 数字专辑-语种风格馆

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

**可选参数 :** `limit` : 返回数量 , 默认为 30

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

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

**方法名 :** `album_list_style`

**调用例子 :**
```rust
let query = Query::new().param("area", "Z_H").param("offset", "2");
let result = client.album_list_style(&query).await?;
```

### 获取专辑歌曲的音质

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

**必选参数 :** `id` : 专辑 id

**方法名 :** `album_privilege`

**调用例子 :**
```rust
let query = Query::new().param("id", "168223858");
let result = client.album_privilege(&query).await?;
```

### 数字专辑&数字单曲-榜单

说明 : 调用此接口 ,可获取数字专辑&数字单曲-榜单

**可选参数 :** `limit` : 返回数量 , 默认为 30

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

`albumType` : 0 为数字专辑, 1 为数字单曲

`type` : daily:日榜,week:周榜,year:年榜,total:总榜

**方法名 :** `album_songsaleboard`

**调用例子 :**
```rust
let query = Query::new()
    .param("type", "year")
    .param("year", "2020")
    .param("albumType", "0");
let result = client.album_songsaleboard(&query).await?;
```

---

## MV 相关

### 全部 mv

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

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

`type` : 类型,可选值为全部,官方版,原生,现场版,网易出品,不填则为全部

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

`limit` : 取出数量 , 默认为 30

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

**方法名 :** `mv_all`

**调用例子 :**
```rust
let query = Query::new().param("area", "港台");
let result = client.mv_all(&query).await?;
```

### 最新 mv

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

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

`limit` : 取出数量 , 默认为 30

**方法名 :** `mv_first`

**调用例子 :**
```rust
let query = Query::new().param("limit", "10");
let result = client.mv_first(&query).await?;
```

### 网易出品 mv

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

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

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

**方法名 :** `mv_exclusive_rcmd`

**调用例子 :**
```rust
let query = Query::new().param("limit", "10");
let result = client.mv_exclusive_rcmd(&query).await?;
```

### 获取 mv 数据

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

**必选参数 :** `mvid` : mv 的 id

**方法名 :** `mv_detail`

**调用例子 :**
```rust
let query = Query::new().param("mvid", "5436712");
let result = client.mv_detail(&query).await?;
```

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

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

**必选参数 :** `mvid` : mv 的 id

**方法名 :** `mv_detail_info`

**调用例子 :**
```rust
let query = Query::new().param("mvid", "5436712");
let result = client.mv_detail_info(&query).await?;
```

### mv 地址

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

**必选参数 :** `id` : mv id

**可选参数 :** `r` : 分辨率,默认 1080,可从 `mv_detail` 接口获取分辨率列表

**方法名 :** `mv_url`

**调用例子 :**
```rust
let query = Query::new().param("id", "5436712");
let result = client.mv_url(&query).await?;

// 指定分辨率
let query = Query::new().param("id", "10896407").param("r", "1080");
let result = client.mv_url(&query).await?;
```

### 收藏/取消收藏 MV

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

**必选参数 :** `mvid` : MV id

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

**方法名 :** `mv_sub`

**调用例子 :**
```rust
let query = Query::new().param("mvid", "5436712").param("t", "1");
let result = client.mv_sub(&query).await?;
```

### 收藏的 MV 列表

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

**方法名 :** `mv_sublist`

**调用例子 :**
```rust
let query = Query::new();
let result = client.mv_sublist(&query).await?;
```

### 推荐 mv

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

**方法名 :** `personalized_mv`

**调用例子 :**
```rust
let query = Query::new();
let result = client.personalized_mv(&query).await?;
```

### mv 排行

说明 : 调用此接口 , 可获取 mv 排行

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

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

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

**方法名 :** `top_mv`

**调用例子 :**
```rust
let query = Query::new().param("limit", "10");
let result = client.top_mv(&query).await?;
```

---

## 视频相关

### 获取视频标签列表

说明 : 调用此接口 , 可获取视频标签列表

**方法名 :** `video_group_list`

**调用例子 :**
```rust
let query = Query::new();
let result = client.video_group_list(&query).await?;
```

### 获取视频分类列表

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

**方法名 :** `video_category_list`

**调用例子 :**
```rust
let query = Query::new();
let result = client.video_category_list(&query).await?;
```

### 获取视频标签/分类下的视频

说明 : 调用此接口 , 传入标签/分类 `id`,可获取到相关的视频,分页参数只能传入 offset

**必选参数 :** `id` : videoGroup 的 id

**可选参数 :** `offset` : 默认 0

**方法名 :** `video_group`

**调用例子 :**
```rust
let query = Query::new().param("id", "9104");
let result = client.video_group(&query).await?;
```

### 获取全部视频列表

说明 : 调用此接口,可获取视频分类列表,分页参数只能传入 offset

**可选参数 :** `offset` : 默认 0

**方法名 :** `video_timeline_all`

**调用例子 :**
```rust
let query = Query::new();
let result = client.video_timeline_all(&query).await?;
```

### 获取推荐视频

说明 : 调用此接口, 可获取推荐视频,分页参数只能传入 offset

**可选参数 :** `offset` : 默认 0

**方法名 :** `video_timeline_recommend`

**调用例子 :**
```rust
let query = Query::new().param("offset", "10");
let result = client.video_timeline_recommend(&query).await?;
```

### 视频详情

说明 : 调用此接口 , 可获取视频详情

**必选参数 :** `id` : 视频 的 id

**方法名 :** `video_detail`

**调用例子 :**
```rust
let query = Query::new().param("id", "89ADDE33C0AAE8EC14B99F6750DB954D");
let result = client.video_detail(&query).await?;
```

### 获取视频点赞转发评论数数据

说明 : 调用此接口 , 传入 vid ( 视频 id ) , 可获取对应视频点赞转发评论数数据

**必选参数 :** `vid` : 视频 id

**方法名 :** `video_detail_info`

**调用例子 :**
```rust
let query = Query::new().param("vid", "89ADDE33C0AAE8EC14B99F6750DB954D");
let result = client.video_detail_info(&query).await?;
```

### 获取视频播放地址

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

**必选参数 :** `id` : 视频 的 id

**方法名 :** `video_url`

**调用例子 :**
```rust
let query = Query::new().param("id", "89ADDE33C0AAE8EC14B99F6750DB954D");
let result = client.video_url(&query).await?;
```

### 收藏视频

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

**必选参数 :** `id` : 视频 id

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

**方法名 :** `video_sub`

**调用例子 :**
```rust
let query = Query::new()
    .param("id", "89ADDE33C0AAE8EC14B99F6750DB954D")
    .param("t", "1");
let result = client.video_sub(&query).await?;
```

### 相关视频

说明 : 调用此接口 , 可获取相关视频

**必选参数 :** `id` : 视频 的 id

**方法名 :** `related_allvideo`

**调用例子 :**
```rust
let query = Query::new().param("id", "89ADDE33C0AAE8EC14B99F6750DB954D");
let result = client.related_allvideo(&query).await?;
```

### 获取 mlog 播放地址

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

**必选参数 :** `id` : mlog id

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

**方法名 :** `mlog_url`

**调用例子 :**
```rust
let query = Query::new().param("id", "a1qOVPTWKS1ZrK8");
let result = client.mlog_url(&query).await?;
```

### 将 mlog id 转为视频 id

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

**必选参数 :** `id` : mlog id

**方法名 :** `mlog_to_video`

**调用例子 :**
```rust
let query = Query::new().param("id", "a1qOVPTWKS1ZrK8");
let result = client.mlog_to_video(&query).await?;
```

### 歌曲相关视频

说明 : 可以调用此接口获取歌曲相关视频 (区别于 MV)， 有些歌曲没有 MV 但是有用户上传的与此歌曲相关的 Mlog。此功能仅在网易云音乐 APP 上存在。请注意：此接口偶尔会在相关视频后返回不相关视频，请合理使用。

**必选参数 :** `songid` : 歌曲 ID

**可选参数 :** `mvid` : 如果定义，此 mvid 对应的 MV 将会作为第一个返回

`limit` : 取出的 Mlog 数量, 不包含第一个 mvid

**方法名 :** `mlog_music_rcmd`

**调用例子 :**
```rust
let query = Query::new().param("songid", "186016");
let result = client.mlog_music_rcmd(&query).await?;
```

---

## 电台相关

### dj_banner - 电台 banner

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

**方法名 :** `dj_banner`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.dj_banner(&query).await.unwrap();
```

---

### dj_personalize_recommend - 电台个性推荐

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

**可选参数 :** `limit` : 返回数量,默认为 6,总条数最多 6 条

**方法名 :** `dj_personalize_recommend`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "5");
let result = client.dj_personalize_recommend(&query).await.unwrap();
```

---

### dj_subscriber - 电台订阅者列表

说明 : 调用此接口,可获取电台订阅者列表

**必选参数 :** `id` : 电台 id

**可选参数 :** `time` : 分页参数,默认 -1 ; `limit` : 返回数量,默认为 20

**方法名 :** `dj_subscriber`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "335425050");
let result = client.dj_subscriber(&query).await.unwrap();

// 分页
let query = Query::new()
    .param("id", "335425050")
    .param("time", "1602761825390");
let result = client.dj_subscriber(&query).await.unwrap();
```

---

### dj_catelist - 电台分类

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

**方法名 :** `dj_catelist`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.dj_catelist(&query).await.unwrap();
```

---

### dj_category_excludehot - 电台非热门类型

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

**方法名 :** `dj_category_excludehot`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.dj_category_excludehot(&query).await.unwrap();
```

---

### dj_category_recommend - 电台推荐类型

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

**方法名 :** `dj_category_recommend`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.dj_category_recommend(&query).await.unwrap();
```

---

### dj_detail - 电台详情

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

**必选参数 :** `rid` : 电台的 id

**方法名 :** `dj_detail`

**Rust 调用例子 :**

```rust
let query = Query::new().param("rid", "336355127");
let result = client.dj_detail(&query).await.unwrap();
```

---

### dj_hot - 热门电台

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

**可选参数 :** `limit` : 返回数量,默认为 30 ; `offset` : 偏移数量,默认为 0

**方法名 :** `dj_hot`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.dj_hot(&query).await.unwrap();
```

---

### dj_radio_hot - 类别热门电台

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

**可选参数 :** `limit` : 返回数量,默认为 30 ; `offset` : 偏移数量,默认为 0 ; `cateId` : 类别 id,可通过 `/dj/category/recommend` 接口获取

**方法名 :** `dj_radio_hot`

**Rust 调用例子 :**

```rust
let query = Query::new().param("cateId", "2001");
let result = client.dj_radio_hot(&query).await.unwrap();
```

---

### dj_program - 电台节目

说明 : 登录后调用此接口,传入 `rid`,可查看对应电台的电台节目以及对应的 id。注意此接口返回的 mp3Url 已经无效,需通过 `/song/url` 接口传入节目 mainTrackId 获取音频

**必选参数 :** `rid` : 电台的 id

**可选参数 :** `limit` : 返回数量,默认为 30 ; `offset` : 偏移数量,默认为 0 ; `asc` : 排序方式,默认为 `false` (新 => 老),设置 `true` 可改为 老 => 新

**方法名 :** `dj_program`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("rid", "336355127")
    .param("limit", "40");
let result = client.dj_program(&query).await.unwrap();
```

---

### dj_program_detail - 电台节目详情

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

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

**方法名 :** `dj_program_detail`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "1367665101");
let result = client.dj_program_detail(&query).await.unwrap();
```

---

### dj_program_toplist - 电台节目榜

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

**可选参数 :** `limit` : 返回数量,默认为 100 ; `offset` : 偏移数量,默认为 0

**方法名 :** `dj_program_toplist`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.dj_program_toplist(&query).await.unwrap();
```

---

### dj_program_toplist_hours - 24 小时节目榜

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

**可选参数 :** `limit` : 返回数量,默认为 100 (不支持 offset)

**方法名 :** `dj_program_toplist_hours`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.dj_program_toplist_hours(&query).await.unwrap();
```

---

### dj_recommend - 电台推荐

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

**方法名 :** `dj_recommend`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.dj_recommend(&query).await.unwrap();
```

---

### dj_recommend_type - 电台分类推荐

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

**必选参数 :** `type` : 电台类型,数字,可通过 `dj_catelist` 获取,id 对应此接口的 type

**方法名 :** `dj_recommend_type`

**Rust 调用例子 :**

```rust
let query = Query::new().param("type", "1"); // 明星做主播
let result = client.dj_recommend_type(&query).await.unwrap();
```

---

### dj_sub - 电台订阅

说明 : 登录后调用此接口,传入 `rid`,可订阅/取消订阅电台

**必选参数 :** `rid` : 电台的 id ; `t` : 1 为订阅,0 为取消订阅

**方法名 :** `dj_sub`

**Rust 调用例子 :**

```rust
// 订阅
let query = Query::new()
    .param("rid", "336355127")
    .param("t", "1");
let result = client.dj_sub(&query).await.unwrap();

// 取消订阅
let query = Query::new()
    .param("rid", "336355127")
    .param("t", "0");
let result = client.dj_sub(&query).await.unwrap();
```

---

### dj_sublist - 电台订阅列表

说明 : 登录后调用此接口,可获取订阅的电台列表

**方法名 :** `dj_sublist`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.dj_sublist(&query).await.unwrap();
```

---

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

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

**可选参数 :** `limit` : 返回数量,默认为 100 ; `offset` : 偏移数量,默认为 0 ; `type` : 榜单类型,`new` 为新晋电台榜,`hot` 为热门电台榜

**方法名 :** `dj_toplist`

**Rust 调用例子 :**

```rust
let query = Query::new().param("type", "hot");
let result = client.dj_toplist(&query).await.unwrap();

let query = Query::new()
    .param("type", "new")
    .param("limit", "1");
let result = client.dj_toplist(&query).await.unwrap();
```

---

### dj_toplist_hours - 24 小时主播榜

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

**可选参数 :** `limit` : 返回数量,默认为 100 (不支持 offset)

**方法名 :** `dj_toplist_hours`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "30");
let result = client.dj_toplist_hours(&query).await.unwrap();
```

---

### dj_toplist_newcomer - 主播新人榜

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

**可选参数 :** `limit` : 返回数量,默认为 100 (不支持 offset)

**方法名 :** `dj_toplist_newcomer`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "30");
let result = client.dj_toplist_newcomer(&query).await.unwrap();
```

---

### dj_toplist_pay - 付费精品电台

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

**可选参数 :** `limit` : 返回数量,默认为 100 (不支持 offset)

**方法名 :** `dj_toplist_pay`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "30");
let result = client.dj_toplist_pay(&query).await.unwrap();
```

---

### dj_toplist_popular - 最热主播榜

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

**可选参数 :** `limit` : 返回数量,默认为 100 (不支持 offset)

**方法名 :** `dj_toplist_popular`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "30");
let result = client.dj_toplist_popular(&query).await.unwrap();
```

---

### dj_paygift - 付费精选

说明 : 可以获取付费精选的电台列表

**可选参数 :** `limit` : 返回数量,默认为 30 ; `offset` : 偏移数量,默认为 0

**方法名 :** `dj_paygift`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("limit", "10")
    .param("offset", "20");
let result = client.dj_paygift(&query).await.unwrap();
```

---

### dj_today_perfered - 电台今日优选

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

**方法名 :** `dj_today_perfered`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.dj_today_perfered(&query).await.unwrap();
```

---

### dj_radio_top - 电台排行榜

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

**可选参数 :** `djRadioId` : 电台 id ; `sortIndex` : 排序 1:播放数 2:点赞数 3:评论数 4:分享数 5:收藏数,默认 1 ; `dataGapDays` : 天数 7:一周 30:一个月 90:三个月,默认 7 ; `dataType` : 默认 3

**方法名 :** `dj_radio_top`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("djRadioId", "336355127")
    .param("sortIndex", "1")
    .param("dataGapDays", "7");
let result = client.dj_radio_top(&query).await.unwrap();
```

---

## 🎯 推荐相关

### personalized - 推荐歌单

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

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

**方法名 :** `personalized`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.personalized(&query).await.unwrap();
```

---

### personalized_newsong - 推荐新音乐

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

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

**方法名 :** `personalized_newsong`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.personalized_newsong(&query).await.unwrap();
```

---

### personalized_djprogram - 推荐电台

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

**方法名 :** `personalized_djprogram`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.personalized_djprogram(&query).await.unwrap();
```

---

### personalized_privatecontent - 独家放送(入口列表)

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

**方法名 :** `personalized_privatecontent`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.personalized_privatecontent(&query).await.unwrap();
```

---

### personalized_privatecontent_list - 独家放送列表

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

**可选参数 :** `limit` : 返回数量,默认为 60 ; `offset` : 偏移数量,默认为 0

**方法名 :** `personalized_privatecontent_list`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("limit", "1")
    .param("offset", "2");
let result = client.personalized_privatecontent_list(&query).await.unwrap();
```

---

### recommend_songs - 每日推荐歌曲

说明 : 调用此接口,可获得每日推荐歌曲 (需要登录)

**方法名 :** `recommend_songs`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.recommend_songs(&query).await.unwrap();
```

---

### recommend_resource - 每日推荐歌单

说明 : 调用此接口,可获得每日推荐歌单 (需要登录)

**方法名 :** `recommend_resource`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.recommend_resource(&query).await.unwrap();
```

---

### recommend_songs_dislike - 每日推荐歌曲不感兴趣

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

**必选参数 :** `id` : 歌曲 id

**方法名 :** `recommend_songs_dislike`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "168091");
let result = client.recommend_songs_dislike(&query).await.unwrap();
```

---

### history_recommend_songs - 获取历史日推可用日期列表

说明 : 调用此接口,可获得历史日推可用日期列表

**方法名 :** `history_recommend_songs`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.history_recommend_songs(&query).await.unwrap();
```

---

### history_recommend_songs_detail - 获取历史日推详情数据

说明 : 调用此接口,传入当日日期,可获得当日历史日推数据

**必选参数 :** `date` : 日期,通过历史日推可用日期列表接口获取,不能任意日期

**方法名 :** `history_recommend_songs_detail`

**Rust 调用例子 :**

```rust
let query = Query::new().param("date", "2020-06-21");
let result = client.history_recommend_songs_detail(&query).await.unwrap();
```

---

### program_recommend - 推荐节目

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

**可选参数 :** `limit` : 取出数量,默认为 10 ; `offset` : 偏移数量,默认为 0

**方法名 :** `program_recommend`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "5");
let result = client.program_recommend(&query).await.unwrap();
```

---

### homepage_block_page - 首页-发现

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

**可选参数 :** `refresh` : 是否刷新数据,默认为 false ; `cursor` : 上一条数据返回的 cursor

**方法名 :** `homepage_block_page`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.homepage_block_page(&query).await.unwrap();
```

---

### homepage_dragon_ball - 首页圆形图标入口列表

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

**方法名 :** `homepage_dragon_ball`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.homepage_dragon_ball(&query).await.unwrap();
```

---

### banner - 首页 Banner

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

**可选参数 :** `type` : 资源类型, 0: pc, 1: android, 2: iphone, 3: ipad,默认为 0

**方法名 :** `banner`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.banner(&query).await.unwrap();

let query = Query::new().param("type", "2");
let result = client.banner(&query).await.unwrap();
```

---

### daily_signin - 签到

说明 : 调用此接口,可签到 (需要登录)。安卓端签到可获得 3 点经验,web/PC 端签到可获得 2 点经验

**可选参数 :** `type` : 签到类型,默认 0(安卓端签到),1 为 web/PC 签到

**方法名 :** `daily_signin`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.daily_signin(&query).await.unwrap();
```

---

### personal_fm - 私人 FM

说明 : 私人 FM (需要登录)

**方法名 :** `personal_fm`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.personal_fm(&query).await.unwrap();
```

---

### personal_fm_mode - 私人 FM 模式选择

说明 : 调用此接口返回私人 FM 内容,并可以选择模式

**必选参数 :** `mode` : 模式 (aidj, DEFAULT, FAMILIAR, EXPLORE, SCENE_RCMD)

**可选参数 :** `submode` : 当 mode 为 SCENE_RCMD 时可为 (EXERCISE, FOCUS, NIGHT_EMO)

**方法名 :** `personal_fm_mode`

**Rust 调用例子 :**

```rust
let query = Query::new().param("mode", "FAMILIAR");
let result = client.personal_fm_mode(&query).await.unwrap();
```

---

### fm_trash - 垃圾桶

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

**必选参数 :** `id` : 歌曲 id

**方法名 :** `fm_trash`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "347230");
let result = client.fm_trash(&query).await.unwrap();
```

---

### playmode_intelligence_list - 心动模式/智能播放

说明 : 登录后调用此接口,可获取心动模式/智能播放列表

**必选参数 :** `id` : 歌曲 id ; `pid` : 歌单 id

**可选参数 :** `sid` : 要开始播放的歌曲的 id

**方法名 :** `playmode_intelligence_list`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("id", "33894312")
    .param("pid", "24381616");
let result = client.playmode_intelligence_list(&query).await.unwrap();

let query = Query::new()
    .param("id", "33894312")
    .param("pid", "24381616")
    .param("sid", "36871368");
let result = client.playmode_intelligence_list(&query).await.unwrap();
```

---

### playmode_song_vector - 歌曲向量

说明 : 调用此接口,可获取歌曲向量数据

**方法名 :** `playmode_song_vector`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.playmode_song_vector(&query).await.unwrap();
```

---

### simi_song - 相似歌曲

说明 : 调用此接口,传入歌曲 id,可获得相似歌曲

**必选参数 :** `id` : 歌曲 id

**方法名 :** `simi_song`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "347230");
let result = client.simi_song(&query).await.unwrap();
```

---

### simi_artist - 相似歌手

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

**必选参数 :** `id` : 歌手 id

**方法名 :** `simi_artist`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "6452");
let result = client.simi_artist(&query).await.unwrap();
```

---

### simi_playlist - 相似歌单

说明 : 调用此接口,传入歌曲 id,可获得相似歌单

**必选参数 :** `id` : 歌曲 id

**方法名 :** `simi_playlist`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "347230");
let result = client.simi_playlist(&query).await.unwrap();
```

---

### simi_mv - 相似 MV

说明 : 调用此接口,传入 mvid,可获取相似 MV

**必选参数 :** `mvid` : MV id

**方法名 :** `simi_mv`

**Rust 调用例子 :**

```rust
let query = Query::new().param("mvid", "5436712");
let result = client.simi_mv(&query).await.unwrap();
```

---

### simi_user - 最近听了这首歌的用户

说明 : 调用此接口,传入歌曲 id,可获取最近 5 个听了这首歌的用户

**必选参数 :** `id` : 歌曲 id

**方法名 :** `simi_user`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "347230");
let result = client.simi_user(&query).await.unwrap();
```

---

## 🏆 排行榜相关

### toplist - 所有榜单

说明 : 调用此接口,可获取所有榜单

**方法名 :** `toplist`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.toplist(&query).await.unwrap();
```

---

### toplist_detail - 所有榜单内容摘要

说明 : 调用此接口,可获取所有榜单内容摘要

**方法名 :** `toplist_detail`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.toplist_detail(&query).await.unwrap();
```

---

### toplist_detail_v2 - 所有榜单内容摘要 V2

说明 : 调用此接口,可获取所有榜单内容摘要(V2 版本)

**方法名 :** `toplist_detail_v2`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.toplist_detail_v2(&query).await.unwrap();
```

---

### toplist_artist - 歌手榜

说明 : 调用此接口,可获取排行榜中的歌手榜

**可选参数 :** `type` : 地区, 1: 华语, 2: 欧美, 3: 韩国, 4: 日本

**方法名 :** `toplist_artist`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.toplist_artist(&query).await.unwrap();
```

---

### top_song - 新歌速递

说明 : 调用此接口,可获取新歌速递

**必选参数 :** `type` : 地区类型 id, 全部:0, 华语:7, 欧美:96, 日本:8, 韩国:16

**方法名 :** `top_song`

**Rust 调用例子 :**

```rust
let query = Query::new().param("type", "96");
let result = client.top_song(&query).await.unwrap();
```

---

### top_album - 新碟上架

说明 : 调用此接口,可获取新碟上架列表

**可选参数 :** `area` : ALL/ZH/EA/KR/JP ; `type` : new(全部)/hot(热门),默认 new ; `year` : 年 ; `month` : 月 ; `limit` / `offset`

**方法名 :** `top_album`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("offset", "0")
    .param("limit", "30")
    .param("year", "2019")
    .param("month", "6");
let result = client.top_album(&query).await.unwrap();
```

---

### top_artists - 热门歌手

说明 : 调用此接口,可获取热门歌手数据

**可选参数 :** `limit` : 取出数量,默认为 50 ; `offset` : 偏移数量,默认为 0

**方法名 :** `top_artists`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("offset", "0")
    .param("limit", "30");
let result = client.top_artists(&query).await.unwrap();
```

---

### top_mv - MV 排行

说明 : 调用此接口,可获取 MV 排行

**可选参数 :** `limit` : 取出数量,默认为 30 ; `area` : 地区(内地/港台/欧美/日本/韩国) ; `offset` : 偏移数量

**方法名 :** `top_mv`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "10");
let result = client.top_mv(&query).await.unwrap();
```

---

### top_playlist - 歌单 (网友精选碟)

说明 : 调用此接口,可获取网友精选碟歌单

**可选参数 :** `order` : 可选值 'new' 和 'hot',默认 'hot' ; `cat` : tag,如"华语"/"古风"等,默认"全部" ; `limit` / `offset`

**方法名 :** `top_playlist`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("limit", "10")
    .param("order", "new");
let result = client.top_playlist(&query).await.unwrap();
```

---

### top_playlist_highquality - 获取精品歌单

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

**可选参数 :** `cat` : tag,如"华语"/"古风"等,默认"全部" ; `limit` : 取出歌单数量,默认为 50 ; `before` : 分页参数,取上一页最后一个歌单的 `updateTime` 获取下一页数据

**方法名 :** `top_playlist_highquality`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("before", "1503639064232")
    .param("limit", "3");
let result = client.top_playlist_highquality(&query).await.unwrap();
```

---

### top_list - 排行榜详情 (旧版)

说明 : 调用此接口,传入榜单 id,可获取不同排行榜数据。推荐使用歌单详情接口 `playlist_detail` 传入排行榜 id 获取排行榜详情

**必选参数 :** `id` : 榜单 id,通过所有榜单接口获取

**方法名 :** `top_list`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "2809577409");
let result = client.top_list(&query).await.unwrap();
```

---

## 云盘相关

### user_cloud - 云盘数据

说明 : 登录后调用此接口,可获取云盘数据,获取的数据没有对应 url,需要再调用一次 `song_url_v1` 获取 url

**可选参数 :** `limit` : 返回数量,默认为 30 ; `offset` : 偏移数量,默认为 0

**方法名 :** `user_cloud`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.user_cloud(&query).await.unwrap();
```

---

### user_cloud_detail - 云盘数据详情

说明 : 登录后调用此接口,传入云盘歌曲 id,可获取云盘数据详情

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

**方法名 :** `user_cloud_detail`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "5374627");
let result = client.user_cloud_detail(&query).await.unwrap();
```

---

### user_cloud_del - 云盘歌曲删除

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

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

**方法名 :** `user_cloud_del`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "5374627");
let result = client.user_cloud_del(&query).await.unwrap();
```

---

### cloud - 云盘上传

说明 : 登录后调用此接口,使用 `multipart/form-data` 上传 mp3,可上传歌曲到云盘

**方法名 :** `cloud`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.cloud(&query).await.unwrap();
```

---

### cloud_import - 云盘导入歌曲

说明 : 登录后调用此接口,可云盘导入歌曲而无需上传文件。以下情况可导入成功: 1.文件已经有用户上传至云盘 2.文件是网易云音乐自己的音源

**必选参数 :** `song` : 歌名/文件名 ; `fileType` : 文件后缀 ; `fileSize` : 文件大小 ; `bitrate` : 文件比特率 ; `md5` : 文件 MD5

**可选参数 :** `id` : 歌曲 ID(情况 2 时必须正确填写) ; `artist` : 歌手,默认为未知 ; `album` : 专辑,默认为未知

**方法名 :** `cloud_import`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("song", "最伟大的作品")
    .param("artist", "周杰伦")
    .param("album", "最伟大的作品")
    .param("fileType", "flac")
    .param("fileSize", "50412168")
    .param("bitrate", "1652")
    .param("md5", "d02b8ab79d91c01167ba31e349fe5275");
let result = client.cloud_import(&query).await.unwrap();
```

---

### cloud_match - 云盘歌曲信息匹配纠正

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

**必选参数 :** `uid` : 用户 id ; `sid` : 云盘的歌曲 id ; `asid` : 要匹配的歌曲 id

**方法名 :** `cloud_match`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("uid", "32953014")
    .param("sid", "aaa")
    .param("asid", "bbb");
let result = client.cloud_match(&query).await.unwrap();

// 取消匹配
let query = Query::new()
    .param("uid", "32953014")
    .param("sid", "bbb")
    .param("asid", "0");
let result = client.cloud_match(&query).await.unwrap();
```

---

### cloud_lyric_get - 获取云盘歌词

说明 : 调用此接口,获取云盘歌曲的歌词,歌词来自此文件的音乐元数据 LYRICS 标签

**可选参数 :** `uid` : 用户 id ; `sid` : 云盘的歌曲 id

**方法名 :** `cloud_lyric_get`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("uid", "1")
    .param("sid", "aaa");
let result = client.cloud_lyric_get(&query).await.unwrap();
```

---

### cloud_upload_token - 获取上传凭证

说明 : 客户端直传模式下,调用此接口获取上传凭证

**必选参数 :** `md5` : 文件 MD5 值 ; `fileSize` : 文件大小(字节) ; `filename` : 文件名

**方法名 :** `cloud_upload_token`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("md5", "d02b8ab79d91c01167ba31e349fe5275")
    .param("fileSize", "50412168")
    .param("filename", "song.mp3");
let result = client.cloud_upload_token(&query).await.unwrap();
```

---

### cloud_upload_complete - 完成上传导入

说明 : 客户端直传模式下,上传文件后调用此接口完成导入

**必选参数 :** `songId` : 歌曲 ID ; `resourceId` : 资源 ID ; `md5` : 文件 MD5 ; `filename` : 文件名

**可选参数 :** `song` : 歌曲名 ; `artist` : 艺术家 ; `album` : 专辑名

**方法名 :** `cloud_upload_complete`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("songId", "123456")
    .param("resourceId", "res_123")
    .param("md5", "d02b8ab79d91c01167ba31e349fe5275")
    .param("filename", "song.mp3")
    .param("song", "歌曲名")
    .param("artist", "歌手名");
let result = client.cloud_upload_complete(&query).await.unwrap();
```

---

## 💌 私信相关

### msg_private - 通知-私信

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

**可选参数 :** `limit` : 返回数量,默认为 30 ; `offset` : 偏移数量,默认为 0

**方法名 :** `msg_private`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "3");
let result = client.msg_private(&query).await.unwrap();
```

---

### msg_private_history - 私信内容

说明 : 登录后调用此接口,可获取私信内容

**必选参数 :** `uid` : 用户 id

**可选参数 :** `limit` : 返回数量,默认为 30 ; `before` : 分页参数,取上一页最后一项的 `time` 获取下一页数据

**方法名 :** `msg_private_history`

**Rust 调用例子 :**

```rust
let query = Query::new().param("uid", "9003"); // 云音乐小秘书
let result = client.msg_private_history(&query).await.unwrap();
```

---

### msg_comments - 通知-评论

说明 : 登录后调用此接口,可获取评论通知

**必选参数 :** `uid` : 用户的 id,只能和登录账号的 id 一致

**可选参数 :** `limit` : 返回数量,默认为 30 ; `before` : 分页参数,取上一页最后一个的 `updateTime` 获取下一页数据

**方法名 :** `msg_comments`

**Rust 调用例子 :**

```rust
let query = Query::new().param("uid", "32953014");
let result = client.msg_comments(&query).await.unwrap();
```

---

### msg_forwards - 通知-@我

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

**可选参数 :** `limit` : 返回数量,默认为 30 ; `offset` : 偏移数量,默认为 0

**方法名 :** `msg_forwards`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "3");
let result = client.msg_forwards(&query).await.unwrap();
```

---

### msg_notices - 通知-通知

说明 : 登录后调用此接口,可获取通知

**可选参数 :** `limit` : 返回数量,默认为 30 ; `lasttime` : 返回数据的 `time`,默认 -1,传入上一次返回结果的 time 将会返回下一页的数据

**方法名 :** `msg_notices`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "3");
let result = client.msg_notices(&query).await.unwrap();
```

---

### msg_recentcontact - 最近联系人

说明 : 登录后调用此接口,可获取最近联系人

**方法名 :** `msg_recentcontact`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.msg_recentcontact(&query).await.unwrap();
```

---

### send_text - 发送私信

说明 : 登录后调用此接口,传入用户 id 和要发送的信息,可以发送私信 (注:不能发送私信给自己)

**必选参数 :** `user_ids` : 用户 id,多个需用逗号隔开 ; `msg` : 要发送的信息

**方法名 :** `send_text`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("user_ids", "32953014")
    .param("msg", "test");
let result = client.send_text(&query).await.unwrap();
```

---

### send_song - 发送私信(带歌曲)

说明 : 登录后调用此接口,传入用户 id、信息和音乐 id,可以发送音乐私信

**必选参数 :** `user_ids` : 用户 id ; `id` : 音乐 id ; `msg` : 要发送的信息

**方法名 :** `send_song`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("user_ids", "1")
    .param("id", "351318")
    .param("msg", "测试");
let result = client.send_song(&query).await.unwrap();
```

---

### send_playlist - 发送私信(带歌单)

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

**必选参数 :** `user_ids` : 用户 id ; `msg` : 要发送的信息 ; `playlist` : 歌单 id

**方法名 :** `send_playlist`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("msg", "test")
    .param("user_ids", "475625142")
    .param("playlist", "705123491");
let result = client.send_playlist(&query).await.unwrap();
```

---

### send_album - 发送私信(带专辑)

说明 : 登录后调用此接口,传入用户 id、信息和专辑 id,可以发送专辑私信

**必选参数 :** `user_ids` : 用户 id ; `id` : 专辑 id ; `msg` : 要发送的信息

**方法名 :** `send_album`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("user_ids", "1")
    .param("id", "351318")
    .param("msg", "测试");
let result = client.send_album(&query).await.unwrap();
```

---

### share_resource - 分享到动态

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

**必选参数 :** `id` : 资源 id

**可选参数 :** `type` : 资源类型,默认 song,可传 `song`/`playlist`/`mv`/`djradio`/`djprogram`/`album` ; `msg` : 内容,140 字限制

**方法名 :** `share_resource`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("id", "1297494209")
    .param("msg", "测试");
let result = client.share_resource(&query).await.unwrap();
```

---

### resource_like - 资源点赞

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

**必选参数 :** `type` : 资源类型 (0:歌曲, 1:mv, 2:歌单, 3:专辑, 4:电台节目, 5:视频, 6:动态, 7:电台) ; `t` : 1 为点赞,其他为取消 ; `id` : 资源 id

**方法名 :** `resource_like`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("t", "1")
    .param("type", "1")
    .param("id", "5436712");
let result = client.resource_like(&query).await.unwrap();
```

---

### event - 获取动态列表

说明 : 调用此接口,可获取各种动态

**可选参数 :** `pagesize` : 每页数据,默认 20 ; `lasttime` : 默认 -1,传入上一次返回结果的 lasttime 将会返回下一页的数据

**方法名 :** `event`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("pagesize", "30")
    .param("lasttime", "1556740526369");
let result = client.event(&query).await.unwrap();
```

---

### event_del - 删除用户动态

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

**必选参数 :** `evId` : 动态 id

**方法名 :** `event_del`

**Rust 调用例子 :**

```rust
let query = Query::new().param("evId", "6712917601");
let result = client.event_del(&query).await.unwrap();
```

---

### event_forward - 转发用户动态

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

**必选参数 :** `uid` : 用户 id ; `evId` : 动态 id ; `forwards` : 转发的评论

**方法名 :** `event_forward`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("evId", "6712917601")
    .param("uid", "32953014")
    .param("forwards", "测试内容");
let result = client.event_forward(&query).await.unwrap();
```

---

## 👑 VIP/会员

### vip_info - 获取 VIP 信息

说明 : 登录后调用此接口,可获取当前 VIP 信息

**可选参数 :** `uid` : 用户 id

**方法名 :** `vip_info`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.vip_info(&query).await.unwrap();

let query = Query::new().param("uid", "32953014");
let result = client.vip_info(&query).await.unwrap();
```

---

### vip_info_v2 - 获取 VIP 信息(app 端)

说明 : 登录后调用此接口,可获取当前 VIP 信息 (app 端)

**可选参数 :** `uid` : 用户 id

**方法名 :** `vip_info_v2`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.vip_info_v2(&query).await.unwrap();
```

---

### vip_sign - 黑胶乐签打卡

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

**方法名 :** `vip_sign`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.vip_sign(&query).await.unwrap();
```

---

### vip_sign_info - 黑胶乐签打卡信息

说明 : 登录后调用此接口,获取黑胶乐签打卡信息

**方法名 :** `vip_sign_info`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.vip_sign_info(&query).await.unwrap();
```

---

### vip_tasks - VIP 任务

说明 : 登录后调用此接口,可获取会员任务

**方法名 :** `vip_tasks`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.vip_tasks(&query).await.unwrap();
```

---

### vip_timemachine - 黑胶时光机

说明 : 调用此接口,可获得黑胶时光机数据

**可选参数 :** `startTime` : 开始时间 ; `endTime` : 结束时间 ; `limit` : 返回数量,默认为 60

**方法名 :** `vip_timemachine`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.vip_timemachine(&query).await.unwrap();

// 获取 2021 年 12 月数据
let query = Query::new()
    .param("startTime", "1638288000000")
    .param("endTime", "1640966399999")
    .param("limit", "10");
let result = client.vip_timemachine(&query).await.unwrap();
```

---

### vip_growthpoint - VIP 成长值

说明 : 登录后调用此接口,可获取当前会员成长值

**方法名 :** `vip_growthpoint`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.vip_growthpoint(&query).await.unwrap();
```

---

### vip_growthpoint_details - VIP 成长值获取记录

说明 : 登录后调用此接口,可获取会员成长值领取记录

**可选参数 :** `limit` : 取出数量,默认为 20 ; `offset` : 偏移数量

**方法名 :** `vip_growthpoint_details`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "10");
let result = client.vip_growthpoint_details(&query).await.unwrap();
```

---

### vip_growthpoint_get - 领取 VIP 成长值

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

**必选参数 :** `ids` : 通过 `vip_tasks` 获取到的 `unGetIds`

**方法名 :** `vip_growthpoint_get`

**Rust 调用例子 :**

```rust
let query = Query::new().param("ids", "7043206830_7");
let result = client.vip_growthpoint_get(&query).await.unwrap();
```

---

## 🌟 云贝

### yunbei - 云贝签到信息

说明 : 登录后调用此接口可获取云贝签到信息(连续签到天数,第二天全部可获得的云贝)

**方法名 :** `yunbei`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.yunbei(&query).await.unwrap();
```

---

### yunbei_info - 云贝账户信息

说明 : 登录后调用此接口可获取云贝账户信息(账户云贝数)

**方法名 :** `yunbei_info`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.yunbei_info(&query).await.unwrap();
```

---

### yunbei_sign - 云贝签到

说明 : 登录后调用此接口可进行云贝签到

**方法名 :** `yunbei_sign`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.yunbei_sign(&query).await.unwrap();
```

---

### yunbei_today - 云贝今日签到信息

说明 : 登录后调用此接口可获取云贝今日签到信息(今日签到获取的云贝数)

**方法名 :** `yunbei_today`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.yunbei_today(&query).await.unwrap();
```

---

### yunbei_expense - 云贝支出

说明 : 登录后调用此接口可获取云贝支出

**可选参数 :** `limit` : 取出数量,默认为 10 ; `offset` : 偏移数量

**方法名 :** `yunbei_expense`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.yunbei_expense(&query).await.unwrap();
```

---

### yunbei_receipt - 云贝收入

说明 : 登录后调用此接口可获取云贝收入

**可选参数 :** `limit` : 取出数量,默认为 10 ; `offset` : 偏移数量

**方法名 :** `yunbei_receipt`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.yunbei_receipt(&query).await.unwrap();
```

---

### yunbei_tasks - 云贝所有任务

说明 : 登录后调用此接口可获取云贝所有任务

**方法名 :** `yunbei_tasks`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.yunbei_tasks(&query).await.unwrap();
```

---

### yunbei_tasks_todo - 云贝 todo 任务

说明 : 登录后调用此接口可获取云贝 todo 任务

**方法名 :** `yunbei_tasks_todo`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.yunbei_tasks_todo(&query).await.unwrap();
```

---

### yunbei_task_finish - 云贝完成任务

说明 : 调用此接口完成云贝任务

**必选参数 :** `userTaskId` : 任务 id

**可选参数 :** `depositCode` : 任务 depositCode

**方法名 :** `yunbei_task_finish`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("userTaskId", "5146243240")
    .param("depositCode", "0");
let result = client.yunbei_task_finish(&query).await.unwrap();
```

---

### yunbei_rcmd_song - 云贝推歌

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

**必选参数 :** `id` : 歌曲 id

**可选参数 :** `reason` : 推歌理由 ; `yunbeiNum` : 云贝数量,默认 10

**方法名 :** `yunbei_rcmd_song`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "65528");
let result = client.yunbei_rcmd_song(&query).await.unwrap();

let query = Query::new()
    .param("id", "65528")
    .param("reason", "人间好声音推荐给你听");
let result = client.yunbei_rcmd_song(&query).await.unwrap();
```

---

### yunbei_rcmd_song_history - 云贝推歌历史记录

说明 : 登录后调用此接口,可以获得云贝推歌历史记录

**可选参数 :** `size` : 返回数量,默认为 20 ; `cursor` : 传入上一次返回结果的 cursor,将会返回下一页的数据

**方法名 :** `yunbei_rcmd_song_history`

**Rust 调用例子 :**

```rust
let query = Query::new().param("size", "10");
let result = client.yunbei_rcmd_song_history(&query).await.unwrap();
```

---

## 👣 听歌足迹

### listen_data_year_report - 年度听歌足迹

说明 : 登录后调用此接口,获取年度听歌足迹

**方法名 :** `listen_data_year_report`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listen_data_year_report(&query).await.unwrap();
```

---

### listen_data_today_song - 今日收听

说明 : 登录后调用此接口,获取今日收听

**方法名 :** `listen_data_today_song`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listen_data_today_song(&query).await.unwrap();
```

---

### listen_data_total - 总收听时长

说明 : 登录后调用此接口,获取总收听时长;相关接口可能需要 VIP 权限

**方法名 :** `listen_data_total`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listen_data_total(&query).await.unwrap();
```

---

### listen_data_realtime_report - 本周/本月收听时长

说明 : 登录后调用此接口,获取本周/本月收听时长

**必选参数 :** `type` : 维度类型,周 `week`,月 `month`;今年没结束不支持今年的数据

**方法名 :** `listen_data_realtime_report`

**Rust 调用例子 :**

```rust
let query = Query::new().param("type", "month");
let result = client.listen_data_realtime_report(&query).await.unwrap();
```

---

### listen_data_report - 周/月/年收听报告

说明 : 登录后调用此接口,获取周/月/年收听报告

**必选参数 :** `type` : 维度类型,周 `week`,月 `month`,年 `year`

**可选参数 :** `endTime` : 周:每周周六 0 点的时间戳 ; 月:每月最后一天 0 点的时间戳 ; 年:每年最后一天 0 点的时间戳。不填就是本周/月的

**方法名 :** `listen_data_report`

**Rust 调用例子 :**

```rust
let query = Query::new().param("type", "month");
let result = client.listen_data_report(&query).await.unwrap();
```

---

### recent_listen_list - 最近听歌列表

说明 : 调用后可获取最近听歌列表

**方法名 :** `recent_listen_list`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.recent_listen_list(&query).await.unwrap();
```

---

### record_recent_song - 最近播放-歌曲

说明 : 调用此接口,可获得最近播放-歌曲

**可选参数 :** `limit` : 返回数量,默认为 100

**方法名 :** `record_recent_song`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.record_recent_song(&query).await.unwrap();
```

---

### record_recent_album - 最近播放-专辑

说明 : 调用此接口,可获得最近播放-专辑

**可选参数 :** `limit` : 返回数量,默认为 100

**方法名 :** `record_recent_album`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.record_recent_album(&query).await.unwrap();
```

---

### record_recent_playlist - 最近播放-歌单

说明 : 调用此接口,可获得最近播放-歌单

**可选参数 :** `limit` : 返回数量,默认为 100

**方法名 :** `record_recent_playlist`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.record_recent_playlist(&query).await.unwrap();
```

---

### record_recent_dj - 最近播放-播客

说明 : 调用此接口,可获得最近播放-播客

**可选参数 :** `limit` : 返回数量,默认为 100

**方法名 :** `record_recent_dj`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.record_recent_dj(&query).await.unwrap();
```

---

### record_recent_video - 最近播放-视频

说明 : 调用此接口,可获得最近播放-视频

**可选参数 :** `limit` : 返回数量,默认为 100

**方法名 :** `record_recent_video`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.record_recent_video(&query).await.unwrap();
```

---

### record_recent_voice - 最近播放-声音

说明 : 调用此接口,可获得最近播放-声音

**可选参数 :** `limit` : 返回数量,默认为 100

**方法名 :** `record_recent_voice`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "1");
let result = client.record_recent_voice(&query).await.unwrap();
```

---

## 🎨 风格/曲风

### style_list - 曲风列表

说明 : 调用此接口获取曲风列表及其对应的 `tagId`

**方法名 :** `style_list`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.style_list(&query).await.unwrap();
```

---

### style_detail - 曲风详情

说明 : 调用此接口可以获取该曲风的描述信息

**必选参数 :** `tagId` : 曲风 ID

**方法名 :** `style_detail`

**Rust 调用例子 :**

```rust
let query = Query::new().param("tagId", "1000");
let result = client.style_detail(&query).await.unwrap();
```

---

### style_song - 曲风-歌曲

说明 : 调用此接口可以获取该曲风对应的歌曲

**必选参数 :** `tagId` : 曲风 ID

**可选参数 :** `size` : 返回数量,默认为 20 ; `cursor` : 分页 cursor,默认为 0 ; `sort` : 排序方式,0:按热度排序,1:按时间排序

**方法名 :** `style_song`

**Rust 调用例子 :**

```rust
let query = Query::new().param("tagId", "1000");
let result = client.style_song(&query).await.unwrap();

let query = Query::new()
    .param("tagId", "1010")
    .param("sort", "1");
let result = client.style_song(&query).await.unwrap();
```

---

### style_album - 曲风-专辑

说明 : 调用此接口可以获取该曲风对应的专辑

**必选参数 :** `tagId` : 曲风 ID

**可选参数 :** `size` : 返回数量,默认为 20 ; `cursor` : 分页 cursor,默认为 0 ; `sort` : 排序方式,0:按热度排序,1:按时间排序

**方法名 :** `style_album`

**Rust 调用例子 :**

```rust
let query = Query::new().param("tagId", "1000");
let result = client.style_album(&query).await.unwrap();
```

---

### style_artist - 曲风-歌手

说明 : 调用此接口可以获取该曲风对应的歌手

**必选参数 :** `tagId` : 曲风 ID

**可选参数 :** `size` : 返回数量,默认为 20 ; `cursor` : 分页 cursor,默认为 0

**方法名 :** `style_artist`

**Rust 调用例子 :**

```rust
let query = Query::new().param("tagId", "1000");
let result = client.style_artist(&query).await.unwrap();
```

---

### style_playlist - 曲风-歌单

说明 : 调用此接口可以获取该曲风对应的歌单

**必选参数 :** `tagId` : 曲风 ID

**可选参数 :** `size` : 返回数量,默认为 20 ; `cursor` : 分页 cursor,默认为 0

**方法名 :** `style_playlist`

**Rust 调用例子 :**

```rust
let query = Query::new().param("tagId", "1000");
let result = client.style_playlist(&query).await.unwrap();
```

---

### style_preference - 曲风偏好

说明 : 登录后调用此接口获取我的曲风偏好

**方法名 :** `style_preference`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.style_preference(&query).await.unwrap();
```

---

## 💿 数字专辑

### digital_album_detail - 数字专辑详情

说明 : 调用此接口,传入专辑 id,可获取数字专辑信息

**必选参数 :** `id` : 专辑 id

**方法名 :** `digital_album_detail`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "120605500");
let result = client.digital_album_detail(&query).await.unwrap();
```

---

### digital_album_ordering - 购买数字专辑

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

**必选参数 :** `id` : 专辑的 id ; `payment` : 支付方式,0 为支付宝,3 为微信 ; `quantity` : 购买的数量

**方法名 :** `digital_album_ordering`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("id", "86286082")
    .param("payment", "3")
    .param("quantity", "1");
let result = client.digital_album_ordering(&query).await.unwrap();
```

---

### digital_album_purchased - 我的数字专辑

说明 : 登录后调用此接口,可获取我的数字专辑

**可选参数 :** `limit` / `offset`

**方法名 :** `digital_album_purchased`

**Rust 调用例子 :**

```rust
let query = Query::new().param("limit", "10");
let result = client.digital_album_purchased(&query).await.unwrap();
```

---

### digital_album_sales - 数字专辑销量

说明 : 调用此接口,传入专辑 id,可获取数字专辑销量

**必选参数 :** `ids` : 专辑 id,支持多个,用 `,` 隔开

**方法名 :** `digital_album_sales`

**Rust 调用例子 :**

```rust
let query = Query::new().param("ids", "120605500");
let result = client.digital_album_sales(&query).await.unwrap();

// 多个专辑
let query = Query::new().param("ids", "120605500,125080528");
let result = client.digital_album_sales(&query).await.unwrap();
```

---

## 🎙️ 声音/播客

### voice_upload - 播客上传声音

说明 : 可以上传声音到播客

**必选参数 :** `voiceListId` : 播客 id ; `coverImgId` : 播客封面 ; `categoryId` : 分类 id ; `secondCategoryId` : 次级分类 id ; `description` : 声音介绍

**可选参数 :** `songName` : 声音名称 ; `privacy` : 设为隐私声音 ; `publishTime` : 定时发布时间戳 ; `autoPublish` : 是否发布动态(传入 1) ; `autoPublishText` : 动态文案 ; `orderNo` : 排序,默认为 1 ; `composedSongs` : 包含歌曲(歌曲 id),多个用逗号隔开

**方法名 :** `voice_upload`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("voiceListId", "123456")
    .param("coverImgId", "789")
    .param("categoryId", "1")
    .param("secondCategoryId", "2")
    .param("description", "声音介绍");
let result = client.voice_upload(&query).await.unwrap();
```

---

### voice_delete - 播客删除

说明 : 可以删除播客声音

**必选参数 :** `ids` : 播客 id(voiceListId),多个以逗号隔开

**方法名 :** `voice_delete`

**Rust 调用例子 :**

```rust
let query = Query::new().param("ids", "123456");
let result = client.voice_delete(&query).await.unwrap();
```

---

### voice_detail - 播客声音详情

说明 : 获取播客里的声音详情

**必选参数 :** `id` : 播客声音 id(voiceId)

**方法名 :** `voice_detail`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "123456");
let result = client.voice_detail(&query).await.unwrap();
```

---

### voice_lyric - 获取声音歌词

说明 : 调用此接口可以获取声音歌词

**必选参数 :** `id` : 声音 id

**方法名 :** `voice_lyric`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "123456");
let result = client.voice_lyric(&query).await.unwrap();
```

---

### voicelist_list - 播客声音列表

说明 : 可以获取播客里的声音

**必选参数 :** `voiceListId` : 播客 id

**可选参数 :** `limit` : 取出数量,默认为 200 ; `offset` : 偏移数量

**方法名 :** `voicelist_list`

**Rust 调用例子 :**

```rust
let query = Query::new().param("voiceListId", "123456");
let result = client.voicelist_list(&query).await.unwrap();
```

---

### voicelist_detail - 播客列表详情

说明 : 可以获取播客封面、分类、名称、简介等

**必选参数 :** `id` : 播客 id(voiceListId)

**方法名 :** `voicelist_detail`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "123456");
let result = client.voicelist_detail(&query).await.unwrap();
```

---

### voicelist_search - 播客列表搜索

说明 : 可以获取播客列表

**可选参数 :** `limit` : 取出数量,默认为 200 ; `offset` : 偏移数量 ; `podcastName` : 播客名称

**方法名 :** `voicelist_search`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.voicelist_search(&query).await.unwrap();
```

---

### voicelist_list_search - 播客声音搜索

说明 : 可以搜索播客里的声音

**可选参数 :** `displayStatus` : 状态(ONLINE/AUDITING/ONLY_SELF_SEE/SCHEDULE_PUBLISH 等) ; `limit` : 每次返回数量,默认 20(最多 200) ; `name` : 搜索关键词 ; `offset` : 偏移量 ; `radioId` : 播客 id ; `type` : PUBLIC/PRIVATE ; `voiceFeeType` : -1:全部, 0:免费, 1:收费

**方法名 :** `voicelist_list_search`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("displayStatus", "ONLINE")
    .param("limit", "20");
let result = client.voicelist_list_search(&query).await.unwrap();
```

---

### voicelist_trans - 播客声音排序

说明 : 调整声音在列表中的顺序

**必选参数 :** `position` : 位置,最小为 1 ; `programId` : 播客声音 id(voiceId) ; `radioId` : 电台 id(voiceListId)

**可选参数 :** `limit` / `offset`

**方法名 :** `voicelist_trans`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("position", "1")
    .param("programId", "123")
    .param("radioId", "456");
let result = client.voicelist_trans(&query).await.unwrap();
```

---

## 🎵 音乐人

### musician_sign - 音乐人签到

说明 : 音乐人登录后调用此接口,可以完成"登录音乐人中心"任务,然后通过 `musician_cloudbean_obtain` 接口可以领取相应的云豆

**方法名 :** `musician_sign`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.musician_sign(&query).await.unwrap();
```

---

### musician_tasks - 音乐人任务

说明 : 音乐人登录后调用此接口,可获取音乐人任务。返回数据中 `status` 字段: 0 未开始, 10 进行中, 20 完成但未领取云豆, 100 完成并已领取

**方法名 :** `musician_tasks`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.musician_tasks(&query).await.unwrap();
```

---

### musician_tasks_new - 音乐人任务(新)

说明 : 音乐人登录后调用此接口,可获取音乐人任务(新版)

**方法名 :** `musician_tasks_new`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.musician_tasks_new(&query).await.unwrap();
```

---

### musician_vip_tasks - 音乐人黑胶会员任务

说明 : 音乐人登录后调用此接口,可获取音乐人黑胶会员任务。返回数据中 `missionStatus` 为 100 表示任务完成

**方法名 :** `musician_vip_tasks`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.musician_vip_tasks(&query).await.unwrap();
```

---

### musician_data_overview - 音乐人数据概况

说明 : 音乐人登录后调用此接口,可获取统计数据概况

**方法名 :** `musician_data_overview`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.musician_data_overview(&query).await.unwrap();
```

---

### musician_play_trend - 音乐人播放趋势

说明 : 音乐人登录后调用此接口,可获取歌曲播放趋势

**必选参数 :** `startTime` : 开始时间 ; `endTime` : 结束时间

**方法名 :** `musician_play_trend`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("startTime", "2021-05-24")
    .param("endTime", "2021-05-30");
let result = client.musician_play_trend(&query).await.unwrap();
```

---

### musician_cloudbean - 账号云豆数

说明 : 音乐人登录后调用此接口,可获取账号云豆数

**方法名 :** `musician_cloudbean`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.musician_cloudbean(&query).await.unwrap();
```

---

### musician_cloudbean_obtain - 领取云豆

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

**必选参数 :** `id` : 任务 id,通过 `musician_tasks` 获取到的 `userMissionId` ; `period` : 通过 `musician_tasks` 获取

**方法名 :** `musician_cloudbean_obtain`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("id", "7036416928")
    .param("period", "1");
let result = client.musician_cloudbean_obtain(&query).await.unwrap();
```

---

## 👥 粉丝中心

### fanscenter_overview_get - 粉丝中心概览

说明 : 调用此接口获取粉丝中心概览数据

**方法名 :** `fanscenter_overview_get`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.fanscenter_overview_get(&query).await.unwrap();
```

---

### fanscenter_trend_list - 粉丝趋势列表

说明 : 调用此接口获取粉丝趋势列表数据

**方法名 :** `fanscenter_trend_list`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.fanscenter_trend_list(&query).await.unwrap();
```

---

### fanscenter_basicinfo_age_get - 粉丝年龄分布

说明 : 调用此接口获取粉丝年龄分布数据

**方法名 :** `fanscenter_basicinfo_age_get`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.fanscenter_basicinfo_age_get(&query).await.unwrap();
```

---

### fanscenter_basicinfo_gender_get - 粉丝性别分布

说明 : 调用此接口获取粉丝性别分布数据

**方法名 :** `fanscenter_basicinfo_gender_get`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.fanscenter_basicinfo_gender_get(&query).await.unwrap();
```

---

### fanscenter_basicinfo_province_get - 粉丝省份分布

说明 : 调用此接口获取粉丝省份分布数据

**方法名 :** `fanscenter_basicinfo_province_get`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.fanscenter_basicinfo_province_get(&query).await.unwrap();
```

---

## 📚 UGC 百科

### ugc_song_get - 歌曲简要百科信息

说明 : 登录后调用此接口,传入歌曲 id,可获取对应的歌曲简要百科信息

**必选参数 :** `id` : 歌曲 id

**方法名 :** `ugc_song_get`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "2058263032");
let result = client.ugc_song_get(&query).await.unwrap();
```

---

### ugc_artist_get - 歌手简要百科信息

说明 : 登录后调用此接口,传入歌手 id,可获取对应的歌手简要百科信息

**必选参数 :** `id` : 歌手 id

**方法名 :** `ugc_artist_get`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "15396");
let result = client.ugc_artist_get(&query).await.unwrap();
```

---

### ugc_album_get - 专辑简要百科信息

说明 : 登录后调用此接口,传入专辑 id,可获取对应的专辑简要百科信息

**必选参数 :** `id` : 专辑 id

**方法名 :** `ugc_album_get`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "168223858");
let result = client.ugc_album_get(&query).await.unwrap();
```

---

### ugc_mv_get - MV 简要百科信息

说明 : 登录后调用此接口,传入 MV id,可获取对应的 MV 简要百科信息

**必选参数 :** `id` : MV id

**方法名 :** `ugc_mv_get`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "14572641");
let result = client.ugc_mv_get(&query).await.unwrap();
```

---

### ugc_detail - 用户贡献内容

说明 : 登录后调用此接口,可获取当前登录用户贡献内容

**必选参数 :** `type` : 内容种类。曲库纠错 - 歌手:1, 专辑:2, 歌曲:3, MV:4, 歌词:5, 翻译:6 ; 曲库补充 - 专辑:101, MV:103

**可选参数 :** `limit` : 取出数量,默认为 10 ; `offset` : 偏移数量 ; `auditStatus` : 审核状态(待审核:0, 未采纳:-5, 审核中:1, 部分审核通过:4, 审核通过:5) ; `order` : 排序,默认降序 desc,顺序 asc

**方法名 :** `ugc_detail`

**Rust 调用例子 :**

```rust
let query = Query::new().param("type", "1");
let result = client.ugc_detail(&query).await.unwrap();
```

---

### ugc_artist_search - 搜索歌手(百科)

说明 : 登录后调用此接口,传入歌手名关键字或者歌手 id,可获取搜索到的歌手信息

**必选参数 :** `keyword` : 关键字或歌手 id

**可选参数 :** `limit` : 取出条目数量,默认为 40

**方法名 :** `ugc_artist_search`

**Rust 调用例子 :**

```rust
let query = Query::new().param("keyword", "sasakure");
let result = client.ugc_artist_search(&query).await.unwrap();
```

---

### ugc_user_devote - 用户贡献条目、积分、云贝数量

说明 : 登录后调用此接口,可获取当前登录用户贡献条目、积分、云贝数量

**方法名 :** `ugc_user_devote`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.ugc_user_devote(&query).await.unwrap();
```

---

## 🎧 一起听

### listentogether_room_create - 创建一起听房间

说明 : 登录后调用此接口,可创建一起听房间

**方法名 :** `listentogether_room_create`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listentogether_room_create(&query).await.unwrap();
```

---

### listentogether_room_check - 检查一起听房间

说明 : 调用此接口,可检查一起听房间状态

**方法名 :** `listentogether_room_check`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listentogether_room_check(&query).await.unwrap();
```

---

### listentogether_accept - 接受一起听邀请

说明 : 调用此接口,可接受一起听邀请

**方法名 :** `listentogether_accept`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listentogether_accept(&query).await.unwrap();
```

---

### listentogether_status - 一起听状态

说明 : 调用此接口,可获取一起听状态

**方法名 :** `listentogether_status`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listentogether_status(&query).await.unwrap();
```

---

### listentogether_heatbeat - 一起听心跳

说明 : 调用此接口,发送一起听心跳以保持连接

**方法名 :** `listentogether_heatbeat`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listentogether_heatbeat(&query).await.unwrap();
```

---

### listentogether_play_command - 一起听播放命令

说明 : 调用此接口,发送一起听播放命令

**方法名 :** `listentogether_play_command`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listentogether_play_command(&query).await.unwrap();
```

---

### listentogether_sync_list_command - 一起听同步列表命令

说明 : 调用此接口,发送一起听同步列表命令

**方法名 :** `listentogether_sync_list_command`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listentogether_sync_list_command(&query).await.unwrap();
```

---

### listentogether_sync_playlist_get - 获取一起听同步播放列表

说明 : 调用此接口,获取一起听同步播放列表

**方法名 :** `listentogether_sync_playlist_get`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listentogether_sync_playlist_get(&query).await.unwrap();
```

---

### listentogether_end - 结束一起听

说明 : 调用此接口,可结束一起听

**方法名 :** `listentogether_end`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.listentogether_end(&query).await.unwrap();
```

---

## 📡 广播电台

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

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

**方法名 :** `broadcast_category_region_get`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.broadcast_category_region_get(&query).await.unwrap();
```

---

### broadcast_channel_list - 广播电台全部电台

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

**可选参数 :** `categoryId` : 类别 id,默认为 0 ; `regionId` : 地区 id,默认为 0

**方法名 :** `broadcast_channel_list`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.broadcast_channel_list(&query).await.unwrap();
```

---

### broadcast_channel_currentinfo - 广播电台信息

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

**必选参数 :** `id` : 电台 id

**方法名 :** `broadcast_channel_currentinfo`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "5");
let result = client.broadcast_channel_currentinfo(&query).await.unwrap();
```

---

### broadcast_channel_collect_list - 广播电台我的收藏

说明 : 调用此接口,获取广播电台我的收藏

**可选参数 :** `limit` : 返回数量,默认为 99999

**方法名 :** `broadcast_channel_collect_list`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.broadcast_channel_collect_list(&query).await.unwrap();
```

---

### broadcast_sub - 广播电台订阅

说明 : 调用此接口,可订阅/取消订阅广播电台

**方法名 :** `broadcast_sub`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.broadcast_sub(&query).await.unwrap();
```

---

## 🔧 其他

### hot_topic - 获取热门话题

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

**可选参数 :** `limit` : 取出数量,默认为 20 ; `offset` : 偏移数量

**方法名 :** `hot_topic`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("limit", "30")
    .param("offset", "30");
let result = client.hot_topic(&query).await.unwrap();
```

---

### topic_detail - 获取话题详情

说明 : 调用此接口,可获取话题详情

**必选参数 :** `actid` : 话题 id

**方法名 :** `topic_detail`

**Rust 调用例子 :**

```rust
let query = Query::new().param("actid", "111551188");
let result = client.topic_detail(&query).await.unwrap();
```

---

### topic_detail_event_hot - 获取话题详情热门动态

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

**必选参数 :** `actid` : 话题 id

**方法名 :** `topic_detail_event_hot`

**Rust 调用例子 :**

```rust
let query = Query::new().param("actid", "111551188");
let result = client.topic_detail_event_hot(&query).await.unwrap();
```

---

### topic_sublist - 收藏的专栏

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

**可选参数 :** `limit` : 取出数量,默认为 50 ; `offset` : 偏移数量

**方法名 :** `topic_sublist`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("limit", "2")
    .param("offset", "1");
let result = client.topic_sublist(&query).await.unwrap();
```

---

### calendar - 音乐日历

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

**可选参数 :** `startTime` : 开始时间戳 ; `endTime` : 结束时间戳

**方法名 :** `calendar`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("startTime", "1606752000000")
    .param("endTime", "1609430399999");
let result = client.calendar(&query).await.unwrap();
```

---

### batch - 批量请求接口

说明 : 登录后调用此接口,传入接口和对应原始参数,可批量请求接口

**方法名 :** `batch`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.batch(&query).await.unwrap();
```

---

### api - 通用 API 请求

说明 : 通用 API 请求接口

**方法名 :** `api`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.api(&query).await.unwrap();
```

---

### inner_version - 内部版本接口

说明 : 调用此接口,可获得内部版本号

**方法名 :** `inner_version`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.inner_version(&query).await.unwrap();
```

---

### weblog - 日志上报

说明 : 调用此接口进行日志上报

**方法名 :** `weblog`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.weblog(&query).await.unwrap();
```

---

### eapi_decrypt - EAPI 解密

说明 : 调用此接口,可进行 EAPI 解密

**方法名 :** `eapi_decrypt`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.eapi_decrypt(&query).await.unwrap();
```

---

### sign_happy_info - 乐签信息

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

**方法名 :** `sign_happy_info`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.sign_happy_info(&query).await.unwrap();
```

---

### signin_progress - 签到进度

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

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

**方法名 :** `signin_progress`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("moduleId", "1207signin-1207signin");
let result = client.signin_progress(&query).await.unwrap();
```

---

### summary_annual - 年度听歌报告

说明 : 登录后调用此接口,可获取当前登录用户年度听歌报告,目前支持 2017-2024 年的报告

**必选参数 :** `year` : 报告年份

**方法名 :** `summary_annual`

**Rust 调用例子 :**

```rust
let query = Query::new().param("year", "2024");
let result = client.summary_annual(&query).await.unwrap();
```

---

### threshold_detail_get - 阈值详情获取

说明 : 调用此接口获取阈值详情

**方法名 :** `threshold_detail_get`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.threshold_detail_get(&query).await.unwrap();
```

---

### creator_authinfo_get - 创作者认证信息获取

说明 : 调用此接口获取创作者认证信息

**方法名 :** `creator_authinfo_get`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.creator_authinfo_get(&query).await.unwrap();
```

---

### sheet_list - 乐谱列表

说明 : 调用此接口可以获取歌曲的乐谱列表

**必选参数 :** `id` : 歌曲 ID

**方法名 :** `sheet_list`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "1815684465");
let result = client.sheet_list(&query).await.unwrap();
```

---

### sheet_preview - 乐谱内容

说明 : 登录后调用此接口获取乐谱的内容

**必选参数 :** `id` : 乐谱 ID

**方法名 :** `sheet_preview`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "143190");
let result = client.sheet_preview(&query).await.unwrap();
```

---

### aidj_content_rcmd - 私人 DJ 推荐内容

说明 : 调用此接口可以获取私人 DJ 的推荐内容(包括 DJ 声音和推荐歌曲)

**可选参数 :** `longitude` / `latitude` : 当前的经纬度

**方法名 :** `aidj_content_rcmd`

**Rust 调用例子 :**

```rust
let query = Query::new();
let result = client.aidj_content_rcmd(&query).await.unwrap();
```

---

### music_first_listen_info - 回忆坐标

说明 : 可以获取当前歌曲的回忆坐标信息(见手机 APP 百科页的回忆坐标功能)

**必选参数 :** `id` : 歌曲 ID

**方法名 :** `music_first_listen_info`

**Rust 调用例子 :**

```rust
let query = Query::new().param("id", "186016");
let result = client.music_first_listen_info(&query).await.unwrap();
```

---

### verify_get_qr - 验证接口-二维码生成

说明 : 进行某些操作可能会触发验证,调用此接口生成二维码,使用 app 扫码后可解除验证

**必选参数 :** `vid` : verifyId ; `type` : verifyType ; `token` : verifyToken ; `evid` : params 的 event_id ; `sign` : params 的 sign

**方法名 :** `verify_get_qr`

**Rust 调用例子 :**

```rust
let query = Query::new()
    .param("vid", "xxx")
    .param("type", "1")
    .param("token", "xxx")
    .param("evid", "xxx")
    .param("sign", "xxx");
let result = client.verify_get_qr(&query).await.unwrap();
```

---

### verify_qrcodestatus - 验证接口-二维码检测

说明 : 传入 `verify_get_qr` 接口返回的 `qr` 字符串,可检测二维码扫描状态

**必选参数 :** `qr` : `verify_get_qr` 接口返回的 `qr` 字符串

返回状态说明: qrCodeStatus:0 - 二维码生成成功 ; qrCodeStatus:10 - 已扫描 ; qrCodeStatus:20 - 验证成功 ; qrCodeStatus:21 - 二维码已失效

**方法名 :** `verify_qrcodestatus`

**Rust 调用例子 :**

```rust
let query = Query::new().param("qr", "xxx");
let result = client.verify_qrcodestatus(&query).await.unwrap();
```

---

## 致谢 & License

### 致谢

- [NeteaseCloudMusicApi Enhanced](https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced) - 原始 Node.js 实现
- [Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi) - 原始项目

### License

本项目基于 [MIT License](LICENSE) 开源。