返回提交历史
Modified
user/vip.md
+90
-90
XFEstudio/bilibili-API-collect
添加缺失信息 (#505)
4747eba
代码差异
1 个文件
+90
-90
@@ -1,8 +1,8 @@
1
1
# 大会员兑换福利
2
2
3
3
- [大会员兑换福利](#大会员兑换福利)
4
- [兑换状态查询](#兑换状态查询)
5
- [兑换](#兑换)
4
- [卡券状态查询](#卡券状态查询)
5
- [兑换卡券](#兑换卡券)
6
6
7
7
---
8
8
@@ -18,41 +18,41 @@
18
18
19
19
根对象：
20
20
21
| 字段 | 类型 | 内容 | 备注 |
22
| ------- | ---- | -------- | --------------------------- |
23
| code | num | 返回值 | -101：账号未登录<br />-400：请求错误<br />0：成功 |
24
| message | str | 错误信息 | |
25
| ttl | num | 1 | |
26
| data | obj | 信息本体 | |
21
| 字段 | 类型 | 内容 | 备注 |
22
|---------|-----|------|-------------------------------------|
23
| code | num | 返回值 | -101：账号未登录<br />-400：请求错误<br />0：成功 |
24
| message | str | 错误信息 | |
25
| ttl | num | 1 | |
26
| data | obj | 信息本体 | |
27
27
28
28
`data`对象：
29
29
30
| 字段 | 类型 | 内容 | 备注 |
31
| ----- | -------|----------------|------ |
32
| list | array | 卡券列表 | |
33
| is_short_vip | bool | (?) | |
34
| is_freight_open | bool | (?) | |
30
| 字段 | 类型 | 内容 | 备注 |
31
|-----------------|-------|--------|-----|
32
| list | array | 卡券信息列表 | |
33
| is_short_vip | bool | (?) | |
34
| is_freight_open | bool | (?) | |
35
35
36
36
`list`数组：
37
37
38
| 字段 | 类型 | 内容 | 备注 |
39
| ----- | -------|-----------------|------ |
40
| 0 | obj | B币兑换状态 | |
41
| 1 | obj | 会员购优惠券兑换状态 | |
42
| 2 | obj | 漫画福利券兑换状态 | |
43
| 3 | obj | 会员购运费券兑换状态 | |
38
| 字段 | 类型 | 内容 | 备注 |
39
|-----|-----|-------------|-----|
40
| 0 | obj | B币兑换状态 | |
41
| 1 | obj | 会员购优惠券兑换状态 | |
42
| 2 | obj | 漫画福利券兑换状态 | |
43
| 3 | obj | 会员购包邮券兑换状态 | |
44
| 4 | obj | 漫画商城优惠券兑换状态 | |
44
45
45
46
`list`中的对象：
46
47
47
| 字段 | 类型 | 内容 | 备注 |
48
| -------------- | -----|------------------|------ |
49
| type | num | 卡券类型 | 1：B币<br />2：会员购优惠券<br />3：漫画福利券<br />4：会员购运费券 |
50
| state | num | 兑换状态 | 0：当月未兑换<br />1：已兑换 |
51
| expire_time | num | 当月过期时间 | 当月月底 |
52
| vip_type | num | | 2：年度大会员可兑换 |
53
| next_receive_days | num | 距下一轮兑换剩余天数 | |
54
| period_end_unix | num | 距下一轮兑换截止时间戳 | 秒级时间戳 |
55
48
| 字段 | 类型 | 内容 | 备注 |
49
|-------------------|-----|------------|--------------------------------------------------------------|
50
| type | num | 卡券类型 | 1：B币券<br />2：会员购优惠券<br />3：漫画福利券<br />4：会员购包邮券<br/>5：漫画商城优惠券 |
51
| state | num | 兑换状态 | 0：当月未兑换<br />1：已兑换 |
52
| expire_time | num | 本轮卡券过期时间戳 | 当月月底 |
53
| vip_type | num | | 2：年度大会员可兑换 |
54
| next_receive_days | num | 距下一轮兑换剩余天数 | |
55
| period_end_unix | num | 下一轮兑换开始时间戳 | 秒级时间戳 |
56
56
57
57
**示例：**
58
58
@@ -66,62 +66,62 @@ curl -G 'http://api.bilibili.com/x/vip/privilege/my' \
66
66
67
67
```json
68
68
{
69
"code": 0,
70
"message": "0",
71
"ttl": 1,
72
"data": {
73
"list": [
74
{
75
"type": 1,
76
"state": 1,
77
"expire_time": 1651334399,
78
"vip_type": 2,
79
"next_receive_days": 20,
80
"period_end_unix": 1651420800
81
},
82
{
83
"type": 2,
84
"state": 0,
85
"expire_time": 1651334399,
86
"vip_type": 2,
87
"next_receive_days": 20,
88
"period_end_unix": 1651420800
89
},
90
{
91
"type": 3,
92
"state": 1,
93
"expire_time": 1651334399,
94
"vip_type": 2,
95
"next_receive_days": 20,
96
"period_end_unix": 1651420800
97
},
98
{
99
"type": 4,
100
"state": 0,
101
"expire_time": 1651334399,
102
"vip_type": 2,
103
"next_receive_days": 20,
104
"period_end_unix": 1651420800
105
},
106
{
107
"type": 5,
108
"state": 0,
109
"expire_time": 1651334399,
110
"vip_type": 2,
111
"next_receive_days": 20,
112
"period_end_unix": 1651420800
113
}
114
],
115
"is_short_vip": false,
116
"is_freight_open": true
117
}
69
"code": 0,
70
"message": "0",
71
"ttl": 1,
72
"data": {
73
"list": [
74
{
75
"type": 1,
76
"state": 0,
77
"expire_time": 1667231999,
78
"vip_type": 2,
79
"next_receive_days": 29,
80
"period_end_unix": 1667491200
81
},
82
{
83
"type": 2,
84
"state": 0,
85
"expire_time": 1667231999,
86
"vip_type": 2,
87
"next_receive_days": 29,
88
"period_end_unix": 1667491200
89
},
90
{
91
"type": 3,
92
"state": 0,
93
"expire_time": 1667231999,
94
"vip_type": 2,
95
"next_receive_days": 29,
96
"period_end_unix": 1667491200
97
},
98
{
99
"type": 4,
100
"state": 0,
101
"expire_time": 1667231999,
102
"vip_type": 2,
103
"next_receive_days": 29,
104
"period_end_unix": 1667491200
105
},
106
{
107
"type": 5,
108
"state": 0,
109
"expire_time": 1667231999,
110
"vip_type": 2,
111
"next_receive_days": 29,
112
"period_end_unix": 1667491200
113
}
114
],
115
"is_short_vip": false,
116
"is_freight_open": true
117
}
118
118
}
119
119
```
120
120
121
121
</details>
122
122
123
## 兑换卡券
123
124
124
## 兑换
125
125
> http://api.bilibili.com/x/vip/privilege/receive
126
126
127
127
*请求方式:POST*
@@ -130,20 +130,20 @@ curl -G 'http://api.bilibili.com/x/vip/privilege/my' \
130
130
131
131
**正文参数：**
132
132
133
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
134
| ---------- | ---- | ---------- | -------- | ---------------------- |
135
| type | num | 兑换类型 | 必要 | 1：B币<br />2：会员购优惠券<br />3：漫画福利券<br />4：会员购运费券 |
136
| csrf | num | CSRF token | 必要 | Cookie bili_jct字段 |
133
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
134
|------|-----|------------|-----|--------------------------------------------------------------|
135
| type | num | 兑换类型 | 必要 | 1：B币券<br />2：会员购优惠券<br />3：漫画福利券<br />4：会员购包邮券<br/>5：漫画商城优惠券 |
136
| csrf | num | CSRF token | 必要 | Cookie bili_jct字段 |
137
137
138
138
**json回复：**
139
139
140
140
根对象：
141
141
142
| 字段 | 类型 | 内容 | 备注 |
143
| ------- | ---- | -------- | ------------------------------------------------------------ |
144
| code | num | 返回值 | -101：账号未登录<br />-111：csrf 校验失败<br />-400：请求错误<br />69800：网络繁忙 请稍后再试<br />69801：你已领取过该权益<br />0：成功 |
145
| message | str | 错误信息 | |
146
| ttl | num | 1 | |
142
| 字段 | 类型 | 内容 | 备注 |
143
|---------|-----|------|---------------------------------------------------------------------------------------------------|
144
| code | num | 返回值 | -101：账号未登录<br />-111：csrf 校验失败<br />-400：请求错误<br />69800：网络繁忙 请稍后再试<br />69801：你已领取过该权益<br />0：成功 |
145
| message | str | 错误信息 | |
146
| ttl | num | 1 | |
147
147
148
148
**示例：**
149
149
@@ -159,9 +159,9 @@ curl 'http://api.bilibili.com/x/vip/privilege/receive' \
159
159
160
160
```json
161
161
{
162
"code": 0,
163
"message": "0",
164
"ttl": 1
162
"code": 0,
163
"message": "0",
164
"ttl": 1
165
165
}
166
166
```
167
167