diff --git a/comment/action.md b/comment/action.md index 5334b7e..f7fb50d 100644 --- a/comment/action.md +++ b/comment/action.md @@ -14,8 +14,8 @@ | ------- | ---- | ------------------- | ------ | ------------------------------------------------------------ | | type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** | | oid | num | 目标评论区ID | 必要 | | -| root | num | 根评论ID | 非必要 | 二级评论以上使用 | -| parent | num | 夫评论ID | 非必要 | 二级评论同根评论ID
大于二级评论为要回复的评论ID | +| root | num | 根评论rpID | 非必要 | 二级评论以上使用 | +| parent | num | 父评论rpID | 非必要 | 二级评论同根评论ID
大于二级评论为要回复的评论ID | | message | str | 发送评论内容 | 必要 | 最大1000字符
表情使用表情转义符 | | plat | num | 发送平台标识 | 非必要 | 1：web端
2：安卓客户端
3：ios客户端
4：wp客户端
默认为1 | | csrf | str | cookies中的bili_jct | 必要 | | @@ -39,14 +39,14 @@ | success_toast | str | 状态文字 | | | need_captcha | bool | false | **作用尚不明确** | | url | str | 空 | **作用尚不明确** | -| rpid | num | 评论ID | | -| rpid_str | str | 评论ID | | -| dialog | num | 回复对方ID | 若为一级评论则为0
若为二级评论则为该评论ID
大于二级评论为上一级评论ID | -| dialog_str | str | 回复对方ID | | -| root | num | 根评论ID | 若为一级评论则为0
大于一级评论则为根评论ID | -| root_str | str | 根评论ID | | -| parent | num | 回复父评论ID | 若为一级评论则为0
若为二级评论则为根评论ID
大于二级评论为上一级评论ID | -| parent_str | str | 回复父评论ID | | +| rpid | num | 评论rpID | | +| rpid_str | str | 评论rpID | 字串格式 | +| dialog | num | 回复对方rpID | 若为一级评论则为0
若为二级评论则为该评论ID
大于二级评论为上一级评论ID | +| dialog_str | str | 回复对方rpID | 字串格式 | +| root | num | 根评论rpID | 若为一级评论则为0
大于一级评论则为根评论ID | +| root_str | str | 根评论rpID | 字串格式 | +| parent | num | 回复父评论rpID | 若为一级评论则为0
若为二级评论则为根评论ID
大于二级评论为上一级评论ID | +| parent_str | str | 回复父评论rpID | 字串格式 | | emote | obj | 表情转义符信息 | 无表情时无此项
**见「[评论区明细](comment_list.md#附表-评论条目对象)」的附表** | | reply | 有效时：obj
无效时：null | | **见「[评论区明细](comment_list.md#附表-评论条目对象)」的附表** | @@ -226,7 +226,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&message=%E6%B5%8B%E8%AF%95test%5 | ------ | ---- | ------------------- | ------ | ----------------------------------------------- | | type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** | | oid | num | 目标评论区ID | 必要 | | -| rpid | num | 目标评论ID | 必要 | | +| rpid | num | 目标评论rpID | 必要 | | | action | num | 操作代码 | 非必要 | 默认为0
0：取消赞
1：点赞 | | csrf | str | cookies中的bili_jct | 必要 | | @@ -242,7 +242,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&message=%E6%B5%8B%E8%AF%95test%5 **示例：** -点赞视频`av243322853`下评论`3039053308` +点赞视频`av243322853`下评论`rpID=3039053308` curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&action=1&csrf=xxx" "http://api.bilibili.com/x/v2/reply/action" @@ -270,7 +270,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&action=1&csrf=xx | ------ | ---- | ------------------- | ------ | ----------------------------------------------- | | type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** | | oid | num | 目标评论区ID | 必要 | | -| rpid | num | 目标评论ID | 必要 | | +| rpid | num | 目标评论rpID | 必要 | | | action | num | 操作代码 | 非必要 | 默认为0
0：取消踩
1：点踩 | | csrf | str | cookies中的bili_jct | 必要 | | @@ -286,7 +286,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&action=1&csrf=xx **示例：** -点踩视频`av243322853`下评论`3039053308` +点踩视频`av243322853`下评论`rpID=3039053308` curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&action=1&csrf=xxx" "http://api.bilibili.com/x/v2/reply/hate" @@ -298,3 +298,46 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&action=1&csrf=xx } ``` + + +## 删除评论 + +> http://api.bilibili.com/x/v2/reply/del + +*方式：POST* + +只能删除自己的评论，或自己管理的评论区下的评论 + +**正文参数（ application/x-www-form-urlencoded ）：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------------- | ------ | ----------------------------------------------- | +| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** | +| oid | num | 目标评论区ID | 必要 | | +| rpid | num | 目标评论rpID | 必要 | | +| csrf | str | cookies中的bili_jct | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-403：权限不足
-404：无此项
12002：评论区已关闭
12009：评论主体的type不合法
12022：已经被删除了
**（其他错误码有待补充）** | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | **作用尚不明确** | + +**示例：** + +删除`av243322853`下评论`rpID=3039053308` + +curl -b "SESSDATA=xxx" -d "type=1&oid=3039053308&csrf=xxx" "http://api.bilibili.com/x/v2/reply/del" + +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + diff --git a/comment/comment_list.md b/comment/comment_list.md index 52a6db6..5edc760 100644 --- a/comment/comment_list.md +++ b/comment/comment_list.md @@ -4703,7 +4703,7 @@ http://api.bilibili.com/x/v2/reply/main?type=1&oid=2&mode=3&next=0&ps=5 | ------ | ---- | ---------------- | ------ | -------------------------- | | type | num | 评论区类型代码 | 必要 | **类型代码见上表** | | oid | num | 目标评论区ID | 必要 | | -| root | num | 目标评论ID | 必要 | | +| root | num | 目标一级评论rpID | 必要 | | | pn | num | 二级评论页码 | 非必要 | 默认为1 | | ps | num | 二级评论每页项数 | 非必要 | 默认为20
定义域：1-49 | @@ -4767,7 +4767,7 @@ http://api.bilibili.com/x/v2/reply/main?type=1&oid=2&mode=3&next=0&ps=5 **示例：** -获取视频`av2`下评论`476670`的二级评论，每页5项，查看第1页 +获取视频`av2`下评论`rpID=476670`的二级评论，每页5项，查看第1页 http://api.bilibili.com/x/v2/reply/reply?type=1&oid=2&root=476670&pn=1&ps=5 @@ -5414,17 +5414,17 @@ http://api.bilibili.com/x/v2/reply/reply?type=1&oid=2&root=476670&pn=1&ps=5 -## 附表-评论条目对象： +## 附表-评论条目对象 | 字段 | 类型 | 内容 | 备注 | | ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ | -| rpid | num | 评论ID | | -| oid | num | 目标评论区ID | | +| rpid | num | 评论rpID | | +| oid | num | 目标评论区rpID | | | type | num | 评论区类型代码 | **类型代码见上表** | | mid | num | 评论发送者UID | | -| root | num | 根评论ID | 若为一级评论则为0
大于一级评论则为根评论ID | -| parent | num | 回复父评论ID | 若为一级评论则为0
若为二级评论则为根评论ID
大于二级评论为上一级评论ID | -| dialog | num | 回复对方ID | 若为一级评论则为0
若为二级评论则为该评论ID
大于二级评论为上一级评论ID | +| root | num | 根评论rpID | 若为一级评论则为0
大于一级评论则为根评论ID | +| parent | num | 回复父评论rpID | 若为一级评论则为0
若为二级评论则为根评论rpID
大于二级评论为上一级评论rpID | +| dialog | num | 回复对方rpID | 若为一级评论则为0
若为二级评论则为该评论rpID
大于二级评论为上一级评论rpID | | count | num | 评论回复条数 | | | rcount | num | 评论回复条数 | | | floor | num | 评论楼层号 | **重要：若不支持楼层则无此项** | @@ -5432,9 +5432,9 @@ http://api.bilibili.com/x/v2/reply/reply?type=1&oid=2&root=476670&pn=1&ps=5 | fansgrade | num | 是否具有粉丝标签 | 0：无
1：有 | | attr | num | ？？？ | **作用尚不明确** | | ctime | num | 评论发送时间 | 时间戳 | -| rpid_str | str | 评论ID | | -| root_str | str | 根评论ID | | -| parent_str | str | 回复父评论ID | | +| rpid_str | str | 评论rpID | 字串格式 | +| root_str | str | 根评论rpID | 字串格式 | +| parent_str | str | 回复父评论rpID | 字串格式 | | like | num | 评论获赞数 | | | action | num | 当前用户操作状态 | 需要登录(SESSDATA)
否则恒为0
0：无
1：已点赞
2：已点踩 | | member | obj | 评论发送者信息 | | diff --git a/danmaku/action.md b/danmaku/action.md index 5972531..b8949bf 100644 --- a/danmaku/action.md +++ b/danmaku/action.md @@ -38,12 +38,12 @@ `data`对象： -| 字段 | 类型 | 内容 | 备注 | -| -------- | ---- | ------ | ------------ | -| action | str | 空 | 作用尚不明确 | -| dmid | num | 弹幕ID | | -| dmid_str | str | 弹幕ID | 字串形式 | -| visible | bool | true | 作用尚不明确 | +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | -------- | ------------ | +| action | str | 空 | 作用尚不明确 | +| dmid | num | 弹幕dmID | | +| dmid_str | str | 弹幕dmID | 字串形式 | +| visible | bool | true | 作用尚不明确 | **示例：** @@ -83,7 +83,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=62131&msg=%e5%89%8d%e6%9d%a5%e8%80%83%e5%8 | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------- | ------ | ---- | -| dmid | num | 弹幕ID | 必要 | | +| dmid | num | 弹幕dmID | 必要 | | | cid | num | 视频CID | 必要 | | | csrf | str | cookies中的bili_jct | 必要 | | diff --git a/danmaku/danmaku_list.md b/danmaku/danmaku_list.md index 7497f12..5a59cc5 100644 --- a/danmaku/danmaku_list.md +++ b/danmaku/danmaku_list.md @@ -101,8 +101,8 @@ http://comment.bilibili.com/144541892.xml | 3 | 弹幕颜色 | int | 十进制RGB888值 | | 4 | 弹幕发送时间 | int | 时间戳 | | 5 | 弹幕池类型 | int | 0普通池
1字幕池
2特殊池（高级弹幕） | -| 6 | 编码后的用户ID | HEX | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户ID | -| 7 | 弹幕ID | int | 唯一 可用于操作参数 | +| 6 | 编码后的用户UID | HEX | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户ID | +| 7 | 弹幕dmID | int | 唯一 可用于操作参数 | ```xml 从结尾回来看这里，更感动了！