🚀调整项目结构

2023-02-22 01:00:06 +08:00
parent b85e835ce7
commit 7d89ece2ac
201 changed files with 84964 additions and 0 deletions
--- a/docs/audio/action.md
+++ b/docs/audio/action.md
@@ -0,0 +1,154 @@
+# 音频投币&收藏
+
+- [查询音频收藏状态](#查询音频收藏状态)
+- [查询音频投币数](#查询音频投币数)
+- [投币音频](#投币音频)
+
+---
+
+## 查询音频收藏状态
+
+> https://www.bilibili.com/audio/music-service-c/web/collections/songs-coll
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+鉴权方式：Cookie中`DedeUserID`存在且不为0
+
+**url参数：**
+
+| 参数名 | 类型 | 内容     | 必要性 | 备注 |
+| ------ | ---- | -------- | ------ | ---- |
+| sid    | num  | 音频auid | 必要   |      |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容     | 备注                                                         |
+| ---- | ---- | -------- | ------------------------------------------------------------ |
+| code | num  | 返回值   | 0：成功<br />72000000：参数错误<br />72010002：账号未登陆<br />7201006：该音频不存在或已被下架 |
+| msg  | str  | 错误信息 | 默认为success                                                |
+| data | bool | 是否收藏 | false：未收藏<br />true：已收藏                              |
+
+**示例：**
+
+查询音频`au13598`的收藏状态
+
+```shell
+curl -G 'https://www.bilibili.com/audio/music-service-c/web/collections/songs-coll' \
+--data-urlencode 'sid=13598' \
+-b 'SESSDATA=xxx;DedeUserID=1;'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "msg": "success",
+    "data": true
+}
+```
+
+</details>
+
+## 查询音频投币数
+
+> https://www.bilibili.com/audio/music-service-c/web/coin/audio
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+鉴权方式：Cookie中`DedeUserID`存在且不为0
+
+**url参数：**
+
+| 参数名 | 类型 | 内容     | 必要性 | 备注 |
+| ------ | ---- | -------- | ------ | ---- |
+| sid    | num  | 音频auid | 必要   |      |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容     | 备注                                                         |
+| ---- | ---- | -------- | ------------------------------------------------------------ |
+| code | num  | 返回值   | 0：成功<br />72000000：参数错误<br />72010002：账号未登陆<br />7201006：该音频不存在或已被下架 |
+| msg  | str  | 错误信息 | 默认为success                                                |
+| data | num  | 投币数量 | 0为未投币，上限为2                                           |
+
+**示例：**
+
+查询音频`au13598`的投币数
+
+```shell
+curl -G 'https://www.bilibili.com/audio/music-service-c/web/coin/audio' \
+--data-urlencode 'sid=15664' \
+-b 'SESSDATA=xxx;DedeUserID=1;'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "msg": "success",
+    "data": 1
+}
+```
+
+</details>
+
+## 投币音频
+
+> https://www.bilibili.com/audio/music-service-c/web/coin/add
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名   | 类型 | 内容                      | 必要性 | 备注 |
+| -------- | ---- | ------------------------- | ------ | ---- |
+| sid      | num  | 音频 auid                 | 必要   |      |
+| multiply | num  | 投币数量（最大为 2）      | 必要   |      |
+| csrf     | str  | CSRF Token（位于 cookie） | 必要   |      |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 |   内容     | 备注                                                         |
+| ---- | ---- | --------- | ------------------------------------------------------------ |
+| code | num  |   返回值   | 0：成功<br />72000000：参数错误<br />72010002：账号未登陆<br />7201006：该音频不存在或已被下架 |
+| msg  | str  |   错误信息  | 默认为 0                                               |
+| data | str  | 当前投币数量 | 0 为未投币，上限为 2                                            |
+
+**示例：**
+
+为音频`au13598`投币
+
+```shell
+curl -G 'https://www.bilibili.com/audio/music-service-c/web/coin/add' \
+--data-urlencode 'sid=15664' \
+-b 'SESSDATA=xxx;DedeUserID=1;'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "msg": "0",
+    "data": "1"
+}
+```
+
+</details>