返回提交历史
Modified
README.md
+2
-1
Modified
comment/action.md
+60
-54
Renamed
comment/list.md
+58
-318
Added
comment/readme.md
+268
-0
Modified
danmaku/action.md
+47
-42
Modified
login/login_info.md
+3
-3
Added
login/login_notice.md
+67
-0
Modified
login/member_center.md
+9
-9
Modified
message/msg.md
+1
-1
Modified
user/relation.md
+456
-86
XFEstudio/bilibili-API-collect
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
8edc21f
代码差异
10 个文件
+971
-514
@@ -44,6 +44,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http`
44
44
- [登录基本信息](login/login_info.md)√
45
45
- [个人中心](login/member_center.md)×
46
46
- [注销登录](login/exit.md)×
47
- [登录记录](login/login_notice.md)√
47
48
- [消息中心](message)
48
49
- [通知类消息](message/msg.md)×
49
50
- [私信](message/private_msg.md)×
@@ -107,7 +108,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http`
107
108
- [风纪委员基本信息](blackroom/jury/base_info.md)√
108
109
- [众裁案件基本信息](blackroom/jury/judgement_info.md)√
109
110
- [裁决操作](blackroom/jury/action.md)√
110
- [评论区](comment)
111
- [评论区](comment)√
111
112
- [评论区明细](comment/comment_list.md)√
112
113
- [操作](comment/action.md)√
113
114
- [表情](emote)
@@ -1,6 +1,6 @@
1
1
# 评论区操作
2
2
3
**本页所有操作均需登录（Cookie）**
3
**本页所有操作均需登录（Cookie或APP）**
4
4
5
5
使用该登录token识别用户身份
6
6
@@ -10,19 +10,20 @@
10
10
11
11
*请求方式：POST*
12
12
13
认证方式：Cookie（SESSDATA）
13
认证方式：Cookie（SESSDATA）或APP
14
14
15
15
**正文参数（ application/x-www-form-urlencoded ）：**
16
16
17
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
18
| ------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
19
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
20
| oid | num | 目标评论区ID | 必要 | |
21
| root | num | 根评论rpID | 非必要 | 二级评论以上使用 |
22
| parent | num | 父评论rpID | 非必要 | 二级评论同根评论ID<br />大于二级评论为要回复的评论ID |
23
| message | str | 发送评论内容 | 必要 | 最大1000字符<br />表情使用表情转义符 |
24
| plat | num | 发送平台标识 | 非必要 | 1：web端<br />2：安卓客户端<br />3：ios客户端<br />4：wp客户端<br />默认为1 |
25
| csrf | str | CSRF Token（位于cookie） | 必要 | |
17
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
18
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
19
| access_key | str | APP登录Token | APP方式必要 | |
20
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
21
| oid | num | 目标评论区ID | 必要 | |
22
| root | num | 根评论rpID | 非必要 | 二级评论以上使用 |
23
| parent | num | 父评论rpID | 非必要 | 二级评论同根评论ID<br />大于二级评论为要回复的评论ID |
24
| message | str | 发送评论内容 | 必要 | 最大1000字符<br />表情使用表情转义符 |
25
| plat | num | 发送平台标识 | 非必要 | 1：web端<br />2：安卓客户端<br />3：ios客户端<br />4：wp客户端<br />默认为1 |
26
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
26
27
27
28
**json回复：**
28
29
@@ -41,7 +42,7 @@
41
42
| -------------- | ----------------------------- | -------------- | ------------------------------------------------------------ |
42
43
| success_action | num | 0 | **作用尚不明确** |
43
44
| success_toast | str | 状态文字 | |
44
| need_captcha | bool | false | 评论需要验证码(未证实) |
45
| need_captcha | bool | false | 评论需要验证码(未证实) |
45
46
| url | str | 空 | **作用尚不明确** |
46
47
| rpid | num | 评论rpID | |
47
48
| rpid_str | str | 评论rpID | 字串格式 |
@@ -51,8 +52,8 @@
51
52
| root_str | str | 根评论rpID | 字串格式 |
52
53
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论ID<br />大于二级评论为上一级评论ID |
53
54
| parent_str | str | 回复父评论rpID | 字串格式 |
54
| emote | obj | 表情转义符信息 | 无表情时无此项<br />**见「[评论区明细](comment_list.md#附表-评论条目对象)」的附表** |
55
| reply | 有效时：obj<br />无效时：null | | **见「[评论区明细](comment_list.md#附表-评论条目对象)」的附表** |
55
| emote | obj | 表情转义符信息 | [对象定义见表](readme.md) |
56
| reply | 有效时：obj<br />无效时：null | | [对象定义见表](readme.md) |
56
57
57
58
**示例：**
58
59
@@ -233,19 +234,20 @@ curl 'http://api.bilibili.com/x/v2/reply/add'\
233
234
234
235
*请求方式：POST*
235
236
236
认证方式：Cookie（SESSDATA）
237
认证方式：Cookie（SESSDATA）或APP
237
238
238
239
点赞成功后会同时消去该评论的点踩
239
240
240
241
**正文参数（ application/x-www-form-urlencoded ）：**
241
242
242
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
243
| ------ | ---- | ------------------------ | ------ | ----------------------------------------------- |
244
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
245
| oid | num | 目标评论区ID | 必要 | |
246
| rpid | num | 目标评论rpID | 必要 | |
247
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消赞<br />1：点赞 |
248
| csrf | str | CSRF Token（位于cookie） | 必要 | |
243
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
244
| ---------- | ---- | ------------------------ | -------------- | ----------------------------------- |
245
| access_key | str | APP登录Token | APP方式必要 | |
246
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
247
| oid | num | 目标评论区ID | 必要 | |
248
| rpid | num | 目标评论rpID | 必要 | |
249
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消赞<br />1：点赞 |
250
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
249
251
250
252
**json回复：**
251
253
@@ -290,19 +292,20 @@ curl 'http://api.bilibili.com/x/v2/reply/action'\
290
292
291
293
*请求方式：POST*
292
294
293
认证方式：Cookie（SESSDATA）
295
认证方式：Cookie（SESSDATA）或APP
294
296
295
297
点踩成功后会同时消去该评论的点赞
296
298
297
299
**正文参数（ application/x-www-form-urlencoded ）：**
298
300
299
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
300
| ------ | ---- | ------------------------ | ------ | ----------------------------------------------- |
301
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
302
| oid | num | 目标评论区ID | 必要 | |
303
| rpid | num | 目标评论rpID | 必要 | |
304
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消踩<br />1：点踩 |
305
| csrf | str | CSRF Token（位于cookie） | 必要 | |
301
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
302
| ---------- | ---- | ------------------------ | -------------- | ----------------------------------- |
303
| access_key | str | APP登录Token | APP方式必要 | |
304
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
305
| oid | num | 目标评论区ID | 必要 | |
306
| rpid | num | 目标评论rpID | 必要 | |
307
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消踩<br />1：点踩 |
308
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
306
309
307
310
**json回复：**
308
311
@@ -347,18 +350,19 @@ curl 'http://api.bilibili.com/x/v2/reply/hate'\
347
350
348
351
*请求方式：POST*
349
352
350
认证方式：Cookie（SESSDATA）
353
认证方式：Cookie（SESSDATA）或APP
351
354
352
355
只能删除自己的评论，或自己管理的评论区下的评论
353
356
354
357
**正文参数（ application/x-www-form-urlencoded ）：**
355
358
356
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
357
| ------ | ---- | ------------------------ | ------ | ----------------------------------------------- |
358
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
359
| oid | num | 目标评论区ID | 必要 | |
360
| rpid | num | 目标评论rpID | 必要 | |
361
| csrf | str | CSRF Token（位于cookie） | 必要 | |
359
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
360
| ---------- | ---- | ------------------------ | -------------- | ----------------------------- |
361
| access_key | str | APP登录Token | APP方式必要 | |
362
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
363
| oid | num | 目标评论区ID | 必要 | |
364
| rpid | num | 目标评论rpID | 必要 | |
365
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
362
366
363
367
**json回复：**
364
368
@@ -402,19 +406,20 @@ curl 'http://api.bilibili.com/x/v2/reply/del'\
402
406
403
407
*请求方式：POST*
404
408
405
认证方式：Cookie（SESSDATA）
409
认证方式：Cookie（SESSDATA）或APP
406
410
407
411
只能置顶自己管理的评论区中的一级评论
408
412
409
413
**正文参数（ application/x-www-form-urlencoded ）：**
410
414
411
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
412
| ------ | ---- | ------------------------ | ------ | ----------------------------------------------- |
413
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
414
| oid | num | 目标评论区ID | 必要 | |
415
| rpid | num | 目标评论rpID | 必要 | |
416
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消置顶<br />1：设为置顶 |
417
| csrf | str | CSRF Token（位于cookie） | 必要 | |
415
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
416
| ---------- | ---- | ------------------------ | -------------- | ----------------------------------------- |
417
| access_key | str | APP登录Token | APP方式必要 | |
418
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
419
| oid | num | 目标评论区ID | 必要 | |
420
| rpid | num | 目标评论rpID | 必要 | |
421
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消置顶<br />1：设为置顶 |
422
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
418
423
419
424
**json回复：**
420
425
@@ -459,18 +464,19 @@ curl 'http://api.bilibili.com/x/v2/reply/top'\
459
464
460
465
*请求方式：POST*
461
466
462
认证方式：Cookie（SESSDATA）
467
认证方式：Cookie（SESSDATA）或APP
463
468
464
469
**正文参数（ application/x-www-form-urlencoded ）：**
465
470
466
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
467
| ------- | ---- | ------------------------ | ------ | ----------------------------------------------- |
468
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
469
| oid | num | 目标评论区ID | 必要 | |
470
| rpid | num | 目标评论rpID | 必要 | |
471
| reason | num | 举报类型 | 必要 | **类型代码见下表** |
472
| content | str | 其他举报备注 | 非必要 | `reason=0`时有效 |
473
| csrf | str | CSRF Token（位于cookie） | 必要 | |
471
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
472
| ---------- | ---- | ------------------------ | -------------- | ----------------------------- |
473
| access_key | str | APP登录Token | APP方式必要 | |
474
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
475
| oid | num | 目标评论区ID | 必要 | |
476
| rpid | num | 目标评论rpID | 必要 | |
477
| reason | num | 举报类型 | 必要 | **类型代码见下表** |
478
| content | str | 其他举报备注 | 非必要 | `reason=0`时有效 |
479
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
474
480
475
481
举报类型`reason`：
476
482
@@ -1,52 +1,24 @@
1
# 点评评论区明细
2
3
<img src="/imgs/comment.svg" width="100" height="100"/>
4
5
**已知的评论区类型代码总览：**
6
7
| 代码 | 评论区类型 | oid的意义 |
8
| ---- | ----------------------- | ---------- |
9
| 1 | 视频稿件 | 视频avID |
10
| 2 | 话题 | 话题ID |
11
| 4 | 活动 | 活动ID |
12
| 5 | 小视频 | 小视频ID |
13
| 6 | 小黑屋封禁信息 | 封禁公示ID |
14
| 7 | 公告信息 | 公告ID |
15
| 8 | 直播活动 | 直播间ID |
16
| 9 | 活动稿件 | |
17
| 10 | 直播公告 | |
18
| 11 | 相簿（图片动态） | 相簿ID |
19
| 12 | 专栏 | 专栏cvID |
20
| 13 | 票务 | |
21
| 14 | 音频 | 音频auID |
22
| 15 | 风纪委员会 | 众裁项目ID |
23
| 16 | 点评 | |
24
| 17 | 动态（纯文字动态&分享） | 动态ID |
25
| 18 | 播单 | |
26
| 19 | 音乐播单 | |
27
| 20 | 漫画 | |
28
| 21 | 漫画 | |
29
| 22 | 漫画 | 漫画mcID |
30
| 33 | 课程 | 课程epID |
31
32
## 获取评论区明细1(web端)（无楼层号）
1
# 评论区明细
2
3
## 获取评论区明细1（无楼层号）
33
4
34
5
> http://api.bilibili.com/x/v2/reply
35
6
36
7
*请求方式：GET*
37
8
38
认证方式：Cookie（SESSDATA）
9
认证方式：Cookie（SESSDATA）或APP
39
10
40
11
**url参数：**
41
12
42
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
43
| ------ | ---- | -------------- | ------ | -------------------------------------------------------- |
44
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
45
| oid | num | 目标评论区ID | 必要 | |
46
| sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1：按点赞数<br />2：按回复数 |
47
| nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 |
48
| pn | num | 页码 | 非必要 | 默认为1 |
49
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
| ---------- | ---- | -------------- | ----------- | -------------------------------------------------------- |
15
| access_key | str | APP登录Token | APP方式必要 | |
16
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
17
| oid | num | 目标评论区ID | 必要 | |
18
| sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1：按点赞数<br />2：按回复数 |
19
| nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 |
20
| pn | num | 页码 | 非必要 | 默认为1 |
21
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
50
22
51
23
**json回复：**
52
24
@@ -2347,25 +2319,24 @@ curl -G 'http://api.bilibili.com/x/v2/reply'\
2347
2319
2348
2320
</details>
2349
2321
2350
2351
2352
## 获取评论区明细2(APP端)（带有楼层号 ）
2322
## 获取评论区明细2（带有楼层号 ）
2353
2323
2354
2324
> http://api.bilibili.com/x/v2/reply/main
2355
2325
2356
2326
*请求方式：GET*
2357
2327
2358
认证方式：Cookie（SESSDATA）
2328
认证方式：Cookie（SESSDATA）或APP
2359
2329
2360
2330
**url参数：**
2361
2331
2362
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2363
| ------ | ---- | -------------- | ------ | ------------------------------------------------------------ |
2364
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
2365
| oid | num | 目标评论区ID | 必要 | |
2366
| mode | num | 排序方式 | 非必要 | 默认为0<br />0 3：仅按热度<br />1：按热度+按时间<br />2：仅按时间 |
2367
| next | num | 评论页选择 | 非必要 | 按热度时：热度顺序页码（0为第一页）<br />按时间时：时间倒序楼层号<br />默认为0 |
2368
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
2332
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2333
| ---------- | ---- | -------------- | ----------- | ------------------------------------------------------------ |
2334
| access_key | str | APP登录Token | APP方式必要 | |
2335
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
2336
| oid | num | 目标评论区ID | 必要 | |
2337
| mode | num | 排序方式 | 非必要 | 默认为0<br />0 3：仅按热度<br />1：按热度+按时间<br />2：仅按时间 |
2338
| next | num | 评论页选择 | 非必要 | 按热度时：热度顺序页码（0为第一页）<br />按时间时：时间倒序楼层号<br />默认为0 |
2339
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
2369
2340
2370
2341
**json回复：**
2371
2342
@@ -4728,27 +4699,26 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main'\
4728
4699
4729
4700
</details>
4730
4701
4731
4732
4733
## 获取指定评论条目及二级回复明细1（web端）（分离结构 无楼层号）
4702
## 获取指定评论条目及二级回复明细1（分离结构 无楼层号）
4734
4703
4735
4704
> http://api.bilibili.com/x/v2/reply/reply
4736
4705
4737
4706
*请求方式：GET*
4738
4707
4739
认证方式：Cookie（SESSDATA）
4708
认证方式：Cookie（SESSDATA）或APP
4740
4709
4741
4710
按照热度排列
4742
4711
4743
4712
**url参数：**
4744
4713
4745
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
4746
| ------ | ---- | ---------------- | ------ | -------------------------- |
4747
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
4748
| oid | num | 目标评论区ID | 必要 | |
4749
| root | num | 目标一级评论rpID | 必要 | |
4750
| pn | num | 二级评论页码 | 非必要 | 默认为1 |
4751
| ps | num | 二级评论每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
4714
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
4715
| ---------- | ---- | ---------------- | ----------- | ----------------------------- |
4716
| access_key | str | APP登录Token | APP方式必要 | |
4717
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
4718
| oid | num | 目标评论区ID | 必要 | |
4719
| root | num | 目标一级评论rpID | 必要 | |
4720
| pn | num | 二级评论页码 | 非必要 | 默认为1 |
4721
| ps | num | 二级评论每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
4752
4722
4753
4723
**json回复：**
4754
4724
@@ -5467,25 +5437,26 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply'\
5467
5437
5468
5438
5469
5439
5470
## 获取指定评论条目及二级回复明细2（APP端）（嵌套结构 带有楼层号）
5440
## 获取指定评论条目及二级回复明细2（嵌套结构 带有楼层号）
5471
5441
5472
5442
> http://api.bilibili.com/x/v2/reply/detail
5473
5443
5474
5444
*请求方式：GET*
5475
5445
5476
认证方式：Cookie（SESSDATA）
5446
认证方式：Cookie（SESSDATA）或APP
5477
5447
5478
5448
按照楼层排列
5479
5449
5480
5450
**url参数：**
5481
5451
5482
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
5483
| ------ | ---- | -------------- | ------ | -------------------------------------- |
5484
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
5485
| oid | num | 目标评论区ID | 必要 | |
5486
| root | num | 根回复rpID | 必要 | |
5487
| next | num | 评论页选择 | 非必要 | 第一页为0<br />默认为0<br />顺序楼层号 |
5488
| ps | num | 每页项数 | 非必要 | 默认为0 |
5452
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
5453
| ---------- | ---- | -------------- | ----------- | -------------------------------------- |
5454
| access_key | str | APP登录Token | APP方式必要 | |
5455
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
5456
| oid | num | 目标评论区ID | 必要 | |
5457
| root | num | 根回复rpID | 必要 | |
5458
| next | num | 评论页选择 | 非必要 | 第一页为0<br />默认为0<br />顺序楼层号 |
5459
| ps | num | 每页项数 | 非必要 | 默认为0 |
5489
5460
5490
5461
**json回复：**
5491
5462
@@ -6223,25 +6194,26 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail'\
6223
6194
6224
6195
</details>
6225
6196
6226
## 获取指定评论对话树（APP端）（带有楼层）
6197
## 获取指定评论对话树（带有楼层）
6227
6198
6228
6199
> http://api.bilibili.com/x/v2/reply/dialog/cursor
6229
6200
6230
6201
*请求方式：GET*
6231
6202
6232
认证方式：Cookie（SESSDATA）
6203
认证方式：Cookie（SESSDATA）或APP
6233
6204
6234
6205
按照楼层排列
6235
6206
6236
6207
**url参数：**
6237
6208
6238
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
6239
| ------ | ---- | -------------- | ------ | ------------------ |
6240
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
6241
| oid | num | 目标评论区ID | 必要 | |
6242
| root | num | 根回复rpID | 必要 | |
6243
| dialog | num | 对话树根rpID | 必要 | |
6244
| size | num | 每页最大项数 | 必要 | |
6209
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
6210
| ---------- | ---- | -------------- | ----------- | ----------------------------- |
6211
| access_key | str | APP登录Token | APP方式必要 | |
6212
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
6213
| oid | num | 目标评论区ID | 必要 | |
6214
| root | num | 根回复rpID | 必要 | |
6215
| dialog | num | 对话树根rpID | 必要 | |
6216
| size | num | 每页最大项数 | 必要 | |
6245
6217
6246
6218
**json回复：**
6247
6219
@@ -7095,7 +7067,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor'\
7095
7067
7096
7068
</details>
7097
7069
7098
## 获取评论区评论总数（APP端）
7070
## 获取评论区评论总数
7099
7071
7100
7072
> http://api.bilibili.com/x/v2/reply/count
7101
7073
@@ -7103,10 +7075,10 @@ curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor'\
7103
7075
7104
7076
**url参数：**
7105
7077
7106
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
7107
| ------ | ---- | -------------- | ------ | ------------------ |
7108
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
7109
| oid | num | 目标评论区ID | 必要 | |
7078
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
7079
| ------ | ---- | -------------- | ------ | ----------------------------- |
7080
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
7081
| oid | num | 目标评论区ID | 必要 | |
7110
7082
7111
7083
**json回复：**
7112
7084
@@ -7152,235 +7124,3 @@ curl -G 'http://api.bilibili.com/x/v2/reply/count'\
7152
7124
</details>
7153
7125
7154
7126
7155
## 附表-评论条目对象
7156
7157
| 字段 | 类型 | 内容 | 备注 |
7158
| ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ |
7159
| rpid | num | 评论rpID | |
7160
| oid | num | 目标评论区rpID | |
7161
| type | num | 评论区类型代码 | **类型代码见上表** |
7162
| mid | num | 评论发送者UID | |
7163
| root | num | 根评论rpID | 若为一级评论则为0<br />大于一级评论则为根评论ID |
7164
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论rpID<br />大于二级评论为上一级评论rpID |
7165
| dialog | num | 回复对方rpID | 若为一级评论则为0<br />若为二级评论则为该评论rpID<br />大于二级评论为上一级评论rpID |
7166
| count | num | 评论回复条数 | |
7167
| rcount | num | 评论回复条数 | |
7168
| floor | num | 评论楼层号 | **重要：若不支持楼层则无此项** |
7169
| state | num | 0 | **作用尚不明确** |
7170
| fansgrade | num | 是否具有粉丝标签 | 0：无<br />1：有 |
7171
| attr | num | ？？？ | **作用尚不明确** |
7172
| ctime | num | 评论发送时间 | 时间戳 |
7173
| rpid_str | str | 评论rpID | 字串格式 |
7174
| root_str | str | 根评论rpID | 字串格式 |
7175
| parent_str | str | 回复父评论rpID | 字串格式 |
7176
| like | num | 评论获赞数 | |
7177
| action | num | 当前用户操作状态 | 需要登录(SESSDATA) <br />否则恒为0<br />0：无<br />1：已点赞<br />2：已点踩 |
7178
| member | obj | 评论发送者信息 | |
7179
| content | obj | 评论信息 | |
7180
| replies | 无效时：null<br />有效时：array | 评论回复条目预览 | **仅嵌套一层**<br />否则为null |
7181
| assist | num | | **作用尚不明确** |
7182
| folder | obj | ？？？ | |
7183
| up_action | obj | 评论UP主操作信息 | |
7184
| show_follow | bool | false | **作用尚不明确** |
7185
7186
`评论条目`中的`member`对象：
7187
7188
| 字段 | 类型 | 内容 | 备注 |
7189
| --------------- | ----------------------------- | ---------------------- | ------------------------------------------------------------ |
7190
| mid | str | 发送者UID | |
7191
| uname | str | 发送者昵称 | |
7192
| sex | str | 发送者性别 | 男 女 保密 |
7193
| sign | str | 发送者签名 | |
7194
| avatar | str | 发送者头像 | |
7195
| rank | str | 10000 | **作用尚不明确** |
7196
| DisplayRank | str | 0 | **作用尚不明确** |
7197
| level_info | obj | 发送者等级 | |
7198
| pendant | obj | 发送者头像框信息 | |
7199
| nameplate | obj | 发送者勋章信息 | |
7200
| official_verify | obj | 发送者认证信息 | |
7201
| vip | obj | 发送者会员信息 | |
7202
| fans_detail | 无效时：null<br />有效时：obj | 发送者粉丝标签 | |
7203
| following | num | 是否关注该用户 | 需要登录(SESSDATA) <br />否则恒为0<br />0：未关注<br />1：已关注 |
7204
| is_followed | num | 是否被该用户关注 | 需要登录(SESSDATA) <br />否则恒为0<br />0：未关注<br />1：已关注 |
7205
| user_sailing | obj | 发送者评论条目装扮信息 | |
7206
7207
`member`中的`level_info`对象：
7208
7209
| 字段 | 类型 | 内容 | 备注 |
7210
| ------------- | ---- | -------- | ---------------- |
7211
| current_level | num | 用户等级 | |
7212
| current_min | num | 0 | **作用尚不明确** |
7213
| current_exp | num | 0 | **作用尚不明确** |
7214
| next_exp | num | 0 | **作用尚不明确** |
7215
7216
`member`中的`pendant`对象：
7217
7218
| 字段 | 类型 | 内容 | 备注 |
7219
| ------------- | ---- | ------------- | -------------------- |
7220
| pid | num | 头像框id | **详细说明有待补充** |
7221
| name | str | 头像框名称 | |
7222
| image | str | 头像框图片url | |
7223
| expire | num | 0 | **作用尚不明确** |
7224
| image_enhance | str | 头像框图片url | |
7225
7226
`member`中的`nameplate`对象：
7227
7228
| 字段 | 类型 | 内容 | 备注 |
7229
| ----------- | ---- | ---------------- | -------------------- |
7230
| nid | num | 勋章id | **详细说明有待补充** |
7231
| name | str | 勋章名称 | |
7232
| image | str | 挂件图片url 正常 | |
7233
| image_small | str | 勋章图片url 小 | |
7234
| level | str | 勋章等级 | |
7235
| condition | str | 勋章条件 | |
7236
7237
`member`中的`official_verify`对象：
7238
7239
| 字段 | 类型 | 内容 | 备注 |
7240
| ---- | ---- | -------- | ------------------- |
7241
| type | num | 是否认证 | -1：无<br />0：认证 |
7242
| desc | str | 认证信息 | 无为空 |
7243
7244
`member`中的`vip`对象：
7245
7246
| 字段 | 类型 | 内容 | 备注 |
7247
| ------------- | ---- | -------------- | ----------------------------------- |
7248
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
7249
| vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 |
7250
| dueRemark | str | 空 | **作用尚不明确** |
7251
| accessStatus | num | 0 | **作用尚不明确** |
7252
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
7253
| vipStatusWarn | str | 空 | **作用尚不明确** |
7254
| theme_type | num | 0 | **作用尚不明确** |
7255
| label | obj | ？？？ | |
7256
7257
`vip`中的`label`对象:
7258
7259
| 字段 | 类型 | 内容 | 备注 |
7260
| ----------- | ---- | ------------ | ---------------- |
7261
| path | str | 空 | **作用尚不明确** |
7262
| text | str | 会员类型信息 | |
7263
| label_theme | str | 会员类型 | |
7264
7265
`member`中的`fans_detail`对象:
7266
7267
| 字段 | 类型 | 内容 | 备注 |
7268
| ------------- | ---- | ------------ | -------------------- |
7269
| uid | num | 用户UID | |
7270
| medal_id | num | 粉丝标签ID | **详细说明有待补充** |
7271
| medal_name | str | 粉丝标签名 | |
7272
| score | num | 0 | **作用尚不明确** |
7273
| level | num | 当前标签等级 | |
7274
| intimacy | num | 0 | **作用尚不明确** |
7275
| master_status | num | 1 | **作用尚不明确** |
7276
| is_receive | num | 1 | **作用尚不明确** |
7277
7278
`member`中的`user_sailing`对象：
7279
7280
| 字段 | 类型 | 内容 | 备注 |
7281
| ----------------- | ----------------------------- | ------------ | ---------------- |
7282
| pendant | 无效时：null<br />有效时：obj | 头像框信息 | |
7283
| cardbg | 无效时：null<br />有效时：obj | 评论条目装扮 | |
7284
| cardbg_with_focus | null | - | **作用尚不明确** |
7285
7286
`user_sailing`中的`pendant`对象：
7287
7288
| 字段 | 类型 | 内容 | 备注 |
7289
| -------- | ---- | ------------- | ------------------------------------- |
7290
| id | num | 头像框ID | |
7291
| name | str | 头像框名称 | |
7292
| image | str | 头像框图片url | |
7293
| jump_url | str | 空 | |
7294
| type | str | 装扮类型 | suit：一般装扮<br />vip_suit：vip装扮 |
7295
7296
`user_sailing`中的`cardbg`对象：
7297
7298
| 字段 | 类型 | 内容 | 备注 |
7299
| -------- | ---- | ----------------------- | ------------------------------------- |
7300
| id | num | 评论条目装扮ID | |
7301
| name | str | 评论条目装扮名称 | |
7302
| image | str | 评论条目装扮图片url | |
7303
| jump_url | str | 评论条目装扮商城页面url | |
7304
| fan | obj | 粉丝专属信息 | |
7305
| type | str | 装扮类型 | suit：一般装扮<br />vip_suit：vip装扮 |
7306
7307
`cardbg`中的`fan`对象：
7308
7309
| 字段 | 类型 | 内容 | 备注 |
7310
| -------- | ---- | ------------------ | ---------------- |
7311
| is_fan | num | 是否为粉丝专属装扮 | 0：否<br />1：是 |
7312
| number | num | 粉丝专属编号 | |
7313
| color | str | 数字颜色 | 颜色码 |
7314
| name | str | 装扮名称 | |
7315
| num_desc | str | 粉丝专属编号 | 字串格式 |
7316
7317
`评论条目`中的`content`对象：
7318
7319
| 字段 | 类型 | 内容 | 备注 |
7320
| -------- | ----- | -------------------- | ------------------------------------------------------------ |
7321
| message | str | 评论内容 | **重要** |
7322
| plat | num | 评论发送平台 | 1：web端<br />2：安卓客户端<br />3：ios客户端<br />4：wp客户端 |
7323
| device | str | 评论发送平台设备 | |
7324
| members | array | 评论中at到的用户信息 | |
7325
| emote | obj | 表情转义符信息 | 评论内容无表情则无此项 |
7326
| jump_url | obj | 空 | **作用尚不明确** |
7327
| max_line | num | 6 | **作用尚不明确** |
7328
7329
`content`中的`members`数组：
7330
7331
| 项 | 类型 | 内容 | 备注 |
7332
| ---- | ---- | --------------- | -------------------------------- |
7333
| 0 | obj | at到的用户1 | 基本同`评论条目`中的`member`对象 |
7334
| n | obj | at到的用户(n+1) | 项数为at到的不同的用户数 |
7335
| …… | obj | …… | …… |
7336
7337
`content`中的`emote`对象：
7338
7339
| 字段 | 类型 | 内容 | 备注 |
7340
| ------------ | ---- | --------------- | -------- |
7341
| {表情转义符} | obj | 表情转义符信息1 | |
7342
| …… | obj | 表情转义符信息n | 向下扩展 |
7343
7344
`emote`中的`{表情转义符}`对象：
7345
7346
| 字段 | 类型 | 内容 | 备注 |
7347
| ---------- | ---- | ------------ | -------------------------------------------------------- |
7348
| id | num | 表情ID | |
7349
| package_id | num | 表情包ID | |
7350
| state | num | 0 | |
7351
| type | num | 表情类型 | 1：免费<br />2：会员专属<br />3：购买所得<br />4：颜文字 |
7352
| attr | num | 0 | **作用尚不明确** |
7353
| text | str | 表情转义符 | |
7354
| url | str | 表情图片url | |
7355
| meta | obj | 属性信息 | |
7356
| mtime | num | 表情创建时间 | 时间戳 |
7357
7358
`{表情转义符}`中的`meta`对象：
7359
7360
| 字段 | 类型 | 内容 | 备注 |
7361
| ----- | ---- | ------------ | ---------------- |
7362
| size | num | 表情尺寸信息 | 1：小<br />2：大 |
7363
| alias | str | 简写名 | 无则无此项 |
7364
7365
`评论条目`中的`replies`数组：
7366
7367
| 项 | 类型 | 内容 | 备注 |
7368
| ---- | ---- | --------- | ------------------------------------------------------------ |
7369
| 0 | obj | 回复条目1 | **为本对象的递归嵌套**<br />**仅嵌套一层**<br />按照热度顺序排列 |
7370
| 1 | obj | 回复条目2 | |
7371
| 2 | obj | 回复条目3 | 最后一项 |
7372
7373
`评论条目`中的`folder`对象：
7374
7375
| 字段 | 类型 | 内容 | 备注 |
7376
| ---------- | ---- | ------ | ---------------- |
7377
| has_folded | bool | false | **作用尚不明确** |
7378
| is_folded | bool | false | **作用尚不明确** |
7379
| rule | str | ？？？ | **作用尚不明确** |
7380
7381
`评论条目`中的`up_action`对象：
7382
7383
| 字段 | 类型 | 内容 | 备注 |
7384
| ----- | ---- | ---------------- | ----------------------- |
7385
| like | bool | 是否UP主觉得很赞 | false：否<br />true：是 |
7386
| reply | bool | 是否被UP主回复 | false：否<br />true：是 |
@@ -0,0 +1,268 @@
1
# 评论区
2
3
<img src="/imgs/comment.svg" width="100" height="100"/>
4
5
评论区接口分为**查询**与**操作**两大类
6
7
- [查询类](list.md)
8
- [操作类](action.md)
9
10
## 已知的评论区类型代码总览
11
12
| 代码 | 评论区类型 | oid的意义 |
13
| ---- | ----------------------- | ---------- |
14
| 1 | 视频稿件 | 视频avID |
15
| 2 | 话题 | 话题ID |
16
| 4 | 活动 | 活动ID |
17
| 5 | 小视频 | 小视频ID |
18
| 6 | 小黑屋封禁信息 | 封禁公示ID |
19
| 7 | 公告信息 | 公告ID |
20
| 8 | 直播活动 | 直播间ID |
21
| 9 | 活动稿件 | |
22
| 10 | 直播公告 | |
23
| 11 | 相簿（图片动态） | 相簿ID |
24
| 12 | 专栏 | 专栏cvID |
25
| 13 | 票务 | |
26
| 14 | 音频 | 音频auID |
27
| 15 | 风纪委员会 | 众裁项目ID |
28
| 16 | 点评 | |
29
| 17 | 动态（纯文字动态&分享） | 动态ID |
30
| 18 | 播单 | |
31
| 19 | 音乐播单 | |
32
| 20 | 漫画 | |
33
| 21 | 漫画 | |
34
| 22 | 漫画 | 漫画mcID |
35
| 33 | 课程 | 课程epID |
36
37
## 评论条目对象
38
39
| 字段 | 类型 | 内容 | 备注 |
40
| ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ |
41
| rpid | num | 评论rpID | |
42
| oid | num | 目标评论区rpID | |
43
| type | num | 评论区类型代码 | **类型代码见上表** |
44
| mid | num | 评论发送者UID | |
45
| root | num | 根评论rpID | 若为一级评论则为0<br />大于一级评论则为根评论ID |
46
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论rpID<br />大于二级评论为上一级评论rpID |
47
| dialog | num | 回复对方rpID | 若为一级评论则为0<br />若为二级评论则为该评论rpID<br />大于二级评论为上一级评论rpID |
48
| count | num | 评论回复条数 | |
49
| rcount | num | 评论回复条数 | |
50
| floor | num | 评论楼层号 | **重要：若不支持楼层则无此项** |
51
| state | num | 0 | **作用尚不明确** |
52
| fansgrade | num | 是否具有粉丝标签 | 0：无<br />1：有 |
53
| attr | num | ？？？ | **作用尚不明确** |
54
| ctime | num | 评论发送时间 | 时间戳 |
55
| rpid_str | str | 评论rpID | 字串格式 |
56
| root_str | str | 根评论rpID | 字串格式 |
57
| parent_str | str | 回复父评论rpID | 字串格式 |
58
| like | num | 评论获赞数 | |
59
| action | num | 当前用户操作状态 | 需要登录(SESSDATA) <br />否则恒为0<br />0：无<br />1：已点赞<br />2：已点踩 |
60
| member | obj | 评论发送者信息 | |
61
| content | obj | 评论信息 | |
62
| replies | 无效时：null<br />有效时：array | 评论回复条目预览 | **仅嵌套一层**<br />否则为null |
63
| assist | num | | **作用尚不明确** |
64
| folder | obj | ？？？ | |
65
| up_action | obj | 评论UP主操作信息 | |
66
| show_follow | bool | false | **作用尚不明确** |
67
68
`评论条目`中的`member`对象：
69
70
| 字段 | 类型 | 内容 | 备注 |
71
| --------------- | ----------------------------- | ---------------------- | ------------------------------------------------------------ |
72
| mid | str | 发送者UID | |
73
| uname | str | 发送者昵称 | |
74
| sex | str | 发送者性别 | 男 女 保密 |
75
| sign | str | 发送者签名 | |
76
| avatar | str | 发送者头像 | |
77
| rank | str | 10000 | **作用尚不明确** |
78
| DisplayRank | str | 0 | **作用尚不明确** |
79
| level_info | obj | 发送者等级 | |
80
| pendant | obj | 发送者头像框信息 | |
81
| nameplate | obj | 发送者勋章信息 | |
82
| official_verify | obj | 发送者认证信息 | |
83
| vip | obj | 发送者会员信息 | |
84
| fans_detail | 无效时：null<br />有效时：obj | 发送者粉丝标签 | |
85
| following | num | 是否关注该用户 | 需要登录(SESSDATA) <br />否则恒为0<br />0：未关注<br />1：已关注 |
86
| is_followed | num | 是否被该用户关注 | 需要登录(SESSDATA) <br />否则恒为0<br />0：未关注<br />1：已关注 |
87
| user_sailing | obj | 发送者评论条目装扮信息 | |
88
89
`member`中的`level_info`对象：
90
91
| 字段 | 类型 | 内容 | 备注 |
92
| ------------- | ---- | -------- | ---------------- |
93
| current_level | num | 用户等级 | |
94
| current_min | num | 0 | **作用尚不明确** |
95
| current_exp | num | 0 | **作用尚不明确** |
96
| next_exp | num | 0 | **作用尚不明确** |
97
98
`member`中的`pendant`对象：
99
100
| 字段 | 类型 | 内容 | 备注 |
101
| ------------- | ---- | ------------- | -------------------- |
102
| pid | num | 头像框id | **详细说明有待补充** |
103
| name | str | 头像框名称 | |
104
| image | str | 头像框图片url | |
105
| expire | num | 0 | **作用尚不明确** |
106
| image_enhance | str | 头像框图片url | |
107
108
`member`中的`nameplate`对象：
109
110
| 字段 | 类型 | 内容 | 备注 |
111
| ----------- | ---- | ---------------- | -------------------- |
112
| nid | num | 勋章id | **详细说明有待补充** |
113
| name | str | 勋章名称 | |
114
| image | str | 挂件图片url 正常 | |
115
| image_small | str | 勋章图片url 小 | |
116
| level | str | 勋章等级 | |
117
| condition | str | 勋章条件 | |
118
119
`member`中的`official_verify`对象：
120
121
| 字段 | 类型 | 内容 | 备注 |
122
| ---- | ---- | -------- | ------------------- |
123
| type | num | 是否认证 | -1：无<br />0：认证 |
124
| desc | str | 认证信息 | 无为空 |
125
126
`member`中的`vip`对象：
127
128
| 字段 | 类型 | 内容 | 备注 |
129
| ------------- | ---- | -------------- | ----------------------------------- |
130
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
131
| vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 |
132
| dueRemark | str | 空 | **作用尚不明确** |
133
| accessStatus | num | 0 | **作用尚不明确** |
134
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
135
| vipStatusWarn | str | 空 | **作用尚不明确** |
136
| theme_type | num | 0 | **作用尚不明确** |
137
| label | obj | ？？？ | |
138
139
`vip`中的`label`对象:
140
141
| 字段 | 类型 | 内容 | 备注 |
142
| ----------- | ---- | ------------ | ---------------- |
143
| path | str | 空 | **作用尚不明确** |
144
| text | str | 会员类型信息 | |
145
| label_theme | str | 会员类型 | |
146
147
`member`中的`fans_detail`对象:
148
149
| 字段 | 类型 | 内容 | 备注 |
150
| ------------- | ---- | ------------ | -------------------- |
151
| uid | num | 用户UID | |
152
| medal_id | num | 粉丝标签ID | **详细说明有待补充** |
153
| medal_name | str | 粉丝标签名 | |
154
| score | num | 0 | **作用尚不明确** |
155
| level | num | 当前标签等级 | |
156
| intimacy | num | 0 | **作用尚不明确** |
157
| master_status | num | 1 | **作用尚不明确** |
158
| is_receive | num | 1 | **作用尚不明确** |
159
160
`member`中的`user_sailing`对象：
161
162
| 字段 | 类型 | 内容 | 备注 |
163
| ----------------- | ----------------------------- | ------------ | ---------------- |
164
| pendant | 无效时：null<br />有效时：obj | 头像框信息 | |
165
| cardbg | 无效时：null<br />有效时：obj | 评论条目装扮 | |
166
| cardbg_with_focus | null | - | **作用尚不明确** |
167
168
`user_sailing`中的`pendant`对象：
169
170
| 字段 | 类型 | 内容 | 备注 |
171
| -------- | ---- | ------------- | ------------------------------------- |
172
| id | num | 头像框ID | |
173
| name | str | 头像框名称 | |
174
| image | str | 头像框图片url | |
175
| jump_url | str | 空 | |
176
| type | str | 装扮类型 | suit：一般装扮<br />vip_suit：vip装扮 |
177
178
`user_sailing`中的`cardbg`对象：
179
180
| 字段 | 类型 | 内容 | 备注 |
181
| -------- | ---- | ----------------------- | ------------------------------------- |
182
| id | num | 评论条目装扮ID | |
183
| name | str | 评论条目装扮名称 | |
184
| image | str | 评论条目装扮图片url | |
185
| jump_url | str | 评论条目装扮商城页面url | |
186
| fan | obj | 粉丝专属信息 | |
187
| type | str | 装扮类型 | suit：一般装扮<br />vip_suit：vip装扮 |
188
189
`cardbg`中的`fan`对象：
190
191
| 字段 | 类型 | 内容 | 备注 |
192
| -------- | ---- | ------------------ | ---------------- |
193
| is_fan | num | 是否为粉丝专属装扮 | 0：否<br />1：是 |
194
| number | num | 粉丝专属编号 | |
195
| color | str | 数字颜色 | 颜色码 |
196
| name | str | 装扮名称 | |
197
| num_desc | str | 粉丝专属编号 | 字串格式 |
198
199
`评论条目`中的`content`对象：
200
201
| 字段 | 类型 | 内容 | 备注 |
202
| -------- | ----- | -------------------- | ------------------------------------------------------------ |
203
| message | str | 评论内容 | **重要** |
204
| plat | num | 评论发送平台 | 1：web端<br />2：安卓客户端<br />3：ios客户端<br />4：wp客户端 |
205
| device | str | 评论发送平台设备 | |
206
| members | array | 评论中at到的用户信息 | |
207
| emote | obj | 表情转义符信息 | 评论内容无表情则无此项 |
208
| jump_url | obj | 空 | **作用尚不明确** |
209
| max_line | num | 6 | **作用尚不明确** |
210
211
`content`中的`members`数组：
212
213
| 项 | 类型 | 内容 | 备注 |
214
| ---- | ---- | --------------- | -------------------------------- |
215
| 0 | obj | at到的用户1 | 基本同`评论条目`中的`member`对象 |
216
| n | obj | at到的用户(n+1) | 项数为at到的不同的用户数 |
217
| …… | obj | …… | …… |
218
219
`content`中的`emote`对象：
220
221
| 字段 | 类型 | 内容 | 备注 |
222
| ------------ | ---- | --------------- | -------- |
223
| {表情转义符} | obj | 表情转义符信息1 | |
224
| …… | obj | 表情转义符信息n | 向下扩展 |
225
226
`emote`中的`{表情转义符}`对象：
227
228
| 字段 | 类型 | 内容 | 备注 |
229
| ---------- | ---- | ------------ | -------------------------------------------------------- |
230
| id | num | 表情ID | |
231
| package_id | num | 表情包ID | |
232
| state | num | 0 | |
233
| type | num | 表情类型 | 1：免费<br />2：会员专属<br />3：购买所得<br />4：颜文字 |
234
| attr | num | 0 | **作用尚不明确** |
235
| text | str | 表情转义符 | |
236
| url | str | 表情图片url | |
237
| meta | obj | 属性信息 | |
238
| mtime | num | 表情创建时间 | 时间戳 |
239
240
`{表情转义符}`中的`meta`对象：
241
242
| 字段 | 类型 | 内容 | 备注 |
243
| ----- | ---- | ------------ | ---------------- |
244
| size | num | 表情尺寸信息 | 1：小<br />2：大 |
245
| alias | str | 简写名 | 无则无此项 |
246
247
`评论条目`中的`replies`数组：
248
249
| 项 | 类型 | 内容 | 备注 |
250
| ---- | ---- | --------- | ------------------------------------------------------------ |
251
| 0 | obj | 回复条目1 | **为本对象的递归嵌套**<br />**仅嵌套一层**<br />按照热度顺序排列 |
252
| 1 | obj | 回复条目2 | |
253
| 2 | obj | 回复条目3 | 最后一项 |
254
255
`评论条目`中的`folder`对象：
256
257
| 字段 | 类型 | 内容 | 备注 |
258
| ---------- | ---- | ------ | ---------------- |
259
| has_folded | bool | false | **作用尚不明确** |
260
| is_folded | bool | false | **作用尚不明确** |
261
| rule | str | ？？？ | **作用尚不明确** |
262
263
`评论条目`中的`up_action`对象：
264
265
| 字段 | 类型 | 内容 | 备注 |
266
| ----- | ---- | ---------------- | ----------------------- |
267
| like | bool | 是否UP主觉得很赞 | false：否<br />true：是 |
268
| reply | bool | 是否被UP主回复 | false：否<br />true：是 |
@@ -6,24 +6,25 @@
6
6
7
7
*请求方式：POST*
8
8
9
认证方式：Cookie（SESSDATA）
9
认证方式：Cookie（SESSDATA）或APP
10
10
11
11
**正文参数（ application/x-www-form-urlencoded ）：**
12
12
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
| -------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
15
| type | num | 1 | 必要 | |
16
| oid | num | 视频CID | 必要 | |
17
| msg | str | 弹幕内容 | 必要 | 长度小于100字符 |
18
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
19
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
20
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
21
| color | num | 弹幕颜色设置 | 非必要 | 十进制RGB888值<br />默认为16777215（#FFFFFF）白色 |
22
| fontsize | num | 弹幕字号设置 | 非必要 | 默认为25<br />极小：12<br />超小：16<br />小：18<br />标准：25<br />大：36<br />超大：45<br />极大：64 |
23
| pool | num | 弹幕池选择 | 非必要 | 0：普通池<br />1：字幕池<br />2：特殊池（代码/BAS弹幕）<br />默认为0 |
24
| mode | num | 弹幕类型选择 | 必要 | 1：普通弹幕<br />4：底部弹幕<br />5：顶部弹幕<br />7：高级弹幕<br />9：BAS弹幕（`pool`必须为2） |
25
| rnd | num | 当前时间戳*1000000 | 非必要 | **若无此项，则发送弹幕冷却时间限制为90s**<br />若有此项，则发送弹幕冷却时间限制为5s |
26
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
15
| access_key | str | APP登录Token | APP方式必要 | |
16
| type | num | 1 | 必要 | |
17
| oid | num | 视频CID | 必要 | |
18
| msg | str | 弹幕内容 | 必要 | 长度小于100字符 |
19
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
20
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
21
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
22
| color | num | 弹幕颜色设置 | 非必要 | 十进制RGB888值<br />默认为16777215（#FFFFFF）白色 |
23
| fontsize | num | 弹幕字号设置 | 非必要 | 默认为25<br />极小：12<br />超小：16<br />小：18<br />标准：25<br />大：36<br />超大：45<br />极大：64 |
24
| pool | num | 弹幕池选择 | 非必要 | 0：普通池<br />1：字幕池<br />2：特殊池（代码/BAS弹幕）<br />默认为0 |
25
| mode | num | 弹幕类型选择 | 必要 | 1：普通弹幕<br />4：底部弹幕<br />5：顶部弹幕<br />7：高级弹幕<br />9：BAS弹幕（`pool`必须为2） |
26
| rnd | num | 当前时间戳*1000000 | 非必要 | **若无此项，则发送弹幕冷却时间限制为90s**<br />若有此项，则发送弹幕冷却时间限制为5s |
27
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
27
28
28
29
**json回复：**
29
30
@@ -102,16 +103,17 @@ curl 'http://api.bilibili.com/x/v2/dm/post'\
102
103
103
104
**正文参数（ application/x-www-form-urlencoded ）：**
104
105
105
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
106
| -------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
107
| type | num | 互动弹幕类型 | 必要 | 1：UP主头像弹幕<br />2：关联视频弹幕<br />5：视频内嵌引导关注按钮 |
108
| aid | num | 视频avID | 必要 | |
109
| cid | num | 视频CID | 必要 | |
110
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
111
| plat | num | 平台标识 | 必要 | 1：web端<br />2：安卓端<br />8：视频管理页面 |
112
| data | str | json序列 | 必要 | |
113
| dmid | num | 修改互动弹幕的弹幕ID | 非必要 | 注：修改弹幕`plat`必须为8 |
114
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
106
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
107
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
108
| access_key | str | APP登录Token | APP方式必要 | |
109
| type | num | 互动弹幕类型 | 必要 | 1：UP主头像弹幕<br />2：关联视频弹幕<br />5：视频内嵌引导关注按钮 |
110
| aid | num | 视频avID | 必要 | |
111
| cid | num | 视频CID | 必要 | |
112
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
113
| plat | num | 平台标识 | 必要 | 1：web端<br />2：安卓端<br />8：视频管理页面 |
114
| data | str | json序列 | 必要 | |
115
| dmid | num | 修改互动弹幕的弹幕ID | 非必要 | 注：修改弹幕`plat`必须为8 |
116
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
115
117
116
118
`data`参数：
117
119
@@ -299,17 +301,18 @@ curl 'http://api.bilibili.com/x/v2/dm/command/post'\
299
301
300
302
*请求方式：POST*
301
303
302
认证方式：Cookie（SESSDATA）
304
认证方式：Cookie（SESSDATA）或APP
303
305
304
306
仅能撤回自己两分钟内的弹幕，且每天只有3次机会
305
307
306
308
**正文参数（ application/x-www-form-urlencoded ）：**
307
309
308
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
309
| ------ | ---- | ------------------------ | ------ | ---- |
310
| dmid | num | 弹幕dmID | 必要 | |
311
| cid | num | 视频CID | 必要 | |
312
| csrf | str | CSRF Token（位于cookie） | 必要 | |
310
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
311
| ---------- | ---- | ------------------------ | -------------- | ---- |
312
| access_key | str | APP登录Token | APP方式必要 | |
313
| dmid | num | 弹幕dmID | 必要 | |
314
| cid | num | 视频CID | 必要 | |
315
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
313
316
314
317
**json回复：**
315
318
@@ -351,17 +354,18 @@ curl 'http://api.bilibili.com/x/dm/recall'\
351
354
352
355
*请求方式：POST*
353
356
354
认证方式：Cookie（SESSDATA）
357
认证方式：Cookie（SESSDATA）或APP
355
358
356
359
购买一次需要2硬币，同时向up主发送请求
357
360
358
361
**正文参数（ application/x-www-form-urlencoded ）：**
359
362
360
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
361
| ------ | ---- | ------------------------ | ------ | ---- |
362
| mode | str | sp | 必要 | |
363
| cid | num | 视频CID | 必要 | |
364
| csrf | str | CSRF Token（位于cookie） | 必要 | |
363
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
364
| ---------- | ---- | ------------------------ | -------------- | ---- |
365
| access_key | str | APP登录Token | APP方式必要 | |
366
| mode | str | sp | 必要 | |
367
| cid | num | 视频CID | 必要 | |
368
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
365
369
366
370
**json回复：**
367
371
@@ -403,14 +407,15 @@ curl 'http://api.bilibili.com/x/dm/adv/buy'\
403
407
404
408
*请求方式：GET*
405
409
406
认证方式：Cookie（SESSDATA）
410
认证方式：Cookie（SESSDATA）或APP
407
411
408
412
**url参数：**
409
413
410
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
411
| ------ | ---- | ------- | ------ | ---- |
412
| mode | str | sp | 必要 | |
413
| cid | num | 视频CID | 必要 | |
414
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
415
| ---------- | ---- | ------------ | ----------- | ---- |
416
| access_key | str | APP登录Token | APP方式必要 | |
417
| mode | str | sp | 必要 | |
418
| cid | num | 视频CID | 必要 | |
414
419
415
420
**json回复：**
416
421
@@ -20,7 +20,7 @@
20
20
| ------- | ---- | -------- | ----------------------------- |
21
21
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
22
22
| message | str | 错误信息 | 默认为0 |
23
| ttl | num | 1 | **作用尚不明确** |
23
| ttl | num | 1 | |
24
24
| data | obj | 信息本体 | |
25
25
26
26
`data`对象：
@@ -295,7 +295,7 @@ curl 'http://account.bilibili.com/home/userInfo'\
295
295
| ------- | ---- | -------- | ------------------------------------------------------------ |
296
296
| code | num | 返回值 | 0：成功<br />-3：API校验密匙错误<br />-101：账号未登录<br />-400：请求错误 |
297
297
| message | str | 错误信息 | 默认为0 |
298
| ttl | num | 1 | **作用尚不明确** |
298
| ttl | num | 1 | |
299
299
| data | obj | 信息本体 | |
300
300
301
301
`data`对象：
@@ -445,7 +445,7 @@ curl -G 'http://app.bilibili.com/x/v2/account/myinfo'\
445
445
| ------- | ---- | -------- | ----------------------------- |
446
446
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
447
447
| message | str | 错误信息 | 默认为0 |
448
| ttl | num | 1 | 作用尚不明确 |
448
| ttl | num | 1 | |
449
449
| data | obj | 信息本体 | |
450
450
451
451
| 字段 | 类型 | 内容 | 备注 |
@@ -0,0 +1,67 @@
1
# 登录记录
2
3
## 查询登录记录
4
5
> http://api.bilibili.com/x/safecenter/login_notice
6
7
*请求方式：GET*
8
9
**url参数：**
10
11
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
12
| ------ | ---- | ------- | ------ | -------------------------------------------- |
13
| mid | num | 用户UID | 必要 | |
14
| buvid | str | 设备ID | 非必要 | 为操作登录接口时Cookie中的`buvid3`可为任意值 |
15
16
**json回复：**
17
18
根对象：
19
20
| 字段 | 类型 | 内容 | 备注 |
21
| ------- | ---- | -------- | --------------------------- |
22
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
23
| message | str | 错误信息 | 默认为0 |
24
| ttl | num | 1 | |
25
| data | obj | 信息本体 | |
26
27
`data`对象：
28
29
| 字段 | 类型 | 内容 | 备注 |
30
| ----------- | ---- | ----------- | -------------------------- |
31
| mid | num | 登录用户UID | |
32
| device_name | str | 登录设备 | 依靠操作登录接口时的UA决定 |
33
| login_type | str | 登录方式 | 根据登录接口决定 |
34
| login_time | str | 登录时间 | YYYY-MM-DD hh:mm:ss |
35
| location | str | 登录位置 | 依靠ip决定 |
36
| ip | str | 登录ip | 部分用`*`打码 |
37
38
**示例：**
39
40
查询用户`293793435`设备ID为`fuck_chenrui`的登录记录
41
42
```shell
43
curl -G 'http://api.bilibili.com/x/safecenter/login_notice'\
44
--data-urlencode 'mid=293793435'\
45
--data-urlencode 'buvid=fuck_chenrui'
46
```
47
48
<details>
49
<summary>查看响应示例：</summary>
50
51
```json
52
{
53
"code": 0,
54
"message": "0",
55
"ttl": 1,
56
"data": {
57
"mid": 293793435,
58
"device_name": "Chrome浏览器",
59
"login_type": "扫码登录",
60
"login_time": "2020-10-02 22:42:38",
61
"location": "中国陕西渭南",
62
"ip": "36.40.***.**"
63
}
64
}
65
```
66
67
</details>
@@ -18,7 +18,7 @@
18
18
| ------- | ---- | -------- | ----------------------------- |
19
19
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
20
20
| message | str | 错误信息 | 默认为0 |
21
| ttl | num | 1 | 作用尚不明确 |
21
| ttl | num | 1 | |
22
22
| data | obj | 信息本体 | |
23
23
24
24
`data`对象：
@@ -80,7 +80,7 @@ curl 'http://api.bilibili.com/x/member/web/account'\
80
80
| ------- | ---- | -------- | ----------------------------- |
81
81
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
82
82
| message | str | 错误信息 | 默认为0 |
83
| ttl | num | 1 | 作用尚不明确 |
83
| ttl | num | 1 | |
84
84
| data | obj | 信息本体 | |
85
85
86
86
`data`对象：
@@ -142,7 +142,7 @@ curl 'http://api.bilibili.com/x/member/web/exp/reward'\
142
142
| ------- | ---- | -------- | ----------------------------- |
143
143
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
144
144
| message | str | 错误信息 | 默认为0 |
145
| ttl | num | 1 | 作用尚不明确 |
145
| ttl | num | 1 | |
146
146
| data | obj | 信息本体 | |
147
147
148
148
`data`对象：
@@ -202,7 +202,7 @@ curl 'http://api.bilibili.com/x/vip/web/user/info'\
202
202
| ------- | ---- | -------- | ----------------------------- |
203
203
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
204
204
| message | str | 错误信息 | 默认为0 |
205
| ttl | num | 1 | 作用尚不明确 |
205
| ttl | num | 1 | |
206
206
| data | obj | 信息本体 | |
207
207
208
208
`data`对象：
@@ -304,7 +304,7 @@ curl 'http://passport.bilibili.com/web/site/user/info'\
304
304
| ------- | ---- | -------- | ----------------------------- |
305
305
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
306
306
| message | str | 错误信息 | 默认为0 |
307
| ttl | num | 1 | 作用尚不明确 |
307
| ttl | num | 1 | |
308
308
| data | obj | 信息本体 | |
309
309
310
310
`data`对象：
@@ -354,7 +354,7 @@ curl 'http://api.bilibili.com/x/member/realname/status'\
354
354
| ------- | ---- | -------- | ----------------------------- |
355
355
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
356
356
| message | str | 错误信息 | 默认为0 |
357
| ttl | num | 1 | 作用尚不明确 |
357
| ttl | num | 1 | |
358
358
| data | obj | 数据本体 | |
359
359
360
360
`data`对象：
@@ -410,7 +410,7 @@ curl 'http://api.bilibili.com/x/member/realname/apply/status'\
410
410
| ------- | ---- | -------- | ----------------------------- |
411
411
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
412
412
| message | str | 错误信息 | 默认为0 |
413
| ttl | num | 1 | 作用尚不明确 |
413
| ttl | num | 1 | |
414
414
| data | obj | 数据本体 | |
415
415
416
416
`data`对象：
@@ -551,7 +551,7 @@ curl 'http://api.bilibili.com/x/member/web/coin/log'\
551
551
| ------- | ---- | -------- | ------------------------------------------------------------ |
552
552
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />40015：签名包含敏感词<br />40021：签名不能包含表情图片<br />40022：签名过长 |
553
553
| message | str | 错误信息 | 默认为0 |
554
| ttl | num | 1 | 作用尚不明确 |
554
| ttl | num | 1 | |
555
555
556
556
**示例：**
557
557
@@ -559,7 +559,7 @@ curl 'http://api.bilibili.com/x/member/web/coin/log'\
559
559
560
560
```shell
561
561
curl 'http://api.bilibili.com/x/member/web/sign/update'\
562
--data-urlencode 'user_sign=高中技术宅一枚，爱好MC&电子&8-bit音乐&数码&编程，粉丝群：1136462265'\
562
563
--data-urlencode 'csrf=xxx'\
563
564
-b 'SESSDATA=xxx'
564
565
```
@@ -18,7 +18,7 @@
18
18
| ------- | ---- | -------- | ----------------------------- |
19
19
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
20
20
| message | str | 错误信息 | 默认为0 |
21
| ttl | num | 1 | 作用尚不明确 |
21
| ttl | num | 1 | |
22
22
| data | obj | 信息本体 | |
23
23
24
24
data 对象：