update: 文档和 interface 补充

CHANGELOG.MD

@@ -2,6 +2,7 @@
 ### 4.18.0 | 2024.04.30
 - 补充游客 deviceid,防止都指向相同账户,避免网络拥堵提示问题
 - ip 设置问题修复
+- 新增`电台排行榜获取`, `获取声音歌词`接口
 
 ### 4.17.1 | 2024.04.29
 - song/url 参数问题修复

interface.d.ts

@@ -1810,3 +1810,24 @@ export function voicelist_list_search(
     radioId?: string
   } & RequestBaseConfig,
 ): Promise<Response>
+
+export function voice_delete(
+  params: {
+    ids: number | string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function djRadio_top(
+  params: {
+    djRadioId?: number | string
+    sortIndex?: number | string
+    dataGapDays?: number | string
+    dataType?: number | string
+  } & RequestBaseConfig,
+): Promise<Response>
+
+export function voice_lyric(
+  params: {
+    id: number | string
+  } & RequestBaseConfig,
+): Promise<Response>

public/docs/home.md

@@ -292,6 +292,9 @@
 274. 歌曲音质详情
 275. 歌曲红心数量
 276. 私人 FM 模式选择
+277. 播客删除
+278. 电台排行榜获取
+279. 获取声音歌词
 
 ## 安装
 
@@ -1474,7 +1477,6 @@ tags: 歌单标签
 
 说明 : 使用歌单详情接口后 , 能得到的音乐的 id, 但不能得到的音乐 url, 调用此接口, 传入的音乐 id( 可多个 , 用逗号隔开 ), 可以获取对应的音乐的 url,未登录状态或者非会员返回试听片段(返回字段包含被截取的正常歌曲的开始时间和结束时间)
 
-> 注 : 部分用户反馈获取的 url 会 403,[hwaphon](https://github.com/hwaphon)找到的解决方案是当获取到音乐的 id 后，将 https://music.163.com/song/media/outer/url?id=id.mp3 以 src 赋予 Audio 即可播放
 
 **必选参数 :** `id` : 音乐 id
 
@@ -1602,7 +1604,8 @@ tags: 歌单标签
 
 **必选参数 :**
 
-`t` : 类型,1:收藏,2:取消收藏
+`t` : 类型,1:收藏,2:取消收藏  
+
 `id` : 歌单 id
 
 **接口地址 :** `/playlist/subscribe`
@@ -4343,6 +4346,29 @@ ONLINE 已发布
 
 `composedSongs`: 包含歌曲(歌曲id),多个用逗号隔开
 
+### 电台排行榜获取
+说明: 调用此接口可以获取电台排行榜  
+
+**接口地址:** `/djRadio/top`  
+
+**可选参数：**
+`djRadioId` : 电台id
+
+`sortIndex`: 排序 1:播放数 2:点赞数 3：评论数 4：分享数 5：收藏数 默认 1
+
+`dataGapDays`: 天数 7:一周 30:一个月 90:三个月 默认 7
+
+`dataType`: 未知,默认 3
+
+
+### 获取声音歌词
+说明: 调用此接口可以获取声音歌词
+
+**接口地址:** `/voice/lyric`  
+
+**必选参数：**
+`id`: 声音id
+
 ### 验证接口-二维码生成
 说明: 进行某些操作,如关注用户,可能会触发验证,可调用这个接口生成二维码,使用app扫码后可解除验证