返回提交历史
Modified
docs/danmaku/action.md
+47
-35
XFEstudio/bilibili-API-collect
update 【弹幕操作】APIDoc
45dd000
代码差异
1 个文件
+47
-35
@@ -14,21 +14,23 @@
14
14
15
15
**正文参数（ application/x-www-form-urlencoded ）：**
16
16
17
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
18
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
19
| access_key | str | APP登录Token | APP方式必要 | |
20
| type | num | 弹幕类选择 | 必要 | 1：视频弹幕 |
21
| oid | num | 视频cid | 必要 | |
22
| msg | str | 弹幕内容 | 必要 | 长度小于100字符 |
23
| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
24
| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
25
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
26
| color | num | 弹幕颜色设置 | 非必要 | 十进制RGB888值<br />默认为16777215（#FFFFFF）白色 |
27
| fontsize | num | 弹幕字号设置 | 非必要 | 默认为25<br />极小：12<br />超小：16<br />小：18<br />标准：25<br />大：36<br />超大：45<br />极大：64 |
28
| pool | num | 弹幕池选择 | 非必要 | 0：普通池<br />1：字幕池<br />2：特殊池（代码/BAS弹幕）<br />默认为0 |
29
| mode | num | 弹幕类型选择 | 必要 | 1：普通弹幕<br />4：底部弹幕<br />5：顶部弹幕<br />7：高级弹幕<br />9：BAS弹幕（`pool`必须为2） |
30
| rnd | num | 当前时间戳*1000000 | 非必要 | **若无此项，则发送弹幕冷却时间限制为90s**<br />若有此项，则发送弹幕冷却时间限制为5s |
31
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
17
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
18
| ------------- | ---- | ------------------------- | --------------- | ------------------------------------------------------------ |
19
| access_key | str | APP 登录 Token | APP 方式必要 | |
20
| type | num | 弹幕类选择 | 必要 | 1：视频弹幕<br />2：漫画弹幕 |
21
| oid | num | 视频 cid | 必要 | |
22
| msg | str | 弹幕内容 | 必要 | 长度小于 100 字符 |
23
| bvid | str | 稿件 bvid | 必要（可选） | avid 与 bvid 任选一个 |
24
| aid | num | 稿件 avid | 必要（可选） | avid 与 bvid 任选一个 |
25
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
26
| color | num | 弹幕颜色设置 | 非必要 | 十进制 RGB888 值<br />如`16777215`为 #FFFFFF 即白色 |
27
| fontsize | num | 弹幕字号设置 | 非必要 | 默认为 25<br />极小：12<br />超小：16<br />小：18<br />标准：25<br />大：36<br />超大：45<br />极大：64 |
28
| pool | num | 弹幕池选择 | 非必要 | 0：普通池<br />1：字幕池<br />2：特殊池（代码/BAS弹幕）<br />默认为0 |
29
| mode | num | 弹幕类型选择 | 必要 | 1：普通弹幕<br />4：底部弹幕<br />5：顶部弹幕<br />7：高级弹幕<br />9：BAS弹幕（`pool`必须为2） |
30
| rnd | num | 当前时间戳*1000000 | 非必要 | **若无此项，则发送弹幕冷却时间限制为90s**<br />若有此项，则发送弹幕冷却时间限制为5s |
31
| colorful | num | 彩色弹幕 | 非必要 | 60001：专属渐变彩色（需要会员） |
32
| checkbox_type | num | 是否带 UP 身份标识 | 非必要 | 0：普通<br />4：带有标识 |
33
| csrf | str | CSRF Token（位于 Cookie） | Cookie 方式必要 | |
32
34
33
35
**json回复：**
34
36
@@ -36,38 +38,48 @@
36
38
37
39
| 字段 | 类型 | 内容 | 备注 |
38
40
| ------- | ---- | -------- | ------------------------------------------------------------ |
39
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />36700：系统升级中<br />36701：弹幕包含被禁止的内容<br />36702：弹幕长度大于100<br />36703：发送频率过快<br />36704：禁止向未审核的视频发送弹幕<br />36705：您的等级不足，不能发送弹幕<br />36706：您的等级不足，不能发送顶端弹幕<br />36707：您的等级不足，不能发送底端弹幕<br />36708：您的等级不足，不能发送彩色弹幕<br />36709：您的等级不足，不能发送高级弹幕<br />36710：您的权限不足，不能发送这种样式的弹幕<br />36711：该视频禁止发送弹幕<br />36712：level 1用户发送弹幕的最大长度为20<br />36713：稿件未付费<br />36714：弹幕发送时间不合法<br />36715：当日操作数量超过上限 |
41
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />36700：系统升级中<br />36701：弹幕包含被禁止的内容<br />36702：弹幕长度大于100<br />36703：发送频率过快<br />36704：禁止向未审核的视频发送弹幕<br />36705：您的等级不足，不能发送弹幕<br />36706：您的等级不足，不能发送顶端弹幕<br />36707：您的等级不足，不能发送底端弹幕<br />36708：您的等级不足，不能发送彩色弹幕<br />36709：您的等级不足，不能发送高级弹幕<br />36710：您的权限不足，不能发送这种样式的弹幕<br />36711：该视频禁止发送弹幕<br />36712：level 1用户发送弹幕的最大长度为20<br />36713：稿件未付费<br />36714：弹幕发送时间不合法<br />36715：当日操作数量超过上限<br />36718：目前您不是大会员，无法使用会员权益 |
40
42
| message | str | 错误信息 | 默认为0 |
41
43
| ttl | num | 1 | |
42
44
| data | obj | 信息本体 | |
43
45
44
46
`data`对象：
45
47
46
| 字段 | 类型 | 内容 | 备注 |
47
| -------- | ---- | -------- | ------------ |
48
| action | str | 空 | 作用尚不明确 |
49
| dmid | num | 弹幕dmid | |
50
| dmid_str | str | 弹幕dmid | 字串形式 |
51
| visible | bool | true | 作用尚不明确 |
48
| 字段 | 类型 | 内容 | 备注 |
49
| ------------ | ---------- | ------------------ | -------------------------------- |
50
| action | str | （？） | |
51
| animation | str | 弹幕样式 Json？ | |
52
| colorful_src | str 或 obj | 渐变彩色样式信息？ | 当请求参数`colorful=60001`时有效 |
53
| dm_content | str | （？） | |
54
| dmid | num | 弹幕 dmid | |
55
| dmid_str | str | 弹幕 dmid | 字串形式 |
56
| visible | bool | （？） | |
57
58
`data`中的`colorful_src`对象：
59
60
| 字段 | 类型 | 内容 | 备注 |
61
| ---- | ---- | ----------------- | ---- |
62
| type | num | 60001 | |
63
| src | str | 渐变色样式 Json？ | |
52
64
53
65
**示例：**
54
66
55
为视频`av2`/`BV1xx411c7mD`（cid为`62131`）的5000ms位置发送一条弹幕`前来考古`（颜色为#FFFFFF，字号25，普通弹幕，游动弹幕）
67
为视频`av2`/`BV1xx411c7mD`（cid为`62131`）的 5000ms 位置发送一条弹幕`前来考古`（颜色为 #FFFFFF，字号 25，普通弹幕，游动弹幕）
56
68
57
69
```shell
58
70
curl 'https://api.bilibili.com/x/v2/dm/post' \
59
-b 'SESSDATA=xxx'
71
--data-urlencode 'type=1' \
72
--data-urlencode 'oid=62131' \
73
--data-urlencode 'msg=前来考古' \
74
--data-urlencode 'aid=2' \
75
--data-urlencode 'progress=5000' \
76
--data-urlencode 'color=16777215' \
77
--data-urlencode 'fontsize=25' \
78
--data-urlencode 'pool=0' \
79
--data-urlencode 'mode=1' \
80
--data-urlencode 'rnd=3456789987654321' \
81
--data-urlencode 'csrf=xxx' \
82
-b 'SESSDATA=xxx'
60
83
```
61
84
62
85
<details>