返回提交历史
Modified
cheese/videostream_url.md
+1
-1
Modified
danmaku/action.md
+14
-14
Modified
electric/charge_list.md
+5
-5
Modified
history&toview/history.md
+1
-1
Modified
history&toview/toview.md
+5
-5
Modified
user/space.md
+17
-17
Modified
video/info.md
+12
-12
Modified
video/like_coin_fav.md
+26
-26
Modified
video/pbp.md
+3
-3
Modified
video/recommend.md
+4
-4
Modified
video/report.md
+55
-2
Modified
video/snapshot.md
+6
-6
Modified
video/status_number.md
+4
-4
Modified
video/tags.md
+4
-4
Modified
video/videostream_url.md
+6
-6
XFEstudio/bilibili-API-collect
添加视频心跳上报 并勘误
7bb0a16
代码差异
15 个文件
+163
-110
@@ -22,7 +22,7 @@
22
22
23
23
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
24
24
| ------ | ---- | -------------- | ------ | ------------------------------------------------------------ |
25
| aid | num | 课程avID | 必要 | |
25
| avid | num | 课程avID | 必要 | |
26
26
| ep_id | num | 课程epID | 必要 | |
27
27
| cid | num | 视频CID | 必要 | |
28
28
| qn | num | 视频清晰度选择 | 非必要 | 未登录默认32（480P）<br />登录默认64（720P）<br />**值含义见下表** |
@@ -10,20 +10,20 @@
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 | 弹幕颜色设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)<br />默认为16777215（#FFFFFF）白色 |
22
| fontsize | num | 弹幕字号设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)<br />默认为25 |
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 | 16位10进制随机数 | 非必要 | **若无此项，则发送弹幕冷却时间限制为90s**<br />若有此项，则发送弹幕冷却时间限制为5s |
26
| csrf | str | cookies中的bili_jct | 必要 | |
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 | 弹幕颜色设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)<br />默认为16777215（#FFFFFF）白色 |
22
| fontsize | num | 弹幕字号设置 | 非必要 | 详见[「弹幕」中的属性 p](danmaku.md#属性 p)<br />默认为25 |
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 | 16位10进制随机数 | 非必要 | **若无此项，则发送弹幕冷却时间限制为90s**<br />若有此项，则发送弹幕冷却时间限制为5s |
26
| csrf | str | cookies中的bili_jct | 必要 | |
27
27
28
28
**json回复：**
29
29
@@ -139,11 +139,11 @@
139
139
140
140
**url参数：**
141
141
142
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
143
| ------ | ---- | ------------ | ------ | ------------------ |
144
| mid | num | 目标用户UID | 必要 | |
145
| aid | num | 目标视频avID | 非必要 | avID与bvID任选一个 |
146
| bvid | str | 目标视频bvID | 非必要 | avID与bvID任选一个 |
142
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
143
| ------ | ---- | ------------ | ------------ | ------------------ |
144
| mid | num | 目标用户UID | 必要 | |
145
| aid | num | 目标视频avID | 必要（可选） | avID与bvID任选一个 |
146
| bvid | str | 目标视频bvID | 必要（可选） | avID与bvID任选一个 |
147
147
148
148
**json回复：**
149
149
@@ -62,7 +62,7 @@
62
62
| bangumi | obj | 番剧/影视信息 | 非番剧/影视无此项 |
63
63
| cheese | obj | 课程信息 | 非课程无此项 |
64
64
| favorite | bool | 是否已收藏 | true：已收藏<br />false：未收藏 |
65
| type | num | 视频属性 | 3：普通视频<br />4：番剧/影视<br />10：课程 |
65
| type | num | 视频属性 | 3：普通视频<br />4：剧集<br />10：课程 |
66
66
| sub_type | num | 附视频属性 | 0：普通视频<br />1：番剧<br />2：电影<br />3：纪录片<br />4：国创<br />5：电视剧<br />7：综艺 |
67
67
| device | num | 观看设备 | 1 3 5 7：手机端<br />2：PC端<br />4 6：PAD端<br />33：TV端<br />0：其他 |
68
68
| page | obj | 最后观看的分P信息 | |
@@ -14,11 +14,11 @@
14
14
15
15
**正文参数（ application/x-www-form-urlencoded ）：**
16
16
17
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
18
| ------ | ---- | ------------------- | ------ | ------------------ |
19
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
20
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
21
| csrf | str | cookies中的bili_jct | 必要 | |
17
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
18
| ------ | ---- | ------------------- | ------------ | ------------------ |
19
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
20
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
21
| csrf | str | cookies中的bili_jct | 必要 | |
22
22
23
23
**json回复：**
24
24
@@ -2322,12 +2322,12 @@ curl -b "SESSDATA=xxx;DedeUserID=1" -d "csrf=xxx&tags=minecraft%2C%E6%8A%80%E6%9
2322
2322
2323
2323
**正文参数（ application/x-www-form-urlencoded ）：**
2324
2324
2325
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2326
| ------ | ---- | ------------------- | ------ | ------------------ |
2327
| aid | num | 置顶目标视频avID | 非必要 | avID与bvID任选一个 |
2328
| bvid | str | 置顶目标视频bvID | 非必要 | avID与bvID任选一个 |
2329
| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符 |
2330
| csrf | str | cookies中的bili_jct | 必要 | |
2325
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2326
| ------ | ---- | ------------------- | ------------ | -------------------------------- |
2327
| aid | num | 置顶目标视频avID | 必要（可选） | avID与bvID任选一个 |
2328
| bvid | str | 置顶目标视频bvID | 必要（可选） | avID与bvID任选一个 |
2329
| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符<br />默认为空 |
2330
| csrf | str | cookies中的bili_jct | 必要 | |
2331
2331
2332
2332
**json回复：**
2333
2333
@@ -2407,12 +2407,12 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx" "http://api.bilibili.com/x/space/top/arc/ca
2407
2407
2408
2408
**正文参数（ application/x-www-form-urlencoded ）：**
2409
2409
2410
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2411
| ------ | ---- | ------------------- | ------ | ------------------ |
2412
| aid | num | 置顶目标视频avID | 非必要 | avID与bvID任选一个 |
2413
| bvid | str | 置顶目标视频bvID | 非必要 | avID与bvID任选一个 |
2414
| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符 |
2415
| csrf | str | cookies中的bili_jct | 必要 | |
2410
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2411
| ------ | ---- | ------------------- | ------------ | -------------------------------- |
2412
| aid | num | 置顶目标视频avID | 必要（可选） | avID与bvID任选一个 |
2413
| bvid | str | 置顶目标视频bvID | 必要（可选） | avID与bvID任选一个 |
2414
| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符<br />默认为空 |
2415
| csrf | str | cookies中的bili_jct | 必要 | |
2416
2416
2417
2417
**json回复：**
2418
2418
@@ -2452,11 +2452,11 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=94916552" "http://api.bilibili.com/x/spa
2452
2452
2453
2453
**正文参数（ application/x-www-form-urlencoded ）：**
2454
2454
2455
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2456
| ------ | ---- | -------------------- | ------ | ------------------ |
2457
| aid | num | 要删除的目标视频avID | 非必要 | avID与bvID任选一个 |
2458
| bvid | str | 要删除的目标视频bvID | 非必要 | avID与bvID任选一个 |
2459
| csrf | str | cookies中的bili_jct | 必要 | |
2455
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2456
| ------ | ---- | -------------------- | ------------ | ------------------ |
2457
| aid | num | 要删除的目标视频avID | 必要（可选） | avID与bvID任选一个 |
2458
| bvid | str | 要删除的目标视频bvID | 必要（可选） | avID与bvID任选一个 |
2459
| csrf | str | cookies中的bili_jct | 必要 | |
2460
2460
2461
2461
**json回复：**
2462
2462
@@ -10,10 +10,10 @@
10
10
11
11
**url参数：**
12
12
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
| ------ | ---- | -------- | ------ | ------------------ |
15
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
16
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
| ------ | ---- | -------- | ------------ | ------------------ |
15
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
16
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
17
17
18
18
**json回复：**
19
19
@@ -357,10 +357,10 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
357
357
358
358
**url参数：**
359
359
360
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
361
| ------ | ---- | -------- | ------ | ------------------ |
362
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
363
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
360
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
361
| ------ | ---- | -------- | ------------ | ------------------ |
362
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
363
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
364
364
365
365
**json回复：**
366
366
@@ -400,10 +400,10 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
400
400
401
401
**url参数：**
402
402
403
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
404
| ------ | ---- | -------- | ------ | ------------------ |
405
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
406
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
403
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
404
| ------ | ---- | -------- | ------------ | ------------------ |
405
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
406
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
407
407
408
408
**json回复：**
409
409
@@ -14,12 +14,12 @@
14
14
15
15
**正文参数（ application/x-www-form-urlencoded ）：**
16
16
17
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
18
| ------ | ---- | ------------------- | ------ | ---------------------- |
19
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
20
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
21
| like | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 |
22
| csrf | str | cookies中的bili_jct | 必要 | |
17
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
18
| ------ | ---- | ------------------- | ------------ | ---------------------- |
19
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
20
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
21
| like | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 |
22
| csrf | str | cookies中的bili_jct | 必要 | |
23
23
24
24
**json回复：**
25
25
@@ -59,13 +59,13 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co
59
59
60
60
**正文参数（ application/x-www-form-urlencoded ）：**
61
61
62
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
63
| ----------- | ---- | ------------------- | ------ | --------------------------------------- |
64
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
65
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
66
| select_like | num | 附加点赞 | 非必要 | 0：不点赞<br />1：同时点赞<br />默认为0 |
67
| multiply | num | 投币数量 | 必要 | 上限为2 |
68
| csrf | str | cookies中的bili_jct | 必要 | |
62
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
63
| ----------- | ---- | ------------------- | ------------ | --------------------------------------- |
64
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
65
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
66
| select_like | num | 附加点赞 | 非必要 | 0：不点赞<br />1：同时点赞<br />默认为0 |
67
| multiply | num | 投币数量 | 必要 | 上限为2 |
68
| csrf | str | cookies中的bili_jct | 必要 | |
69
69
70
70
**json回复：**
71
71
@@ -171,11 +171,11 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
171
171
172
172
**正文参数（ application/x-www-form-urlencoded ）：**
173
173
174
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
175
| ------ | ---- | ------------------- | ------ | ------------------ |
176
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
177
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
178
| csrf | str | cookies中的bili_jct | 必要 | |
174
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
175
| ------ | ---- | ------------------- | ------------ | ------------------ |
176
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
177
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
178
| csrf | str | cookies中的bili_jct | 必要 | |
179
179
180
180
**json回复：**
181
181
@@ -287,10 +287,10 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
287
287
288
288
**url参数：**
289
289
290
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
291
| ------ | ---- | -------- | ------ | ------------------ |
292
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
293
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
290
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
291
| ------ | ---- | -------- | ------------ | ------------------ |
292
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
293
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
294
294
295
295
**json回复：**
296
296
@@ -332,10 +332,10 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
332
332
333
333
**url参数：**
334
334
335
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
336
| ------ | ---- | -------- | ------ | ------------------ |
337
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
338
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
335
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
336
| ------ | ---- | -------- | ------------ | ------------------ |
337
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
338
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
339
339
340
340
**json回复：**
341
341
@@ -12,9 +12,9 @@
12
12
13
13
**url参数：**
14
14
15
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
16
| ------ | ---- | ----- | ------ | ---- |
17
| vid | num | 视CID | 必要 | |
15
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
16
| ------ | ---- | ------- | ------ | ---- |
17
| vid | num | 视频CID | 必要 | |
18
18
19
19
**json回复：**
20
20
@@ -10,10 +10,10 @@
10
10
11
11
**url参数：**
12
12
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
| ------ | ---- | -------- | ------ | ------------------ |
15
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
16
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
14
| ------ | ---- | -------- | ------------ | ------------------ |
15
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
16
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
17
17
18
18
**json回复：**
19
19
@@ -19,8 +19,6 @@
19
19
20
20
**json回复：**
21
21
22
**json回复：**
23
24
22
根对象：
25
23
26
24
| 字段 | 类型 | 内容 | 备注 |
@@ -43,3 +41,58 @@ curl -b "SESSDATA=xxx" -d "aid=13662970&cid=126654047&progress=1248&csrf=xxx" "h
43
41
}
44
42
```
45
43
44
45
46
## 上报视频播放心跳（web端）
47
48
> http://api.bilibili.com/x/click-interface/web/heartbeat
49
50
*方式：POST*
51
52
默认间隔15秒一次
53
54
亦可记录播放历史
55
56
**正文参数（ application/x-www-form-urlencoded ）：**
57
58
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
59
| ----------- | ---- | ------------------- | ------------ | ------------------------------------------------------------ |
60
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
61
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
62
| cid | num | 视频CID | 非必要 | 用于识别分P |
63
| epid | num | 番剧epID | 非必要 | |
64
| sid | num | 番剧ssID | 非必要 | |
65
| mid | num | 当前用户UID | 非必要 | |
66
| played_time | num | 视频播放进度 | 非必要 | 单位为秒<br />默认为0 |
67
| realtime | num | 总计播放时间 | 非必要 | 单位为秒 |
68
| start_ts | num | 开始播放时刻 | 非必要 | 时间戳 |
69
| type | num | 视频类型 | 非必要 | 3：投稿视频<br />4：剧集<br />10：课程 |
70
| sub_type | num | 剧集副类型 | 非必要 | 当`type=4`时本参数有效<br />1：番剧<br />2：电影<br />3：纪录片<br />4：国创<br />5：电视剧<br />7：综艺 |
71
| dt | num | 2 | 非必要 | |
72
| play_type | num | 播放动作 | 非必要 | 0：播放中<br />1：开始播放<br />2：暂停<br />3：继续播放 |
73
| csrf | str | cookies中的bili_jct | 非必要 | |
74
75
**json回复：**
76
77
根对象：
78
79
| 字段 | 类型 | 内容 | 备注 |
80
| ------- | ---- | -------- | --------------------------- |
81
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
82
| message | str | 错误信息 | 默认为0 |
83
| ttl | num | 1 | 作用尚不明确 |
84
85
**示例：**
86
87
上报一次视频`av2`/`BV1xx411c7mD`的心跳数据
88
89
http://api.bilibili.com/x/click-interface/web/heartbeat?aid=2&bvid=BV1xx411c7mD&cid=62131&played_time=60&realtime=60&start_ts=1592720840&type=3&dt=2&play_type=0&csrf=xxx
90
91
```json
92
{
93
"code": 0,
94
"message": "0",
95
"ttl": 1
96
}
97
```
98
@@ -13,12 +13,12 @@
13
13
14
14
**url参数：**
15
15
16
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
17
| ------ | ---- | ------------------ | ------ | ----------------------------------- |
18
| aid | num | 视频avID | 非必要 | avID与bvID任选一个 |
19
| bvid | str | 视频bvID | 非必要 | avID与bvID任选一个 |
20
| cid | num | 分P CID | 非必要 | 默认为1P |
21
| index | num | json数组截取时间表 | 非必要 | 1：需要<br />0：不需要<br />默认为0 |
16
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
17
| ------ | ---- | ------------------ | ------------ | ----------------------------------- |
18
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
19
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
20
| cid | num | 分P CID | 非必要 | 默认为1P |
21
| index | num | json数组截取时间表 | 非必要 | 1：需要<br />0：不需要<br />默认为0 |
22
22
23
23
**json回复：**
24
24