返回提交历史
Modified
.gitignore
+2
-1
Modified
README.md
+2
-1
Modified
live/info.md
+1
-0
Modified
live/user.md
+9
-2
Added
user/vip.md
+99
-0
XFEstudio/bilibili-API-collect
大会员福利兑换相关API (#269)
* Update info.md * Update info.md * Update info.md * Update info.md * Update info.md * Update info.md * add user api under live folder * Update info.md * Update user.md * test index * text index * Update README.md * text indexs * update indexs * update Index * update index * update index * update index * update index * update index * 稍微建设了一下目录 * 稍微建设了一下目录 * add vip * 添加大会员福利兑换相关API
2f57550
代码差异
5 个文件
+113
-4
@@ -1 +1,2 @@
1
mkdocs/html/*
1
mkdocs/html/*
2
README.md
@@ -68,6 +68,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http`
68
68
- [个人空间](user/space.md)x
69
69
- [检查昵称是否可注册](user/check_nickname.md)√
70
70
- [用户注册](user/register.md)
71
- [大会员福利兑换](user/vip.md)
71
72
- [视频](video)
72
73
- [视频分区一览（分区代码）](video/video_zone.md)√
73
74
- [基本信息](video/info.md)√
@@ -281,4 +282,4 @@ B站空间：<https://space.bilibili.com/293793435>
281
282
282
283
- [uw-labs/bloomrpc](https://github.com/uw-labs/bloomrpc): GUI Client for GRPC Services
283
284
284
- [grpc/grpc](https://github.com/grpc/grpc): The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
285
- [grpc/grpc](https://github.com/grpc/grpc): The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
@@ -3,6 +3,7 @@
3
3
- [获取用户对应的直播间状态](#获取用户对应的直播间状态)
4
4
- [获取房间页初始化信息](#获取房间页初始化信息)
5
5
- [获取主播信息](#获取主播信息)
6
- [批量查询直播间状态](#批量查询直播间状态)
6
7
7
8
---
8
9
@@ -120,6 +120,13 @@
120
120
| mobile_verify | num | | |
121
121
| official_verify | obj | 认证信息 | |
122
122
123
**示例：**
124
125
```shell
126
curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
127
-b "SESSDATA=xxx"
128
```
129
123
130
<details>
124
131
<summary>查看响应示例：</summary>
125
132
@@ -133,7 +140,7 @@
133
140
"count": 19,
134
141
"fansMedalList": [
135
142
{
136
"uid": 3831650,
143
"uid": 1,
137
144
"target_id": 3821157,
138
145
"medal_id": 283582,
139
146
"score": 16031,
@@ -206,7 +213,7 @@
206
213
"roomid": 21692711
207
214
}
208
215
],
209
"name": "藍地球",
216
"name": "xxx",
210
217
"pageinfo": {
211
218
"totalpages": 2,
212
219
"curPage": 2
@@ -0,0 +1,99 @@
1
# 大会员兑换福利
2
3
- [兑换状态查询](#兑换状态查询)
4
- [兑换](#兑换)
5
6
---
7
8
## 兑换状态查询
9
10
> https://api.bilibili.com/x/vip/privilege/my
11
12
*请求方式:GET*
13
14
认证方式：Cookie（SESSDATA）或APP
15
16
**json回复：**
17
18
根对象：
19
20
| 字段 | 类型 | 内容 | 备注 |
21
| ------- | ---- | -------- | --------------------------- |
22
| code | num | 状态码 | -400：请求错误<br />0：成功 |
23
| message | str | 错误详情 | |
24
| data | obj | 信息本体 | |
25
26
`data`对象：
27
28
| 字段 | 类型 | 内容 | 备注 |
29
| ----- | -------|----------------|------ |
30
| list | 数组 | 信息本体 | |
31
32
`list`数组：
33
34
| 字段 | 类型 | 内容 | 备注 |
35
| ----- | -------|-----------------|------ |
36
| 0 | obj | B币兑换状态 | |
37
| 1 | obj | 会员购优惠券兑换状态 | |
38
39
`list内`对象：
40
41
| 字段 | 类型 | 内容 | 备注 |
42
| -------------- | -----|------------------|------ |
43
| type | num | 1 或 2 | 1：B币</br>2：会员购优惠券 |
44
| status | num | 兑换状态 | 0：当月未兑换</br>1：已兑换 |
45
| expire_time | num | 当月过期时间 | 当月月底 |
46
47
48
**示例：**
49
50
```shell
51
curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
52
```
53
54
<details>
55
<summary>查看响应示例：</summary>
56
57
```json
58
{
59
"code":0,
60
"message":"0",
61
"ttl":1,
62
"data":{
63
"list":[
64
{"type":1,"state":1,"expire_time":1638287999},
65
{"type":2,"state":1,"expire_time":1638287999}
66
]
67
}
68
}
69
```
70
71
</details>
72
73
74
## 兑换
75
> https://api.bilibili.com/x/vip/privilege/my
76
77
*请求方式:POST*
78
79
认证方式：Cookie（SESSDATA）
80
注意：请求头中的Origin字段必须为"https://www.bilibili.com/"
81
82
83
**正文参数：**
84
85
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
86
| ---------- | ---- | ---------- | -------- | ---------------------- |
87
| type | num | 1 或 2 | 必要 | 1：B币</br>2：会员购优惠券 |
88
| csrf | num | CSRF token | 必要 | Cookie bili_jct字段 |
89
90
**示例：**
91
92
```shell
93
curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
94
-H "Origin: https://www.bilibili.com/" \
95
-d "{\"type\": 1, \"csrf\": csrf_token}"
96
```
97
98
**响应：**
99
无响应