bilibili-API-collect/docs/vip/action.md
2023-11-28 22:43:03 +08:00

106 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 大会员操作
## 兑换卡券
> https://api.bilibili.com/x/vip/privilege/receive
*请求方式POST*
认证方式Cookie (SESSDATA)
**正文参数 (application/x-www-form-urlencoded)**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|------|-----|-----------------------|-------------|--------------------------------------------------------------------------------------|
| type | num | 兑换类型 | 必要 | 1B币券<br />2会员购优惠券<br />3漫画福利券<br />4会员购包邮券<br/>5漫画商城优惠券<br/>6装扮体验卡<br/>7课堂优惠券 |
| csrf | str | CSRF Token (位于cookie) | Cookie 方式必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|---------------------------------------------------------------------------------------------------|
| code | num | 返回值 | -101账号未登录<br />-111csrf 校验失败<br />-400请求错误<br />69800网络繁忙 请稍后再试<br />69801你已领取过该权益<br />0成功 |
| message | str | 错误信息 | |
| ttl | num | 1 | |
**示例:**
```shell
curl 'https://api.bilibili.com/x/vip/privilege/receive' \
-b 'SESSDATA=xxx' \
--data-urlencode 'type=1' \
--data-urlencode 'csrf=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
</details>
## 大会员每日经验
> https://api.bilibili.com/x/vip/experience/add
*请求方式POST*
认证方式Cookie (SESSDATA)
**正文参数 (application/x-www-form-urlencoded)**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|------|-----|-----------------------|-------------|--------------------------------------------------------------------------------------|
| csrf | str | CSRF Token (位于cookie) | Cookie 方式必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|---------------------------------------------------------------------------------------------------|
| code | num | 返回值 | -101账号未登录<br />-111csrf 校验失败<br />69198用户经验已经领取<br />6034007请求频繁,请稍后再试<br />0成功 |
| message | str | 错误信息 | ` |
| ttl | num | 1 | |
| data | obj | | 信息本体 |
**`data`对象:**
| 字段名 | 类型 | 内容 | 备注 |
| ------------------ | ------------------------------- | -------------------- | ---------------------------------------------- |
| type | num | 0 | |
| is_grant | bool | | 暂时发现 code 为 0 时为 `true` |
**示例:**
```shell
curl 'https://api.bilibili.com/x/vip/experience/add' \
-b 'SESSDATA=xxx' \
--data-urlencode 'csrf=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 69198,
"message": "用户经验已经领取",
"ttl": 1,
"data": {
"type": 0,
"is_grant": false
}
}
```
</details>