返回提交历史
Modified
live/user.md
+115
-217
XFEstudio/bilibili-API-collect
修正获取用户持有的粉丝勋章 api (#303)
b6c4523
代码差异
1 个文件
+115
-217
@@ -1,6 +1,6 @@
1
# 直播间用户实用API
1
# 直播间用户实用 API
2
2
3
- [直播间用户实用API](#直播间用户实用api)
3
- [直播间用户实用 API](#直播间用户实用-api)
4
4
- [获取用户持有的粉丝勋章信息](#获取用户持有的粉丝勋章信息)
5
5
- [佩戴勋章](#佩戴勋章)
6
6
- [直播签到](#直播签到)
@@ -9,121 +9,75 @@
9
9
10
10
## 获取用户持有的粉丝勋章信息
11
11
12
> http://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal
12
> ~~http://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal~~
13
>
14
> https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals
13
15
14
*请求方式：GET*
16
_请求方式：GET_
15
17
16
认证方式：Cookie（SESSDATA）或APP
18
认证方式：Cookie（SESSDATA）或 APP
17
19
18
**url参数：**
20
**url 参数：**
19
21
20
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
21
| ------ | ---- | ----------- | ------ | ---- |
22
| page | num | 返回结果页数 | 非必要 | 返回结果单页最大为10 |
22
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
23
| --------- | ---- | ------------ | ------ | ------------------------------------------------- |
24
| page_size | num | 每页的数量 | 必要 | 最大为 10，超出 `1002002：参数异常` |
25
| page | num | 返回结果页数 | 必要 | 两个参数不填返回空，只 page 不填或错误则 500 异常 |
23
26
24
**json回复：**
27
**json 回复：**
25
28
26
29
根对象：
27
30
28
| 字段 | 类型 | 内容 | 备注 |
29
| ------- | ---- | -------- | --------------------------- |
30
| code | num | 返回值 | 0：成功<br>-400：请求错误 |
31
| message | str | 错误信息 | 默认为空("") |
32
| msg | str | 错误信息 | 默认为空("") |
33
| data | obj | 信息本体 | |
31
| 字段 | 类型 | 内容 | 备注 |
32
| ------- | ---- | -------- | ------------------------------------------------- |
33
| code | num | 返回值 | 0：成功<br>-1002002：参数异常<br>-500：服务器异常 |
34
| message | str | 错误信息 | 默认为 "0" |
35
| ttl | str | 1 | |
36
| data | obj | 信息本体 | |
34
37
35
38
`data`对象：
36
39
37
| 字段 | 类型 | 内容 | 备注 |
38
| -------------- | ---- | ---------------- | ------------------------ |
39
| medalCount | num | 勋章数量 | |
40
| count | num | 勋章数量 | |
41
| fansMedalList | array | 粉丝勋章信息本体 | |
42
| name | str | 用户名 | |
43
| pageinfo | obj | 页码信息 | |
44
45
`fansMedalList 数组内`对象：
46
47
| 字段 | 类型 | 内容 | 备注 |
48
| -------------- | ---- | ---------------- | ------------------------ |
49
| uid | num | 发起请求的用户mid | |
50
| target_id | num | up主mid | |
51
| medal_id | num | 粉丝勋章id | |
52
| score | num | | |
53
| level | num | 勋章等级 | |
54
| intimacy | num | 当前已得亲密度 | |
55
| status | num | | |
56
| source | num | | |
57
| receive_channel | num | 获得方式 | 2：投币获得<br>3000：b坷拉 |
58
| is_receive | num | 勋章数量 | |
59
| master_status | num | | |
60
| receive_time | str | 勋章获取时间 | |
61
| today_intimacy | num | 本日亲密度 | |
62
| last_wear_time | num | 上次佩戴时间 | |
63
| is_lighted | num | 是否点亮 | 0：未点亮<br>1：点亮 |
64
| medal_level | num | 勋章等级 | |
65
| next_intimacy | num | 升级所需经验 | |
66
| day_limit | num | 日经验上限（原力值）| |
67
| medal_name | str | 勋章名 | |
68
| master_available | num | | |
69
| guard_type | num | 加成状态 | |
70
| lpl_status | num | | |
71
| can_delete | bool | 可否删除 | |
72
| target_name | str | up主用户名 | |
73
| target_face | str | up主头像 | |
74
| live_stream_status | num | 当前直播间放松状态 | |
75
| icon_code | num | | |
76
| icon_text | str | | |
77
| rank | str | | |
78
| medal_color | num | 勋章颜色信息 | 颜色数值为10进制的16进制值（下同） |
79
| medal_color_start | num | 勋章起始颜色 | 从右往左渐变（20级+勋章） |
80
| medal_color_end | num | 勋章结束颜色 | 从右往左渐变（20级+勋章） |
81
| guard_level | num | | |
82
| medal_color_border | num | 勋章颜色信息 | |
83
| today_feed | num | 本日亲密度 | |
84
| todayFeed | num | 同上 | |
85
| dayLimit | num | 日经验上限（原力值） | |
86
| uname | str | up主用户名 | |
87
| color | num | 勋章颜色 | |
88
| medalName | str | 勋章内容 | |
89
| guard_medal_title | str | 加成状态 | |
90
| anchorInfo | obj | up信息 | |
91
| roomid | num | 直播间房间号 | |
92
93
`pageinfo`对象：
94
95
| 字段 | 类型 | 内容 | 备注 |
96
| -------------- | ---- | ---------------- | ------------------------ |
97
| totalpages | num | 页码总长度 | |
98
| curPage | num | 当前返回的页码 | 0：未轮播<br>1：轮播 |
99
100
`anchorInfo`对象：
101
102
| 字段 | 类型 | 内容 | 备注 |
103
| -------------- | ---- | ---------------- | ------------------------ |
104
| uid | num | up主mid | |
105
| uname | str | up主用户名 | |
106
| gender | num | 性别 | 0：女<br>1：男<br/>-1：保密 |
107
| face | str | up主头像 | |
108
| silence | num | up主禁言状态 | |
109
| masterVip | num | 会员类型 | |
110
| masterRank | num | 10000 | |
111
| masterLevel | num | up主主站等级 | |
112
| masterHeadpic | str | up主头像框 | |
113
| masterVerify | num | | |
114
| mobileVerified | num | 当前返回的页码 | |
115
| identification | num | 当前返回的页码 | |
116
| official | obj | 认证信息 | |
117
| rank | num | 当前返回的页码 | |
118
| platform_user_level | num | up主主站等级 | |
119
| vip_type | num | 会员类型 | |
120
| mobile_verify | num | | |
121
| official_verify | obj | 认证信息 | |
40
| 字段 | 类型 | 内容 | 备注 |
41
| --------- | ----- | ---------------- | ---- |
42
| count | num | 勋章数量 | |
43
| items | array | 粉丝勋章信息本体 | |
44
| page_info | obj | 页码信息 | |
45
46
`items 数组内`对象：
47
48
| 字段 | 类型 | 内容 | 备注 |
49
| ------------------ | ------ | -------------------- | -------------------------------------- |
50
| can_delete | bool | 可否删除 | |
51
| day_limit | num | 日经验上限（原力值） | eg: 1500 |
52
| guard_level | num | | |
53
| guard_medal_title | str | 加成状态 | |
54
| intimacy | num | 当前已得亲密度 | |
55
| is_lighted | num | 是否点亮 | 0：未点亮<br>1：点亮 |
56
| level | num | 勋章等级 | |
57
| medal_name | str | 勋章名 | |
58
| medal_color_border | num | 勋章边框颜色信息 | 颜色数值为 10 进制的 16 进制值（下同） |
59
| medal_color_start | num | 勋章起始颜色 | 从右往左渐变（20 级+勋章） |
60
| medal_color_end | num | 勋章结束颜色 | 从右往左渐变（20 级+勋章） |
61
| medal_id | num | 粉丝勋章 id | |
62
| next_intimacy | num | 升级所需经验 | |
63
| today_feed | num | 本日亲密度 | |
64
| roomid | num | 直播间房间号 | |
65
| status | num | | |
66
| target_id | number | up 主 mid | |
67
| target_name | str | up 主用户名 | |
68
| uname | str | up 主用户名 | |
69
70
`page_info`对象：
71
72
| 字段 | 类型 | 内容 | 备注 |
73
| ---------- | ---- | -------------- | ---- |
74
| total_page | num | 页码总长度 | |
75
| cur_page | num | 当前返回的页码 | |
122
76
123
77
**示例：**
124
78
125
79
```shell
126
curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
80
curl https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals?page=1&page_size=10 \
127
81
-b "SESSDATA=xxx"
128
82
```
129
83
@@ -132,93 +86,39 @@ curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
132
86
133
87
```json
134
88
{
135
"code": 0,
136
"msg": "",
137
"message": "",
138
"data": {
139
"medalCount": 20,
140
"count": 19,
141
"fansMedalList": [
142
{
143
"uid": 1,
144
"target_id": 3821157,
145
"medal_id": 283582,
146
"score": 16031,
147
"level": 11,
148
"intimacy": 1130,
149
"status": 0,
150
"source": 1,
151
"receive_channel": 3000,
152
"is_receive": 1,
153
"master_status": 1,
154
"receive_time": "2021-07-24 23:06:03",
155
"today_intimacy": 252,
156
"last_wear_time": 1630386090,
157
"is_lighted": 1,
158
"medal_level": 11,
159
"next_intimacy": 10000,
160
"day_limit": 1500,
161
"medal_name": "秧歌星",
162
"master_available": 1,
163
"guard_type": 0,
164
"lpl_status": 0,
165
"can_delete": true,
166
"target_name": "东爱璃Lovely",
167
"target_face": "https://i0.hdslb.com/bfs/face/fecabd8cb7cc129fd3bdbc4b71cffec91d342bdd.jpg",
168
"live_stream_status": 0,
169
"icon_code": 0,
170
"icon_text": "",
171
"rank": "",
172
"medal_color": 9272486,
173
"medal_color_start": 9272486,
174
"medal_color_end": 9272486,
175
"guard_level": 0,
176
"medal_color_border": 9272486,
177
"today_feed": 252,
178
"todayFeed": 252,
179
"dayLimit": 1500,
180
"uname": "东爱璃Lovely",
181
"color": 9272486,
182
"medalName": "秧歌星",
183
"guard_medal_title": "未开启加成",
184
"anchorInfo": {
185
"uid": 3821157,
186
"uname": "东爱璃Lovely",
187
"gender": -1,
188
"face": "https://i0.hdslb.com/bfs/face/fecabd8cb7cc129fd3bdbc4b71cffec91d342bdd.jpg",
189
"silence": 0,
190
"masterVip": 2,
191
"masterRank": 10000,
192
"masterLevel": 6,
193
"masterHeadpic": "https://i0.hdslb.com/bfs/garb/ebe4ac76f95ccb9146fdba2db2723f182ec3276b.png",
194
"masterVerify": 0,
195
"mobileVerified": 1,
196
"identification": 1,
197
"official": {
198
"role": 7,
199
"title": "bilibili 直播高能主播",
200
"desc": ""
201
},
202
"rank": 10000,
203
"platform_user_level": 6,
204
"vip_type": 2,
205
"mobile_verify": 0,
206
"official_verify": {
207
"role": 7,
208
"title": "bilibili 直播高能主播",
209
"desc": "",
210
"type": -1
211
}
212
},
213
"roomid": 21692711
214
}
215
],
216
"name": "xxx",
217
"pageinfo": {
218
"totalpages": 2,
219
"curPage": 2
220
}
221
}
89
"code": 0,
90
"message": "0",
91
"ttl": 1,
92
"data": {
93
"items": [
94
{
95
"can_deleted": true,
96
"day_limit": 1500,
97
"guard_level": 0,
98
"guard_medal_title": "未开启加成",
99
"intimacy": 9617,
100
"is_lighted": 0,
101
"level": 11,
102
"medal_name": "锦依卫",
103
"medal_color_border": 12632256,
104
"medal_color_end": 12632256,
105
"medal_color_start": 12632256,
106
"medal_id": 29245,
107
"next_intimacy": 10000,
108
"today_feed": 0,
109
"roomid": 1546736,
110
"status": 0,
111
"target_id": 36081646,
112
"target_name": "洛天依",
113
"uname": "洛天依"
114
}
115
],
116
"page_info": {
117
"cur_page": 1,
118
"total_page": 1
119
},
120
"count": 1
121
}
222
122
}
223
123
```
224
124
@@ -228,30 +128,30 @@ curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
228
128
229
129
> http://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear
230
130
231
*请求方式：POST*
131
_请求方式：POST_
232
132
233
133
**表单参数：**
234
134
235
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
236
| ---------- | ---- | -------------------- | ---- | ---- |
237
| medal_id | num | 勋章id | 必要 | |
238
| csrf | num | cookie中bili_jct字段 | 必要 | |
239
| csrf_token | num | 同上 | 必要 | |
135
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
136
| ---------- | ---- | ----------------------- | ------ | ---- |
137
| medal_id | num | 勋章 id | 必要 | |
138
| csrf | num | cookie 中 bili_jct 字段 | 必要 | |
139
| csrf_token | num | 同上 | 必要 | |
240
140
241
**json回复：**
141
**json 回复：**
242
142
243
143
根对象：
244
144
245
| 字段 | 类型 | 内容 | 备注 |
246
| ------- | ---- | -------- | --------------------------- |
247
| code | num | 返回值 | 0：成功 |
248
| ttl | str | 1 | |
249
| message | str | 错误信息 | 默认为佩戴成功 |
250
| data | obj | 信息本体 | 默认为无 |
145
| 字段 | 类型 | 内容 | 备注 |
146
| ------- | ---- | -------- | -------------- |
147
| code | num | 返回值 | 0：成功 |
148
| ttl | str | 1 | |
149
| message | str | 错误信息 | 默认为佩戴成功 |
150
| data | obj | 信息本体 | 默认为无 |
251
151
252
152
**示例：**
253
153
254
佩戴勋章id为1的勋章
154
佩戴勋章 id 为 1 的勋章
255
155
256
156
```JavaScript
257
157
var madelForm = new FormData();
@@ -280,10 +180,10 @@ $.ajax({
280
180
281
181
```json
282
182
{
283
"code": 0,
284
"message": "佩戴成功",
285
"ttl": 1,
286
"data": {}
183
"code": 0,
184
"message": "佩戴成功",
185
"ttl": 1,
186
"data": {}
287
187
}
288
188
```
289
189
@@ -293,19 +193,17 @@ $.ajax({
293
193
294
194
> http://api.live.bilibili.com/xlive/web-ucenter/v1/sign/DoSign
295
195
296
*请求方式：GET*
196
_请求方式：GET_
297
197
298
认证方式：Cookie（SESSDATA）或APP
198
认证方式：Cookie（SESSDATA）或 APP
299
199
300
**json回复：**
200
**json 回复：**
301
201
302
202
根对象：
303
203
304
| 字段 | 类型 | 内容 | 备注 |
204
| 字段 | 类型 | 内容 | 备注 |
305
205
| ------- | ---- | -------- | ---------------------- |
306
| code | num | 返回值 | 0：成功<br>1：参数错误 |
307
| ttl | str | 1 | |
308
| message | str | 错误信息 | 默认为当日签到奖励内容 |
309
| data | obj | 信息本体 | 默认为空 |
310
311
206
| code | num | 返回值 | 0：成功<br>1：参数错误 |
207
| ttl | str | 1 | |
208
| message | str | 错误信息 | 默认为当日签到奖励内容 |
209
| data | obj | 信息本体 | 默认为空 |