# 音频投币&收藏 | BAC Document
社区开源的第三方哔哩哔哩 API 文档

# 音频投币&收藏

## 查询音频收藏状态

> 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：成功 72000000：参数错误 72010002：账号未登陆 7201006：该音频不存在或已被下架
msg | str | 错误信息 | 默认为success
data | bool | 是否收藏 | false：未收藏 true：已收藏

示例：

查询音频`au13598`的收藏状态

    curl -G 'https://www.bilibili.com/audio/music-service-c/web/collections/songs-coll' \
    --data-urlencode 'sid=13598' \
    -b 'SESSDATA=xxx;DedeUserID=1;'

查看响应示例：

    {
        "code": 0,
        "msg": "success",
        "data": true
    }

## 查询音频投币数

> 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：成功 72000000：参数错误 72010002：账号未登陆 7201006：该音频不存在或已被下架
msg | str | 错误信息 | 默认为success
data | num | 投币数量 | 0为未投币，上限为2

示例：

查询音频`au13598`的投币数

    curl -G 'https://www.bilibili.com/audio/music-service-c/web/coin/audio' \
    --data-urlencode 'sid=15664' \
    -b 'SESSDATA=xxx;DedeUserID=1;'

查看响应示例：

    {
        "code": 0,
        "msg": "success",
        "data": 1
    }

## 投币音频

> 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：成功 72000000：参数错误 72010002：账号未登陆 7201006：该音频不存在或已被下架
msg | str | 错误信息 | 默认为 0
data | str | 当前投币数量 | 0 为未投币，上限为 2

示例：

为音频`au13598`投币

    curl -G 'https://www.bilibili.com/audio/music-service-c/web/coin/add' \
    --data-urlencode 'sid=15664' \
    -b 'SESSDATA=xxx;DedeUserID=1;'

查看响应示例：

    {
        "code": 0,
        "msg": "0",
        "data": "1"
    }