diff --git a/danmaku/action.md b/danmaku/action.md index a925a3c..6639d7d 100644 --- a/danmaku/action.md +++ b/danmaku/action.md @@ -690,3 +690,119 @@ curl 'http://api.bilibili.com/x/dm/report/add'\ ``` + +## 保护&删除弹幕 + +> http://api.bilibili.com/x/v2/dm/edit/state + +*请求方式:POST* + +认证方式:Cookie(SESSDATA) 或APP + +注:只能操作自己的稿件或有骑士权限的稿件 + +**正文参数( application/x-www-form-urlencoded ):** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------ | -------------- | --------------------------------------------- | +| access_key | str | APP登录Token | APP方式必要 | | +| type | num | 弹幕类选择 | 必要 | 1:视频弹幕 | +| oid | num | 视频CID | 必要 | | +| dmids | nums | 弹幕dmID | 必要 | 多个ID之间用`,`分隔 | +| state | num | 操作代码 | 必要 | 1:删除弹幕
2:弹幕保护
3:取消保护 | +| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf 校验失败
-400:请求错误
-403:访问权限不足 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例** + +删除`CID=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531` + +```shell +curl 'http://api.bilibili.com/x/v2/dm/edit/state'\ +--data-urlencode 'type=1'\ +--data-urlencode 'oid=145928946'\ +--data-urlencode 'dmids=35600074482384899,39067304918515717,39082777041174531'\ +--data-urlencode 'state=1'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` + +
+查看响应示例: + +```json +{ + "code":0, + "message":"0", + "ttl":1 +} +``` + +
+ +## 修改字幕池 + +> http://api.bilibili.com/x/v2/dm/edit/pool + +*请求方式:POST* + +认证方式:Cookie(SESSDATA) 或APP + +注:只能操作自己的稿件或有骑士权限的稿件 + +**正文参数( application/x-www-form-urlencoded ):** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------ | -------------- | -------------------------------- | +| access_key | str | APP登录Token | APP方式必要 | | +| type | num | 弹幕类选择 | 必要 | 1:视频弹幕 | +| oid | num | 视频CID | 必要 | | +| dmids | nums | 弹幕dmID | 必要 | 多个ID之间用`,`分隔 | +| pool | num | 操作代码 | 必要 | 0:移出字幕池
1:移入字幕池 | +| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf 校验失败
-400:请求错误
-403:访问权限不足 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例** + +将`CID=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531`移入字幕池 + +```shell +curl 'http://api.bilibili.com/x/v2/dm/edit/state'\ +--data-urlencode 'type=1'\ +--data-urlencode 'oid=145928946'\ +--data-urlencode 'pool=1'\ +--data-urlencode 'dmids=35600074482384899,39067304918515717,39082777041174531'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` + +
+查看响应示例: + +```json +{ + "code":0, + "message":"0", + "ttl":1 +} +``` + +