返回提交历史
Modified
user/vip.md
+65
-27
XFEstudio/bilibili-API-collect
修正大会员兑换 api (#294)
* 修正大会员兑换 api * 修正大会员兑换 api (#293) * 补完 api 示例 * 统一写作 http * 修正【大会员权益】文档格式 Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
d1f6b21
代码差异
1 个文件
+65
-27
@@ -6,7 +6,7 @@
6
6
7
7
---
8
8
9
## 兑换状态查询
9
## 卡券状态查询
10
10
11
11
> http://api.bilibili.com/x/vip/privilege/my
12
12
@@ -20,15 +20,16 @@
20
20
21
21
| 字段 | 类型 | 内容 | 备注 |
22
22
| ------- | ---- | -------- | --------------------------- |
23
| code | num | 状态码 | -400：请求错误<br />0：成功 |
24
| message | str | 错误详情 | |
23
| code | num | 返回值 | -101：账号未登录<br />-400：请求错误<br />0：成功 |
24
| message | str | 错误信息 | |
25
| ttl | num | 1 | |
25
26
| data | obj | 信息本体 | |
26
27
27
28
`data`对象：
28
29
29
30
| 字段 | 类型 | 内容 | 备注 |
30
31
| ----- | -------|----------------|------ |
31
| list | 数组 | 信息本体 | |
32
| list | array | 卡券列表 | |
32
33
33
34
`list`数组：
34
35
@@ -37,19 +38,21 @@
37
38
| 0 | obj | B币兑换状态 | |
38
39
| 1 | obj | 会员购优惠券兑换状态 | |
39
40
40
`list内`对象：
41
`list`中的对象：
41
42
42
43
| 字段 | 类型 | 内容 | 备注 |
43
44
| -------------- | -----|------------------|------ |
44
| type | num | 1 或 2 | 1：B币</br>2：会员购优惠券 |
45
| status | num | 兑换状态 | 0：当月未兑换</br>1：已兑换 |
45
| type | num | 卡券类型 | 1：B币<br />2：会员购优惠券<br />3：漫画福利券 |
46
| state | num | 兑换状态 | 0：当月未兑换<br />1：已兑换 |
46
47
| expire_time | num | 当月过期时间 | 当月月底 |
48
| vip_type | num | (?) | |
47
49
48
50
49
51
**示例：**
50
52
51
53
```shell
52
curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
54
curl -G 'http://api.bilibili.com/x/vip/privilege/my' \
55
-b "SESSDATA=xxx"
53
56
```
54
57
55
58
<details>
@@ -57,15 +60,31 @@ curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
57
60
58
61
```json
59
62
{
60
"code":0,
61
"message":"0",
62
"ttl":1,
63
"data":{
64
"list":[
65
{"type":1,"state":1,"expire_time":1638287999},
66
{"type":2,"state":1,"expire_time":1638287999}
67
]
68
}
63
"code": 0,
64
"message": "0",
65
"ttl": 1,
66
"data": {
67
"list": [
68
{
69
"type": 1,
70
"state": 1,
71
"expire_time": 1640966399,
72
"vip_type": 2
73
},
74
{
75
"type": 2,
76
"state": 1,
77
"expire_time": 1640966399,
78
"vip_type": 2
79
},
80
{
81
"type": 3,
82
"state": 0,
83
"expire_time": 1640966399,
84
"vip_type": 2
85
}
86
]
87
}
69
88
}
70
89
```
71
90
@@ -73,28 +92,47 @@ curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
73
92
74
93
75
94
## 兑换
76
> http://api.bilibili.com/x/vip/privilege/my
95
> http://api.bilibili.com/x/vip/privilege/receive
77
96
78
97
*请求方式:POST*
79
98
80
认证方式：Cookie（SESSDATA）
81
注意：请求头中的Origin字段必须为"https://www.bilibili.com/"
82
99
认证方式：Cookie(SESSDATA)
83
100
84
101
**正文参数：**
85
102
86
103
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
87
104
| ---------- | ---- | ---------- | -------- | ---------------------- |
88
| type | num | 1 或 2 | 必要 | 1：B币</br>2：会员购优惠券 |
105
| type | num | 兑换类型 | 必要 | 1：B币<br />2：会员购优惠券<br />3：漫画福利券 |
89
106
| csrf | num | CSRF token | 必要 | Cookie bili_jct字段 |
90
107
108
**json回复：**
109
110
根对象：
111
112
| 字段 | 类型 | 内容 | 备注 |
113
| ------- | ---- | -------- | ------------------------------------------------------------ |
114
| code | num | 返回值 | -101：账号未登录<br />-111：csrf 校验失败<br />-400：请求错误<br />69800：网络繁忙 请稍后再试<br />69801：你已领取过该权益<br />0：成功 |
115
| message | str | 错误信息 | |
116
| ttl | num | 1 | |
117
91
118
**示例：**
92
119
93
120
```shell
94
curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
95
-H "Origin: https://www.bilibili.com/" \
96
-d "{\"type\": 1, \"csrf\": csrf_token}"
121
curl 'http://api.bilibili.com/x/vip/privilege/receive' \
122
-b 'SESSDATA=xxx' \
123
--data-urlencode 'type=1' \
124
--data-urlencode 'csrf=csrf_token'
125
```
126
127
<details>
128
<summary>查看响应示例：</summary>
129
130
```json
131
{
132
"code": 0,
133
"message": "0",
134
"ttl": 1
135
}
97
136
```
98
137
99
**响应：**
100
无响应
138
</details>