返回提交历史
Modified
electric/charge_list.md
+103
-1
Modified
user/info.md
+15
-13
Modified
user/relation.md
+162
-1
XFEstudio/bilibili-API-collect
添加“查询互相关注明细”、“查询历史充电数据”API (#587)
* Update relation.md * Update relation.md * Update info.md * Update relation.md * Update relation.md * Update charge_list.md * Update charge_list.md
c3515d8
代码差异
3 个文件
+280
-15
@@ -2,6 +2,8 @@
2
2
3
3
- [获取空间充电公示列表](#获取空间充电公示列表)
4
4
- [获取视频充电鸣谢名单](#获取视频充电鸣谢名单)
5
- [查询我收到的充电列表](#查询我收到的充电列表)
6
- [查询历史充电数据](#查询历史充电数据)
5
7
6
8
---
7
9
@@ -425,4 +427,104 @@ curl -L -X GET 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRec
425
427
}
426
428
```
427
429
428
</details>
430
</details>
431
432
## 查询历史充电数据
433
434
> https://member.bilibili.com/x/h5/elec/rank/recent
435
436
*请求方式：GET*
437
438
认证方式：Cookie（SESSDATA）
439
440
**url参数：**
441
442
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
443
| -------- | ---- | -------- | ------ | -------------------------------- |
444
| pn | num | 页数 | 必要 | |
445
| ps | num | 分页大小 | 必要 | 取值范围[1,20] |
446
447
**json回复：**
448
449
根对象：
450
451
| 字段 | 类型 | 内容 | 备注 |
452
| ------- | ---- | -------- | ------- |
453
| code | num | 返回值 | 0：成功 |
454
| message | str | 错误信息 | |
455
| ttl | num | 1 | |
456
| data | obj | 信息本体 | |
457
458
`data`对象：
459
460
| 字段 | 类型 | 内容 | 备注 |
461
| ----- | ----- | ------------ | ---- |
462
| list | array | 充电信息本体 | |
463
| pager | obj | 分页信息 | |
464
465
`list`数组中的对象：
466
467
| 字段 | 类型 | 内容 | 备注 |
468
| -------- | ---- | ---------- | ------------------- |
469
| aid | num | 0 | |
470
| bvid | str | 空 | |
471
| elec_num | num | 充电电池数 | |
472
| title | str | 空 | |
473
| uname | str | 空 | |
474
| avatar | str | 空 | |
475
| ctime | str | 充电时间 | yyyy-MM-dd HH:mm:ss |
476
477
`pager`对象：
478
479
| 字段 | 类型 | 内容 | 备注 |
480
| ------- | ---- | ------------ | ---- |
481
| current | num | 当前页数 | |
482
| size | num | 当前分页大小 | |
483
| total | num | 记录总数 | |
484
485
**示例：**
486
487
```shell
488
curl -L -X GET 'https://member.bilibili.com/x/h5/elec/rank/recent' \
489
-H 'Cookie: SESSDATA=xxx'
490
```
491
492
<details>
493
<summary>查看响应示例：</summary>
494
495
```json
496
{
497
"code": 0,
498
"message": "0",
499
"ttl": 1,
500
"data": {
501
"list": [
502
{
503
"aid": 0,
504
"bvid": "",
505
"elec_num": 50,
506
"title": "",
507
"uname": "",
508
"avatar": "",
509
"ctime": "2020-04-02 03:12:22"
510
},
511
{
512
"aid": 0,
513
"bvid": "",
514
"elec_num": 20,
515
"title": "",
516
"uname": "",
517
"avatar": "",
518
"ctime": "2020-04-02 03:12:00"
519
}
520
],
521
"pager": {
522
"current": 1,
523
"size": 20,
524
"total": 38
525
}
526
}
527
}
528
```
529
530
</details>
@@ -560,9 +560,14 @@ https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
560
560
561
561
`data`对象：
562
562
563
| 字段 | 类型 | 内容 | 备注 |
564
| ---- | ----- | -------- | ---- |
565
| card | obj | 卡片信息 | |
563
| 字段 | 类型 | 内容 | 备注 |
564
| ------------- | ----- | -------------- | ------------------------------------------------------------ |
565
| card | obj | 卡片信息 | |
566
| following | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(Cookie)<br />未登录为false |
567
| archive_count | num | 用户稿件数 | |
568
| article_count | num | 0 | **作用尚不明确** |
569
| follower | num | 粉丝数 | |
570
| like_num | num | 点赞数 | |
566
571
567
572
`data`中的`card`对象：
568
573
@@ -591,10 +596,6 @@ https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
591
596
| official_verify | obj | 认证信息2 | |
592
597
| vip | obj | 大会员状态 | |
593
598
| space | obj | 主页头图 | |
594
| following | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(Cookie) <br />未登录为false |
595
| archive_count | num | 用户稿件数 | |
596
| article_count | num | 0 | **作用尚不明确** |
597
| follower | num | 粉丝数 | |
598
599
599
600
`card`中的`level_info`对象：
600
601
@@ -754,12 +755,13 @@ curl -G 'api.bilibili.com/x/web-interface/card' \
754
755
"space": {
755
756
"s_img": "http://i1.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png",
756
757
"l_img": "http://i1.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png"
757
},
758
"following": true,
759
"archive_count": 37,
760
"article_count": 0,
761
"follower": 969999
762
}
758
}
759
},
760
"following": true,
761
"archive_count": 37,
762
"article_count": 0,
763
"follower": 969999,
764
"like_num": 3547978
763
765
}
764
766
```
765
767
@@ -6,6 +6,7 @@
6
6
- [搜索关注明细](#搜索关注明细)
7
7
- [查询共同关注明细](#查询共同关注明细)
8
8
- [查询悄悄关注明细](#查询悄悄关注明细)
9
- [查询互相关注明细](#查询互相关注明细)
9
10
- [查询黑名单明细](#查询黑名单明细)
10
11
- [操作用户关系](#操作用户关系)
11
12
- [批量操作用户关系](#批量操作用户关系)
@@ -15,7 +16,7 @@
15
16
- [关注分组相关](#关注分组相关)
16
17
- [查询关注分组列表](#查询关注分组列表)
17
18
- [查询关注分组明细](#查询关注分组明细)
18
- [查询目标用户所在的分组](#查询目标用户所在的分组 )
19
- [查询目标用户所在的分组](#查询目标用户所在的分组)
19
20
- [查询所有特别关注的mid](#查询所有特别关注的mid)
20
21
- [创建分组](#创建分组)
21
22
- [重命名分组](#重命名分组)
@@ -1027,6 +1028,166 @@ curl -G 'https://api.bilibili.com/x/relation/whispers' \
1027
1028
1028
1029
</details>
1029
1030
1031
## 查询互相关注明细
1032
1033
<img src="/imgs/relation.svg" width="100" height="100" />
1034
1035
> https://api.bilibili.com/x/relation/friends
1036
1037
*请求方式：GET*
1038
1039
认证方式：Cookie(SESSDATA)或APP
1040
1041
查询与自己互关的用户明细，可看全部
1042
1043
**url参数：**
1044
1045
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
1046
| ---------- | ---- | ------------ | ----------- | -------- |
1047
| access_key | str | APP登录Token | APP方式必要 | |
1048
1049
**json回复：**
1050
1051
根对象：
1052
1053
| 字段 | 类型 | 内容 | 备注 |
1054
| ------- | ---- | -------- | ------------------------------------------------- |
1055
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
1056
| message | str | 错误信息 | 默认为0 |
1057
| ttl | num | 1 | |
1058
| data | obj | 信息本体 | |
1059
1060
data 对象：
1061
1062
| 字段 | 类型 | 内容 | 备注 |
1063
| ---------- | ----- | -------- | ------------ |
1064
| list | array | 明细列表 | |
1065
| re_version | num | ？？？ | 作用尚不明确 |
1066
1067
`data`中的`list`数组：
1068
1069
| 项 | 类型 | 内容 | 备注 |
1070
| ---- | ---- | --------- | ---------------- |
1071
| 0 | obj | 互关1 | |
1072
| n | obj | 互关(n+1) | 按照关注顺序排列 |
1073
| …… | obj | …… | …… |
1074
1075
数组`list`中的对象：
1076
1077
| 字段 | 类型 | 内容 | 备注 |
1078
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
1079
| mid | num | 用户mid | |
1080
| attribute | num | 关注属性 | 6：已互粉 |
1081
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
1082
| tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
1083
| special | num | 特别关注标志 | 0：否<br />1：是 |
1084
| uname | str | 用户昵称 | |
1085
| face | str | 用户头像url | |
1086
| sign | str | 用户签名 | |
1087
| official_verify | obj | 认证信息 | |
1088
| vip | obj | 会员信息 | |
1089
1090
数组`list`中的对象中的`tag`数组：
1091
1092
| 项 | 类型 | 内容 | 备注 |
1093
| ---- | ---- | --------------------- | ---- |
1094
| 0 | num | 位于分组1的分组id | |
1095
| n | num | 位于分组(n+1)的分组id | |
1096
| …… | num | …… | …… |
1097
1098
`list`中的对象中的`official_verify`对象：
1099
1100
| 字段 | 类型 | 内容 | 备注 |
1101
| ---- | ---- | ------------ | ------------------- |
1102
| type | num | 用户认证类型 | -1：无<br />1：认证 |
1103
| desc | str | 用户认证信息 | 无为空 |
1104
1105
`list`中的对象中的`vip`对象：
1106
1107
| 字段 | 类型 | 内容 | 备注 |
1108
| ------------- | ---- | ------------ | ----------------------------------------------- |
1109
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
1110
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
1111
| dueRemark | str | 空 | 作用尚不明确 |
1112
| accessStatus | num | 0 | 作用尚不明确 |
1113
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
1114
| vipStatusWarn | str | 空 | 作用尚不明确 |
1115
| themeType | num | 0 | 作用尚不明确 |
1116
| label | obj | ？？？ | 作用尚不明确 |
1117
1118
`vip`中的`label`对象：
1119
1120
| 字段 | 类型 | 内容 | 备注 |
1121
| ---- | ---- | ---- | ------------ |
1122
| path | str | 空 | 作用尚不明确 |
1123
1124
**示例：**
1125
1126
获取互相关注明细
1127
1128
```shell
1129
curl -G 'https://api.bilibili.com/x/relation/friends' \
1130
-b 'SESSDATA=xxx'
1131
```
1132
1133
<details>
1134
<summary>查看响应示例：</summary>
1135
1136
1137
```json
1138
{
1139
"code": 0,
1140
"message": "0",
1141
"ttl": 1,
1142
"data": {
1143
"list": [
1144
{
1145
"mid": 293793435,
1146
"attribute": 6,
1147
"mtime": 1583817598,
1148
"tag": [-10],
1149
"special": 1,
1150
"uname": "社会易姐QwQ",
1151
"face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
1152
"sign": "BAC项目负责人 | 带砖技术宅 | MC 编程 电子 | 车万众\u0026术术人 | 粉丝群1136462265 博客shakaianee.top",
1153
"face_nft": 0,
1154
"official_verify": {
1155
"type": -1,
1156
"desc": ""
1157
},
1158
"vip": {
1159
"vipType": 2,
1160
"vipDueDate": 1675872000000,
1161
"dueRemark": "",
1162
"accessStatus" :0,
1163
"vipStatus": 1,
1164
"vipStatusWarn": "",
1165
"themeType": 0,
1166
"label": {
1167
"path": "",
1168
"text": "年度大会员",
1169
"label_theme": "annual_vip",
1170
"text_color": "#FFFFFF",
1171
"bg_style": 1,
1172
"bg_color": "#FB7299",
1173
"border_color": ""
1174
},
1175
"avatar_subscript": 1,
1176
"nickname_color": "#FB7299",
1177
"avatar_subscript_url": ""
1178
},
1179
"nft_icon": "",
1180
"rec_reason": "",
1181
"track_id": ""
1182
}
1183
],
1184
"re_version": 0
1185
}
1186
}
1187
```
1188
1189
</details>
1190
1030
1191
## 查询黑名单明细
1031
1192
1032
1193
> https://api.bilibili.com/x/relation/blacks