返回提交历史
Modified
docs/vip/action.md
+46
-30
XFEstudio/bilibili-API-collect
fix #1177
f52ac24
代码差异
1 个文件
+46
-30
@@ -2,7 +2,7 @@
2
2
3
3
## 兑换卡券
4
4
5
> https://api.bilibili.com/x/vip/privilege/receive
5
> <https://api.bilibili.com/x/vip/privilege/receive>
6
6
7
7
*请求方式：POST*
8
8
@@ -10,28 +10,28 @@
10
10
11
11
**正文参数 (application/x-www-form-urlencoded)：**
12
12
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
|------|-----|-----------------------|-------------|--------------------------------------------------------------------------------------|
15
| type | num | 兑换类型 | 必要 | 1：B币券<br />2：会员购优惠券<br />3：漫画福利券<br />4：会员购包邮券<br/>5：漫画商城优惠券<br/>6：装扮体验卡<br/>7：课堂优惠券 |
16
| csrf | str | CSRF Token (位于cookie) | Cookie 方式必要 | |
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
| ------ | ---- | ----------------------- | ------ | ------------------------------------------------------------------------------------ |
15
| type | num | 兑换类型 | 必要 | 1：B币券<br />2：会员购优惠券<br />3：漫画福利券<br />4：会员购包邮券<br />5：漫画商城优惠券<br />6：装扮体验卡<br />7：课堂优惠券 |
16
| csrf | str | CSRF Token (位于cookie) | 必要 | |
17
17
18
18
**json回复：**
19
19
20
20
根对象：
21
21
22
| 字段 | 类型 | 内容 | 备注 |
23
|---------|-----|------|---------------------------------------------------------------------------------------------------|
24
| code | num | 返回值 | -101：账号未登录<br />-111：csrf 校验失败<br />-400：请求错误<br />69800：网络繁忙 请稍后再试<br />69801：你已领取过该权益<br />0：成功 |
25
| message | str | 错误信息 | |
26
| ttl | num | 1 | |
22
| 字段 | 类型 | 内容 | 备注 |
23
| ------- | ---- | -------- | ------------------------------------------------------------------------------------------------- |
24
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf 校验失败<br />-400：请求错误<br />69800：网络繁忙 请稍后再试<br />69801：你已领取过该权益 |
25
| message | str | 错误信息 | 成功时为`0` |
26
| ttl | num | 1 | |
27
27
28
28
**示例：**
29
29
30
30
```shell
31
31
curl 'https://api.bilibili.com/x/vip/privilege/receive' \
32
-b 'SESSDATA=xxx' \
33
--data-urlencode 'type=1' \
34
--data-urlencode 'csrf=xxx'
32
-b 'SESSDATA=xxx' \
33
--data-urlencode 'type=1' \
34
--data-urlencode 'csrf=xxx'
35
35
```
36
36
37
37
<details>
@@ -49,7 +49,7 @@ curl 'https://api.bilibili.com/x/vip/privilege/receive' \
49
49
50
50
## 大会员每日经验
51
51
52
> https://api.bilibili.com/x/vip/experience/add
52
> <https://api.bilibili.com/x/vip/experience/add>
53
53
54
54
*请求方式：POST*
55
55
@@ -57,39 +57,55 @@ curl 'https://api.bilibili.com/x/vip/privilege/receive' \
57
57
58
58
**正文参数 (application/x-www-form-urlencoded)：**
59
59
60
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
61
|------|-----|-----------------------|-------------|--------------------------------------------------------------------------------------|
62
| csrf | str | CSRF Token (位于cookie) | Cookie 方式必要 | |
60
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
61
| ------ | ---- | ----------------------- | ------ | ---- |
62
| csrf | str | CSRF Token (位于cookie) | 必要 | |
63
63
64
64
**json回复：**
65
65
66
66
根对象：
67
67
68
| 字段 | 类型 | 内容 | 备注 |
69
|---------|-----|------|---------------------------------------------------------------------------------------------------|
70
| code | num | 返回值 | -101：账号未登录<br />-111：csrf 校验失败<br />69198：用户经验已经领取<br />6034007：请求频繁,请稍后再试<br />0：成功 |
71
| message | str | 错误信息 | ` |
72
| ttl | num | 1 | |
73
| data | obj | | 信息本体 |
68
| 字段 | 类型 | 内容 | 备注 |
69
| ------- | ---- | -------- | ---------------------------------------------------------------------------------------------- |
70
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf 校验失败<br />69198：用户经验已经领取<br />6034007：请求频繁,请稍后再试 |
71
| message | str | 错误信息 | 成功时为`0` |
72
| ttl | num | 1 | |
73
| data | obj | 信息本体 | |
74
74
75
**`data`对象：**
75
`data`对象：
76
76
77
| 字段名 | 类型 | 内容 | 备注 |
78
| ------------------ | ------------------------------- | -------------------- | ---------------------------------------------- |
79
| type | num | 0 | |
80
| is_grant | bool | | 暂时发现 code 为 0 时为 `true` |
77
| 字段 | 类型 | 内容 | 备注 |
78
| -------- | ---- | ------------ | ---------------- |
79
| type | num | 0 | **作用尚不明确** |
80
| is_grant | bool | 是否领取成功 | |
81
81
82
82
**示例：**
83
83
84
84
```shell
85
85
curl 'https://api.bilibili.com/x/vip/experience/add' \
86
-b 'SESSDATA=xxx' \
87
--data-urlencode 'csrf=xxx'
86
-b 'SESSDATA=xxx' \
87
--data-urlencode 'csrf=xxx'
88
88
```
89
89
90
90
<details>
91
91
<summary>查看响应示例：</summary>
92
92
93
当经验领取成功时：
94
95
```json
96
{
97
"code": 0,
98
"message": "0",
99
"ttl": 1,
100
"data": {
101
"type": 0,
102
"is_grant": true
103
}
104
}
105
```
106
107
当经验已经领取过时：
108
93
109
```json
94
110
{
95
111
"code": 69198,