添加撤回弹幕与视频历史记录

danmaku/action.md

@@ -67,3 +67,46 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=62131&msg=%e5%89%8d%e6%9d%a5%e8%80%83%e5%8
 }
 ```
 
+
+
+## 撤回弹幕
+
+> http://api.bilibili.com/x/dm/recall
+
+*方式：POST*
+
+仅能撤回自己两分钟内的弹幕，且每天只有3次机会
+
+需要登录(SESSDATA)
+
+**参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容                | 必要性 | 备注 |
+| ------ | ---- | ------------------- | ------ | ---- |
+| dmid   | data | 弹幕ID              | 必要   |      |
+| cid    | data | 视频CID             | 必要   |      |
+| csrf   | data | cookies中的bili_jct | 必要   |      |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容     | 备注                                                         |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code    | num  | 返回值   | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />36301：撤回失败，弹幕发送已过2分钟<br />36302：撤回失败，弹幕已经被删除或撤回<br />36303：撤回失败，今天撤回的机会已经用完<br />**（其他错误码有待补充）** |
+| message | str  | 错误信息 | 成功后显示剩余次数                                           |
+| ttl     | num  | 1        | 作用尚不明确                                                 |
+
+**示例：**
+
+撤回视频CID为`168901231`弹幕ID为`32310301474947077`的弹幕
+
+curl -b "SESSDATA=xxx" -d "dmid=32310301474947077&cid=168901231&csrf=xxx" "http://api.bilibili.com/x/dm/recall"
+
+```json
+{
+    "code": 0,
+    "message": "撤回成功，你还有3次撤回机会"
+}
+```
+