mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2024-12-29 14:00:09 +08:00
294 lines
20 KiB
Markdown
294 lines
20 KiB
Markdown
# 评论区
|
||
|
||
<img src="/imgs/comment.svg" width="100" height="100"/>
|
||
|
||
评论系统为全站通用，且APP与web端接口共用，以type标明对象类型，以oid指向响应的对象id
|
||
|
||
---
|
||
|
||
**继续查看：**
|
||
|
||
- [查询类](list.md)
|
||
- [操作类](action.md)
|
||
|
||
## 评论区类型代码
|
||
|
||
（PS：以下部分内容来源不明，有待验证）
|
||
|
||
| 代码 | 评论区类型 | oid的意义 |
|
||
| ---- | ----------------------- | ---------- |
|
||
| 1 | 视频稿件 | 稿件avid |
|
||
| 2 | 话题 | 话题id |
|
||
| 4 | 活动 | 活动id |
|
||
| 5 | 小视频 | 小视频id |
|
||
| 6 | 小黑屋封禁信息 | 封禁公示id |
|
||
| 7 | 公告信息 | 公告id |
|
||
| 8 | 直播活动 | 直播间id |
|
||
| 9 | 活动稿件 | |
|
||
| 10 | 直播公告 | |
|
||
| 11 | 相簿（图片动态） | 相簿id |
|
||
| 12 | 专栏 | 专栏cvid |
|
||
| 13 | 票务 | |
|
||
| 14 | 音频 | 音频auid |
|
||
| 15 | 风纪委员会 | 众裁项目id |
|
||
| 16 | 点评 | |
|
||
| 17 | 动态（纯文字动态&分享） | 动态id |
|
||
| 18 | 播单 | |
|
||
| 19 | 音乐播单 | |
|
||
| 20 | 漫画 | |
|
||
| 21 | 漫画 | |
|
||
| 22 | 漫画 | 漫画mcid |
|
||
| 33 | 课程 | 课程epid |
|
||
|
||
## 评论条目对象
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ |
|
||
| rpid | num | 评论rpid | |
|
||
| oid | num | 评论区对象id | |
|
||
| type | num | 评论区类型代码 | **类型代码见上表** |
|
||
| mid | num | 发送者mid | |
|
||
| root | num | 根评论rpid | 若为一级评论则为0<br />大于一级评论则为根评论id |
|
||
| parent | num | 回复父评论rpid | 若为一级评论则为0<br />若为二级评论则为根评论rpid<br />大于二级评论为上一级评论rpid |
|
||
| dialog | num | 回复对方rpid | 若为一级评论则为0<br />若为二级评论则为该评论rpid<br />大于二级评论为上一级评论rpid |
|
||
| count | num | 二级评论条数 | |
|
||
| rcount | num | 回复评论条数 | |
|
||
| floor | num | 评论楼层号 | **注：若不支持楼层则无此项** |
|
||
| state | num | 0 | **作用尚不明确** |
|
||
| fansgrade | num | 是否具有粉丝标签 | 0：无<br />1：有 |
|
||
| attr | num | 某属性位？ | **作用尚不明确** |
|
||
| ctime | num | 评论发送时间 | 时间戳 |
|
||
| rpid_str | str | 评论rpid | 字串格式 |
|
||
| root_str | str | 根评论rpid | 字串格式 |
|
||
| parent_str | str | 回复父评论rpid | 字串格式 |
|
||
| like | num | 评论获赞数 | |
|
||
| action | num | 当前用户操作状态 | 需要登录(Cookie或APP) <br />否则恒为0<br />0：无<br />1：已点赞<br />2：已点踩 |
|
||
| member | obj | 评论发送者信息 | |
|
||
| content | obj | 评论信息 | |
|
||
| replies | 无效时：null<br />有效时：array | 评论回复条目预览 | **仅嵌套一层**<br />否则为null |
|
||
| assist | num | | **作用尚不明确** |
|
||
| folder | obj | ？？？ | |
|
||
| up_action | obj | 评论UP主操作信息 | |
|
||
| show_follow | bool | false | **作用尚不明确** |
|
||
|
||
`评论条目`中的`member`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| --------------- | ----------------------------- | ---------------------- | ------------------------------------------------------------ |
|
||
| mid | str | 发送者mid | |
|
||
| uname | str | 发送者昵称 | |
|
||
| sex | str | 发送者性别 | 男 女 保密 |
|
||
| sign | str | 发送者签名 | |
|
||
| avatar | str | 发送者头像 | |
|
||
| rank | str | 10000 | **作用尚不明确** |
|
||
| DisplayRank | str | 0 | **作用尚不明确** |
|
||
| level_info | obj | 发送者等级 | |
|
||
| pendant | obj | 发送者头像框信息 | |
|
||
| nameplate | obj | 发送者勋章信息 | |
|
||
| official_verify | obj | 发送者认证信息 | |
|
||
| vip | obj | 发送者会员信息 | |
|
||
| fans_detail | 无效时：null<br />有效时：obj | 发送者粉丝标签 | |
|
||
| following | num | 是否关注该用户 | 需要登录(Cookie或APP) <br />否则恒为0<br />0：未关注<br />1：已关注 |
|
||
| is_followed | num | 是否被该用户关注 | 需要登录(Cookie或APP) <br />否则恒为0<br />0：未关注<br />1：已关注 |
|
||
| user_sailing | obj | 发送者评论条目装扮信息 | |
|
||
| is_contractor | bool | 是否为合作用户？ | |
|
||
|
||
`member`中的`level_info`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------- | ---- | -------- | ---------------- |
|
||
| current_level | num | 用户等级 | |
|
||
| current_min | num | 0 | **作用尚不明确** |
|
||
| current_exp | num | 0 | **作用尚不明确** |
|
||
| next_exp | num | 0 | **作用尚不明确** |
|
||
|
||
`member`中的`pendant`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------- | ---- | ------------- | -------------------- |
|
||
| pid | num | 头像框id | **详细说明有待补充** |
|
||
| name | str | 头像框名称 | |
|
||
| image | str | 头像框图片url | |
|
||
| expire | num | 0 | **作用尚不明确** |
|
||
| image_enhance | str | 头像框图片url | |
|
||
|
||
`member`中的`nameplate`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----------- | ---- | ---------------- | -------------------- |
|
||
| nid | num | 勋章id | **详细说明有待补充** |
|
||
| name | str | 勋章名称 | |
|
||
| image | str | 挂件图片url 正常 | |
|
||
| image_small | str | 勋章图片url 小 | |
|
||
| level | str | 勋章等级 | |
|
||
| condition | str | 勋章条件 | |
|
||
|
||
`member`中的`official_verify`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | -------- | ---------------------------------------- |
|
||
| type | num | 是否认证 | -1：无<br />0：个人认证<br />1：机构认证 |
|
||
| desc | str | 认证信息 | 无为空 |
|
||
|
||
`member`中的`vip`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------- | ---- | -------------- | --------------------------------------- |
|
||
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年以上会员 |
|
||
| vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 |
|
||
| dueRemark | str | 空 | **作用尚不明确** |
|
||
| accessStatus | num | 0 | **作用尚不明确** |
|
||
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
|
||
| vipStatusWarn | str | 空 | **作用尚不明确** |
|
||
| theme_type | num | 会员样式id | |
|
||
| label | obj | 会员铭牌样式 | |
|
||
|
||
`vip`中的`label`对象:
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----------- | ---- | ------------ | ------------------------------------------------------------ |
|
||
| path | str | 空 | **作用尚不明确** |
|
||
| text | str | 会员类型文案 | |
|
||
| label_theme | str | 会员类型 | vip：大会员<br />annual_vip：年度大会员<br />ten_annual_vip：十年大会员<br />hundred_annual_vip：百年大会员 |
|
||
|
||
`member`中的`fans_detail`对象:
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------- | ---- | ------------ | -------------------- |
|
||
| uid | num | 用户mid | |
|
||
| medal_id | num | 粉丝标签id | **详细说明有待补充** |
|
||
| medal_name | str | 粉丝标签名 | |
|
||
| score | num | 0 | **作用尚不明确** |
|
||
| level | num | 当前标签等级 | |
|
||
| intimacy | num | 0 | **作用尚不明确** |
|
||
| master_status | num | 1 | **作用尚不明确** |
|
||
| is_receive | num | 1 | **作用尚不明确** |
|
||
|
||
`member`中的`user_sailing`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----------------- | ----------------------------- | ------------ | ---------------- |
|
||
| pendant | 无效时：null<br />有效时：obj | 头像框信息 | |
|
||
| cardbg | 无效时：null<br />有效时：obj | 评论卡片装扮 | |
|
||
| cardbg_with_focus | null | - | **作用尚不明确** |
|
||
|
||
`user_sailing`中的`pendant`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------- | ---- | ------------- | ------------------------------------- |
|
||
| id | num | 头像框id | |
|
||
| name | str | 头像框名称 | |
|
||
| image | str | 头像框图片url | |
|
||
| jump_url | str | 空 | |
|
||
| type | str | 装扮类型 | suit：一般装扮<br />vip_suit：vip装扮 |
|
||
|
||
`user_sailing`中的`cardbg`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------- | ---- | ----------------------- | ------------------------------------- |
|
||
| id | num | 评论条目装扮id | |
|
||
| name | str | 评论条目装扮名称 | |
|
||
| image | str | 评论条目装扮图片url | |
|
||
| jump_url | str | 评论条目装扮商城页面url | |
|
||
| fan | obj | 粉丝专属信息 | |
|
||
| type | str | 装扮类型 | suit：一般装扮<br />vip_suit：vip装扮 |
|
||
|
||
`cardbg`中的`fan`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------- | ---- | ------------------ | ---------------- |
|
||
| is_fan | num | 是否为粉丝专属装扮 | 0：否<br />1：是 |
|
||
| number | num | 粉丝专属编号 | |
|
||
| color | str | 数字颜色 | 颜色码 |
|
||
| name | str | 装扮名称 | |
|
||
| num_desc | str | 粉丝专属编号 | 字串格式 |
|
||
|
||
`评论条目`中的`content`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------- | ----- | ------------------ | ------------------------------------------------------------ |
|
||
| message | str | 评论内容 | **重要** |
|
||
| plat | num | 评论发送端 | 1：web端<br />2：安卓客户端<br />3：ios客户端<br />4：wp客户端 |
|
||
| device | str | 评论发送平台设备 | |
|
||
| members | array | at到的用户信息 | |
|
||
| emote | obj | 需要渲染的表情转义 | 评论内容无表情则无此项 |
|
||
| jump_url | obj | 需要高亮的超链转义 | |
|
||
| max_line | num | 6 | 收起最大行数 |
|
||
|
||
`content`中的`members`数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | --------------- | -------------------------------- |
|
||
| 0 | obj | at到的用户1 | 基本同`评论条目`中的`member`对象 |
|
||
| n | obj | at到的用户(n+1) | 项数为at到的不同的用户数 |
|
||
| …… | obj | …… | …… |
|
||
|
||
`content`中的`emote`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------ | ---- | --------------- | -------- |
|
||
| {表情转义符} | obj | 表情转义符信息1 | |
|
||
| …… | obj | 表情转义符信息n | 向下扩展 |
|
||
|
||
`emote`中的`{表情转义符}`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ---------- | ---- | ------------ | -------------------------------------------------------- |
|
||
| id | num | 表情id | |
|
||
| package_id | num | 表情包id | |
|
||
| state | num | 0 | |
|
||
| type | num | 表情类型 | 1：免费<br />2：会员专属<br />3：购买所得<br />4：颜文字 |
|
||
| attr | num | 0 | **作用尚不明确** |
|
||
| text | str | 表情转义符 | |
|
||
| url | str | 表情图片url | |
|
||
| meta | obj | 属性信息 | |
|
||
| mtime | num | 表情创建时间 | 时间戳 |
|
||
|
||
`{表情转义符}`中的`meta`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ---- | ------------ | ---------------- |
|
||
| size | num | 表情尺寸信息 | 1：小<br />2：大 |
|
||
| alias | str | 简写名 | 无则无此项 |
|
||
|
||
`content`中的`jump_url`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ---------- | ---- | ------------- | -------- |
|
||
| {超链转义} | obj | 超链转义信息1 | |
|
||
| …… | obj | 超链转义信息n | 向下扩展 |
|
||
|
||
`jump_url`中的`{超链转义}`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------------- | ---- | ------- | ---- |
|
||
| title | str | 标题 | |
|
||
| state | num | 图标url | |
|
||
| prefixIcon | str | | |
|
||
| appUrlSchema | str | | |
|
||
| appName | str | | |
|
||
| appPackageName | str | | |
|
||
| clickReport | str | 上报id | |
|
||
|
||
`评论条目`中的`replies`数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | --------- | ------------------------------------------------------------ |
|
||
| 0 | obj | 回复条目1 | **为本对象的递归嵌套**<br />**仅可嵌套一层**<br />按照热度顺序排列 |
|
||
| 1 | obj | 回复条目2 | |
|
||
| 2 | obj | 回复条目3 | 最后一项 |
|
||
|
||
`评论条目`中的`folder`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ---------- | ---- | ---------------------- | ---- |
|
||
| has_folded | bool | 是否有被折叠的二级评论 | |
|
||
| is_folded | bool | 评论是否被折叠 | |
|
||
| rule | str | 相关规则页面uel | |
|
||
|
||
`评论条目`中的`up_action`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ---- | ---------------- | ----------------------- |
|
||
| like | bool | 是否UP主觉得很赞 | false：否<br />true：是 |
|
||
| reply | bool | 是否被UP主回复 | false：否<br />true：是 | |