update: 新增播客声音搜索 #1814, bump to 4.13.3

docs/README.md

@@ -285,6 +285,7 @@
 267. 用户贡献内容
 268. 用户贡献条目、积分、云贝数量
 269. 年度听歌报告
+270. 播客声音搜索
 
 ## 安装
 
@@ -4210,6 +4211,46 @@ ONLINE 已发布
 
 `offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*200, 其中 200 为 limit 的值
 
+### 播客声音搜索
+说明: 可以搜索播客里的声音
+
+**接口地址:** `/voicelist/list/search`
+
+**可选参数**  
+
+- 状态（非必填）：
+    - `displayStatus: null`（默认）：返回所有状态的声音
+    - `displayStatus: "ONLINE"`：已发布的声音
+    - `displayStatus: "AUDITING"`：审核中的声音
+    - `displayStatus: "ONLY_SELF_SEE"`：尽自己可见的声音
+    - `displayStatus: "SCHEDULE_PUBLISH"`：定时发布的声音
+    - `displayStatus: "TRANSCODE_FAILED"`：上传失败的声音
+    - `displayStatus: "PUBLISHING"`：发布中的声音
+    - `displayStatus: "FAILED"`：发布失败的声音
+
+- `limit: 20`：每次返回的声音数量（最多200个）
+
+- 搜索关键词：
+    - `name: null`：返回所有的声音
+    - `name: [关键词]`：返回包含指定关键词的声音文件
+
+- `offset: 0`：偏移量，用于分页，默认为0，表示从第一个声音开始获取
+
+- 博客：
+    - `radioId: null`：返回所有电台的声音
+    - `radioId: [播客id]`：返回特定播客的声音
+
+- 是否公开：
+    - `type: null`：返回所有类型的声音
+    - `type: "PUBLIC"`：返回公开的声音
+    - `type: "PRIVATE"`：返回隐私的声音
+
+- 是否付费：
+    - `voiceFeeType: null`（默认）：返回所有类型的声音
+    - `voiceFeeType: -1`：返回所有类型的声音
+    - `voiceFeeType: 0`：返回免费的声音
+    - `voiceFeeType: 1`：返回收费的声音
+
 ### 播客声音详情
 
 说明: 获取播客里的声音详情