update: 播客声音上传接口和文档

This commit is contained in:
binaryify
2023-09-07 23:55:26 +08:00
parent 846b7e5fbc
commit dd2365bcb7
7 changed files with 210 additions and 105 deletions
+50
View File
@@ -270,6 +270,8 @@
252. 曲风-歌手
253. 私信和通知接口
254. 回忆坐标
255. 播客搜索
256. 播客声音上传
## 安装
@@ -4159,6 +4161,54 @@ type='1009' 获取其 id, 如`/search?keywords= 代码时间 &type=1009`
**必选参数:** `id` : 歌曲 ID
### 播客列表
说明: 可以获取播客列表
**接口地址:** `/voicelist/search`
**可选参数:**
`limit`: 取出歌单数量 , 默认为 200
`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*200, 其中 200 为 limit 的值
`podcastName`: 播客名称
### 播客上传声音
说明: 可以上传声音到播客,例子在 `/public/voice_upload.html` 访问地址: <a href="/voice_upload.html" target="_blank">/voice_upload.html</a>
**接口地址:** `/voice/upload`
**必选参数:**
`voiceListId`: 播客 id
`coverImgId`: 播客封面
`categoryId`: 分类id
`secondCategoryId`:次级分类id
`description`: 声音介绍
**可选参数:**
`songName`: 声音名称
`privacy`: 设为隐私声音,播客如果是隐私博客,则必须设为1
`publishTime`:默认立即发布,定时发布的话需传入时间戳
`autoPublish`: 是否发布动态,是则传入1
`autoPublishText`: 动态文案
`orderNo`: 排序,默认为1
`composedSongs`: 包含歌曲(歌曲id),多个用逗号隔开
## 离线访问此文档
此文档同时也是 Progressive Web Apps(PWA), 加入了 serviceWorker, 可离线访问