返回提交历史
Modified
danmaku/action.md
+55
-0
XFEstudio/bilibili-API-collect
Update action.md
添加 保护&删除弹幕
c0f641b
代码差异
1 个文件
+55
-0
@@ -672,3 +672,58 @@ curl 'http://api.bilibili.com/x/dm/report/add'\
672
672
```
673
673
674
674
</details>
675
676
## 保护&删除弹幕
677
678
> http://api.bilibili.com/x/v2/dm/edit/state
679
680
*请求方式：POST*
681
682
认证方式：Cookie（SESSDATA）
683
684
**正文参数（ application/x-www-form-urlencoded ）：**
685
686
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
687
| ------ | ---- | ------------------------ | -------------- | --------------------------------------------- |
688
| type | num | 1 | 必要 | |
689
| oid | num | 视频CID | 必要 | |
690
| dmids | nums | 弹幕dmID列表 | 必要 | 多个ID之间用`,`分隔 |
691
| state | num | 操作 | 必要 | 1：删除弹幕<br />2：弹幕保护<br />3：取消保护 |
692
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
693
694
**json回复：**
695
696
根对象：
697
698
| 字段 | 类型 | 内容 | 备注 |
699
| ------- | ---- | -------- | ------------------------------------------------------------ |
700
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf 校验失败<br />-400：请求错误<br />-403：访问权限不足 |
701
| message | str | 错误信息 | 默认为0 |
702
| ttl | num | 1 | |
703
704
**示例**
705
706
删除`CID=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531`
707
708
```shell
709
curl 'http://api.bilibili.com/x/v2/dm/edit/state'\
710
--data-urlencode 'type=1'\
711
--data-urlencode 'oid=145928946'\
712
--data-urlencode 'dmids=35600074482384899,39067304918515717,39082777041174531'\
713
--data-urlencode 'state=1'\
714
--data-urlencode 'csrf=xxx'\
715
-b 'SESSDATA=xxx'
716
```
717
718
<details>
719
<summary>查看响应示例：</summary>
720
721
```json
722
{
723
"code":0,
724
"message":"0",
725
"ttl":1
726
}
727
```
728
729
</details>