feat: 新增评论相关接口并更新部分接口

This commit is contained in:
MoeFurina
2026-03-08 11:42:32 +08:00
parent b6a1f9ce0a
commit 2dd12b88ae
7 changed files with 136 additions and 12 deletions
+69 -3
View File
@@ -4118,14 +4118,16 @@ type='1009' 获取其 id, 如`/search?keywords= 代码时间 &type=1009`
**接口地址:** `/voicelist/search`
**必选参数:**
`keyword`: 搜索关键词
**可选参数:**
`limit`: 取出歌单数量 , 默认为 200
`limit`: 取出歌单数量, 默认为 10
`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*200, 其中 200 为 limit 的值
`podcastName`: 播客名称
### 播客声音列表
说明: 可以获取播客里的声音
@@ -5065,6 +5067,70 @@ let data = encodeURIComponent(
**调用例子 :** `/user/playlist/collect?uid=32953014`
### 搜索建议 - PC端
说明 : 调用此接口, 传入搜索关键词, 获取搜索建议
**必选参数 :**
`keyword`: 搜索关键词
**接口地址 :** `/search/suggest/pc`
**调用例子 :** `/search/suggest/pc?keyword=海阔天空`
### 喜欢歌曲 - 新版
说明 : 登录后调用此接口, 传入歌曲 id 用户id和喜欢状态, 可喜欢/取消喜欢歌曲
**必选参数 :**
`id`: 歌曲 id
`uid`: 用户 id
`like`: 喜欢状态, true 表示喜欢, false 表示取消喜欢
**接口地址 :** `/song/like`
**调用例子 :** `/song/like?id=2058263032&uid=32953014&like=true`
### 我创建的博客声音
说明 : 登录后调用此接口, 获取我创建的博客声音
**可选参数 :**
`limit` : 返回数量 , 默认为 20
**接口地址 :** `/voicelist/my/created`
**调用例子 :** `/voicelist/my/created`
### 发布评论
说明 : 登录后调用此接口, 传入歌曲 id, 评论内容等信息, 发布评论
**必选参数 :**
`threadId`: 评论线程 id, 可通过获取评论接口返回结果的`threadId`参数获取
`commentId`: 回复评论 id, 若为回复评论则必填
`content`: 评论内容
**接口地址 :** `/comment/reply`
**调用例子 :** `/comment/reply?threadId=R_SO_4_2058263032&content=这首歌太棒了!`
### 删除评论
说明 : 登录后调用此接口, 传入评论 id, 删除评论
**必选参数 :**
`commentId`: 评论 id
`threadId`: 评论线程 id, 可通过获取评论接口返回结果的`threadId`参数获取
**接口地址 :** `/comment/delete`
**调用例子 :** `/comment/delete?threadId=R_SO_4_2058263032&commentId=123456789`
## 离线访问此文档
此文档同时也是 Progressive Web Apps(PWA), 加入了 serviceWorker, 可离线访问