bilibili-API-collect/docs/comment/action.md
z0z0r4 7873a79022
Update action.md (#844)
接口返回错误代码:12077,信息:举报理由过长或过短。
2023-10-14 23:31:24 +08:00

25 KiB
Raw Blame History

评论区操作

发表评论

https://api.bilibili.com/x/v2/reply/add

请求方式POST

认证方式CookieSESSDATA或APP

正文参数( application/x-www-form-urlencoded

参数名 类型 内容 必要性 备注
access_key str APP登录Token APP方式必要
type num 评论区类型代码 必要 类型代码见表
oid num 目标评论区id 必要
root num 根评论rpid 非必要 二级评论以上使用
parent num 父评论rpid 非必要 二级评论同根评论id
大于二级评论为要回复的评论id
message str 发送评论内容 必要 最大1000字符
表情使用表情转义符
plat num 发送平台标识 非必要 1web端
2安卓客户端
3ios客户端
4wp客户端
默认为1
csrf str CSRF Token位于cookie Cookie方式必要

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-101账号未登录
-102账号被封停
-111csrf校验失败
-400请求错误
-404无此项
-509请求过于频繁
12001已经存在评论主题
12002评论区已关闭
12003禁止回复
12006没有该评论
12009评论主体的type不合法
12015需要评论验证码
12016评论内容包含敏感信息
12025评论字数过多
12035该账号被UP主列入评论黑名单
12051重复评论请勿刷屏
12052评论区已关闭
12045购买后即可发表评论
(其他错误码有待补充)
message str 错误信息
ttl num 1
data obj 数据本体

data对象:

字段 类型 内容 备注
success_action num 0 作用尚不明确
success_toast str 状态文字
need_captcha bool false 评论需要验证码(未证实)
url str 作用尚不明确
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 表情转义符信息 对象定义见表
reply 有效时obj
无效时null
对象定义见表

示例:

给视频av243322853发送内容为测试test[泠鸢yousa_awsl]的评论带有表情转义符平台标识为1web端

curl 'https://api.bilibili.com/x/v2/reply/add' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=243322853' \
--data-urlencode 'message=测试test[泠鸢yousa_awsl]' \
--data-urlencode 'plat=1' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "success_action": 0,
        "success_toast": "发送成功",
        "need_captcha": false,
        "url": "",
        "rpid": 3043212039,
        "rpid_str": "3043212039",
        "dialog": 0,
        "dialog_str": "0",
        "root": 0,
        "root_str": "0",
        "parent": 0,
        "parent_str": "0",
        "emote": {
            "[泠鸢yousa_awsl]": {
                "id": 2086,
                "package_id": 93,
                "state": 0,
                "type": 3,
                "attr": 0,
                "text": "[泠鸢yousa_awsl]",
                "url": "http://i0.hdslb.com/bfs/emote/7663b729161bd4556c2ec318c07791000743eb56.png",
                "meta": {
                    "size": 2
                },
                "mtime": 1589776042
            }
        },
        "reply": {
            "rpid": 3043212039,
            "oid": 243322853,
            "type": 1,
            "mid": 293793435,
            "root": 0,
            "parent": 0,
            "dialog": 0,
            "count": 0,
            "rcount": 0,
            "state": 0,
            "fansgrade": 0,
            "attr": 0,
            "ctime": 1592233764,
            "rpid_str": "3043212039",
            "root_str": "0",
            "parent_str": "0",
            "like": 0,
            "action": 0,
            "member": {
                "mid": "293793435",
                "uname": "社会易姐QwQ",
                "sex": "男",
                "sign": "高中技术宅一枚爱好MC&电子&8-bit音乐&数码&编程,资深猿厨",
                "avatar": "http://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
                "rank": "10000",
                "DisplayRank": "0",
                "level_info": {
                    "current_level": 5,
                    "current_min": 0,
                    "current_exp": 0,
                    "next_exp": 0
                },
                "pendant": {
                    "pid": 1888,
                    "name": "泠鸢yousa",
                    "image": "http://i0.hdslb.com/bfs/garb/item/3e66e712b8e70c6b02393c54ad5fd8d993eb39f9.png",
                    "expire": 0,
                    "image_enhance": "http://i0.hdslb.com/bfs/garb/item/3e66e712b8e70c6b02393c54ad5fd8d993eb39f9.png"
                },
                "nameplate": {
                    "nid": 0,
                    "name": "",
                    "image": "",
                    "image_small": "",
                    "level": "",
                    "condition": ""
                },
                "official_verify": {
                    "type": -1,
                    "desc": ""
                },
                "vip": {
                    "vipType": 2,
                    "vipDueDate": 1612454400000,
                    "dueRemark": "",
                    "accessStatus": 0,
                    "vipStatus": 1,
                    "vipStatusWarn": "",
                    "themeType": 0,
                    "label": {
                        "path": "",
                        "text": "年度大会员",
                        "label_theme": "annual_vip"
                    }
                },
                "fans_detail": null,
                "following": 0,
                "is_followed": 0,
                "user_sailing": {
                    "pendant": {
                        "id": 1888,
                        "name": "泠鸢yousa",
                        "image": "http://i0.hdslb.com/bfs/garb/item/3e66e712b8e70c6b02393c54ad5fd8d993eb39f9.png",
                        "jump_url": "",
                        "type": "suit"
                    },
                    "cardbg": null,
                    "cardbg_with_focus": null
                }
            },
            "content": {
                "message": "测试test[泠鸢yousa_awsl]",
                "plat": 1,
                "device": "",
                "members": [],
                "emote": {
                    "[泠鸢yousa_awsl]": {
                        "id": 2086,
                        "package_id": 93,
                        "state": 0,
                        "type": 3,
                        "attr": 0,
                        "text": "[泠鸢yousa_awsl]",
                        "url": "http://i0.hdslb.com/bfs/emote/7663b729161bd4556c2ec318c07791000743eb56.png",
                        "meta": {
                            "size": 2
                        },
                        "mtime": 1589776042
                    }
                },
                "jump_url": {},
                "max_line": 0
            },
            "replies": null,
            "assist": 0,
            "folder": {
                "has_folded": false,
                "is_folded": false,
                "rule": "https://www.bilibili.com/blackboard/foldingreply.html"
            },
            "up_action": {
                "like": false,
                "reply": false
            },
            "show_follow": false
        }
    }
}

点赞评论

https://api.bilibili.com/x/v2/reply/action

请求方式POST

认证方式CookieSESSDATA或APP

点赞成功后会同时消去该评论的点踩

正文参数( application/x-www-form-urlencoded

参数名 类型 内容 必要性 备注
access_key str APP登录Token APP方式必要
type num 评论区类型代码 必要 类型代码见表
oid num 目标评论区id 必要
rpid num 目标评论rpid 必要
action num 操作代码 非必要 默认为0
0取消赞
1点赞
csrf str CSRF Token位于cookie Cookie方式必要

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-101账号未登录
-102账号被封停
-111csrf校验失败
-400请求错误
-404无此项
-509请求过于频繁
12002评论区已关闭
12004禁止操作 赞或踩
12006没有该评论
12009评论主体的type不合法
12011不合法的赞或踩
(其他错误码有待补充)
message str 错误信息 默认为0
ttl num 1

示例:

点赞视频av243322853下评论rpid=3039053308

curl 'https://api.bilibili.com/x/v2/reply/action' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=243322853' \
--data-urlencode 'rpid=3039053308' \
--data-urlencode 'action=1' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

点踩评论

https://api.bilibili.com/x/v2/reply/hate

请求方式POST

认证方式CookieSESSDATA或APP

点踩成功后会同时消去该评论的点赞

正文参数( application/x-www-form-urlencoded

参数名 类型 内容 必要性 备注
access_key str APP登录Token APP方式必要
type num 评论区类型代码 必要 类型代码见表
oid num 目标评论区id 必要
rpid num 目标评论rpid 必要
action num 操作代码 非必要 默认为0
0取消踩
1点踩
csrf str CSRF Token位于cookie Cookie方式必要

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-101账号未登录
-102账号被封停
-111csrf校验失败
-400请求错误
-404无此项
-509请求过于频繁
12002评论区已关闭
12004禁止操作 赞或踩
12006没有该评论
12009评论主体的type不合法
12011不合法的赞或踩
(其他错误码有待补充)
message str 错误信息 默认为0
ttl num 1

示例:

点踩视频av243322853下评论rpid=3039053308

curl 'https://api.bilibili.com/x/v2/reply/hate' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=243322853' \
--data-urlencode 'rpid=3039053308' \
--data-urlencode 'action=1' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

删除评论

https://api.bilibili.com/x/v2/reply/del

请求方式POST

认证方式CookieSESSDATA或APP

只能删除自己的评论,或自己管理的评论区下的评论

正文参数( application/x-www-form-urlencoded

参数名 类型 内容 必要性 备注
access_key str APP登录Token APP方式必要
type num 评论区类型代码 必要 类型代码见表
oid num 目标评论区id 必要
rpid num 目标评论rpid 必要
csrf str CSRF Token位于cookie Cookie方式必要

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-101账号未登录
-102账号被封停
-111csrf校验失败
-400请求错误
-403权限不足
-404无此项
-509请求过于频繁
12002评论区已关闭
12009评论主体的type不合法
12022已经被删除了
(其他错误码有待补充)
message str 错误信息 默认为0
ttl num 1 作用尚不明确

示例:

删除av243322853下评论rpid=3039053308

curl 'https://api.bilibili.com/x/v2/reply/del' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=243322853' \
--data-urlencode 'rpid=3039053308' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

置顶评论

https://api.bilibili.com/x/v2/reply/top

请求方式POST

认证方式CookieSESSDATA或APP

只能置顶自己管理的评论区中的一级评论

正文参数( application/x-www-form-urlencoded

参数名 类型 内容 必要性 备注
access_key str APP登录Token APP方式必要
type num 评论区类型代码 必要 类型代码见表
oid num 目标评论区id 必要
rpid num 目标评论rpid 必要
action num 操作代码 非必要 默认为0
0取消置顶
1设为置顶
csrf str CSRF Token位于cookie Cookie方式必要

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-101账号未登录
-102账号被封停
-111csrf校验失败
-400请求错误
-403权限不足
-404无此项
-509请求过于频繁
12002评论区已关闭
12006没有该评论
12009评论主体的type不合法
12029已经有置顶评论
12030不能置顶非一级评论
(其他错误码有待补充)
message str 错误信息 默认为0
ttl num 1

示例:

置顶视频av243322853下评论rpid=2940645593

curl 'https://api.bilibili.com/x/v2/reply/top' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=243322853' \
--data-urlencode 'rpid=2940645593' \
--data-urlencode 'action=1' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

举报评论

https://api.bilibili.com/x/v2/reply/report

请求方式POST

认证方式CookieSESSDATA或APP

正文参数( application/x-www-form-urlencoded

参数名 类型 内容 必要性 备注
access_key str APP登录Token APP方式必要
type num 评论区类型代码 必要 类型代码见表
oid num 目标评论区id 必要
rpid num 目标评论rpid 必要
reason num 举报类型 必要 类型代码见下表
content str 其他举报备注 非必要 reason=0时有效
csrf str CSRF Token位于cookie Cookie方式必要

举报类型reason

代码 含义
0 其他
1 垃圾广告
2 色情
3 刷屏
4 引战
5 剧透
6 政治
7 人身攻击
8 内容不相关
9 违法违规
10 低俗
11 非法网站
12 赌博诈骗
13 传播不实信息
14 怂恿教唆信息
15 侵犯隐私
16 抢楼
17 青少年不良信息

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-101账号未登录
-102账号被封停
-111csrf校验失败
-400请求错误
-403权限不足
-404无此项
-500服务器错误
-509请求过于频繁
12002评论区已关闭
12006没有该评论
12008已经举报过了
12009评论主体的type不合法
12019举报过于频繁
12077其他举报理由过长或过短
(其他错误码有待补充)
message str 错误信息 默认为0
ttl num 1

示例:

举报视频av752881391下评论rpid=3062537442,理由是引战

curl 'https://api.bilibili.com/x/v2/reply/report' \
--data-urlencode 'type=1' \
--data-urlencode 'oid=752881391' \
--data-urlencode 'rpid=3062537442' \
--data-urlencode 'reason=4' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1
}