mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2024-12-28 05:20:07 +08:00
149 lines
3.9 KiB
Markdown
149 lines
3.9 KiB
Markdown
# 音频投币&收藏
|
||
|
||
## 查询音频收藏状态
|
||
|
||
> 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>
|