bilibili-API-collect/docs/vip/action.md
Northern_Lights da24448000
Some checks failed
deploy and publish / build-and-deploy (push) Has been cancelled
revert 7809924e2d
revert delete all
2026-01-29 09:03:04 +00:00

122 lines
3.9 KiB
Markdown
Raw Permalink 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) | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf 校验失败<br />-400请求错误<br />69800网络繁忙 请稍后再试<br />69801你已领取过该权益 |
| message | str | 错误信息 | 成功时为`0` |
| 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) | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------------------------------------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf 校验失败<br />69198用户经验已经领取<br />6034007请求频繁,请稍后再试 |
| message | str | 错误信息 | 成功时为`0` |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------ | ---------------- |
| type | num | 0 | **作用尚不明确** |
| is_grant | bool | 是否领取成功 | |
**示例:**
```shell
curl 'https://api.bilibili.com/x/vip/experience/add' \
-b 'SESSDATA=xxx' \
--data-urlencode 'csrf=xxx'
```
<details>
<summary>查看响应示例:</summary>
当经验领取成功时:
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"type": 0,
"is_grant": true
}
}
```
当经验已经领取过时:
```json
{
"code": 69198,
"message": "用户经验已经领取",
"ttl": 1,
"data": {
"type": 0,
"is_grant": false
}
}
```
</details>