admin/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口

Browse Source
This commit is contained in:
SocialSisterYi
2021-02-08 00:34:54 +08:00
parent c454b3a409
commit ff24146971
10 changed files with 600 additions and 274 deletions
Download Patch File Download Diff File Expand all files Collapse all files

156
comment/list.md
View File

@@ -45,19 +45,19 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------ | -------------------------------- | -------- | ---------------- |
| page | obj | 页信息 | |
| config | obj | 属性信息 | |
| replies | 禁用时：null<br />正常时：array | 评论根列表 | |
| hots | 禁用时：null<br />正常时：array | 热评根列表 | |
| config | obj | 评论区显示控制 | |
| replies | 禁用时：null<br />正常时：array | 评论列表 | |
| hots | 禁用时：null<br />正常时：array | 热评列表 | |
| upper | obj | 置顶评论 | |
| top | null | - | **作用尚不明确** |
| notice | 无效时：null<br />有效时：obj | 评论区公告信息 | |
| vote | num | 0 | **作用尚不明确** |
| blacklist | num | 0 | **作用尚不明确** |
| assist | num | 0 | **作用尚不明确** |
| mode | num | 3 | **作用尚不明确** |
| support_mode | array | ？？？ | **作用尚不明确** |
| folder | obj | ??? | **作用尚不明确** |
| lottery_card | null | - | **作用尚不明确** |
| mode | num | 评论区类型id | |
| support_mode | array | 评论区支持的类型id | |
| folder | obj | 折叠相关信息 | |
| lottery_card | null | - | **作用尚不明确** |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
@@ -72,15 +72,15 @@
`data`中的`config`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ----- | ---------------- |
| showadmin | num | 1 | **作用尚不明确** |
| showentry | num | 1 | **作用尚不明确** |
| showfloor | num | 0 | **作用尚不明确** |
| showtopic | num | 1 | **作用尚不明确** |
| show_up_flag | bool | true | **作用尚不明确** |
| read_only | bool | false | **作用尚不明确** |
| show_del_log | bool | false | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | ？ | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`replies`数组：
@@ -100,11 +100,11 @@
`data`中的`upper`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | -------- | -------------------------------------- |
| mid | num | UP主UID | |
| top | 有效时：obj<br />无效时：null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | null | - | |
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | ---------- | -------------------------------------- |
| mid | num | UP主UID | |
| top | 有效时：obj<br />无效时：null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | 有效时：obj<br />无效时：null | 投票评论？ | |
`data`中的`notice`对象：
@@ -125,11 +125,11 @@
`data`中的`folder`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------ | ---------------- |
| has_folded | bool | false | **作用尚不明确** |
| is_folded | bool | false | **作用尚不明确** |
| rule | str | ？？？ | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------------- | ---------------- |
| has_folded | bool | 评论区是否存在折叠评论 | |
| is_folded | bool | false | **作用尚不明确** |
| rule | str | 相关规则页面url | |
`data`中的`control`对象：
@@ -2362,21 +2362,21 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \
| 字段 | 类型 | 内容 | 备注 |
| ------------ | -------------------------------- | -------- | ---------------- |
| cursor | obj | 页信息 | |
| hots | 禁用时：null<br />正常时：array | 热评根列表 | |
| cursor | obj | 游标信息 | |
| hots | 禁用时：null<br />正常时：array | 热评列表 | |
| notice | 无效时：null<br />有效时：obj | 评论区公告信息 | |
| replies | 禁用时：null<br />正常时：array | 评论根列表 | |
| replies | 禁用时：null<br />正常时：array | 评论列表 | |
| top | obj | 置顶评论 | |
| lottery_card | null | - | **作用尚不明确** |
| folder | obj | ??? | **作用尚不明确** |
| lottery_card | null | 抽奖评论 | |
| folder | obj | 评论折叠信息 | |
| assist | num | 0 | **作用尚不明确** |
| blacklist | num | 0 | **作用尚不明确** |
| vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** |
| config | obj | 属性信息 | |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主信息 | |
| mode | num | 3 | **作用尚不明确** |
| support_mode | array | ？？？ | **作用尚不明确** |
| mode | num | 评论区类型id | |
| support_mode | array | 评论区支持的类型id | |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
@@ -2404,23 +2404,23 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \
`data`中的`top`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ----------------------------- | -------- | -------------------------------------- |
| admin | null | - | |
| upper | 有效时：obj<br />无效时：null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | null | - | |
| 字段 | 类型 | 内容 | 备注 |
| ----- | ----------------------------- | -------------- | -------------------------------------- |
| admin | 有效时：obj<br />无效时：null | 管理员置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| upper | 有效时：obj<br />无效时：null | UP主置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | 有效时：obj<br />无效时：null | 投票置顶条目 | [对象定义见表](readme.md#评论条目对象) |
`data`中的`config`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ----- | ---------------- |
| showadmin | num | 1 | **作用尚不明确** |
| showentry | num | 1 | **作用尚不明确** |
| showfloor | num | 0 | **作用尚不明确** |
| showtopic | num | 1 | **作用尚不明确** |
| show_up_flag | bool | true | **作用尚不明确** |
| read_only | bool | false | **作用尚不明确** |
| show_del_log | bool | false | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | ？ | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`replies`数组：
@@ -4744,7 +4744,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
| 字段 | 类型 | 内容 | 备注 |
| ------------ | -------------------------------- | -------- | ---------------- |
| config | obj | 属性信息 | |
| config | obj | 评论区显示控制 | |
| control | obj | 评论区输入属性 | |
| page | obj | 页信息 | |
| replies | array | 二级评论列表 | |
@@ -4763,15 +4763,15 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
`data`中的`config`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ----- | ---------------- |
| showadmin | num | 0 | **作用尚不明确** |
| showentry | num | 0 | **作用尚不明确** |
| showfloor | num | 0 | **作用尚不明确** |
| showtopic | num | 0 | **作用尚不明确** |
| show_up_flag | bool | false | **作用尚不明确** |
| read_only | bool | false | **作用尚不明确** |
| show_del_log | bool | false | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | ？ | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`replies`数组：
@@ -5487,7 +5487,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
| blacklist | num | 0 | **作用尚不明确** |
| vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** |
| config | obj | 属性信息 | |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主UID | |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
@@ -5505,15 +5505,15 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
`data`中的`config`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ----- | ---------------- |
| showadmin | num | 1 | **作用尚不明确** |
| showentry | num | 1 | **作用尚不明确** |
| showfloor | num | 0 | **作用尚不明确** |
| showtopic | num | 1 | **作用尚不明确** |
| show_up_flag | bool | true | **作用尚不明确** |
| read_only | bool | false | **作用尚不明确** |
| show_del_log | bool | false | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | ？ | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`upper`对象：
@@ -6246,7 +6246,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
| blacklist | num | 0 | **作用尚不明确** |
| vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** |
| config | obj | 属性信息 | |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主UID | |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
@@ -6276,15 +6276,15 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
`data`中的`config`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ----- | ---------------- |
| showadmin | num | 1 | **作用尚不明确** |
| showentry | num | 1 | **作用尚不明确** |
| showfloor | num | 0 | **作用尚不明确** |
| showtopic | num | 1 | **作用尚不明确** |
| show_up_flag | bool | true | **作用尚不明确** |
| read_only | bool | false | **作用尚不明确** |
| show_del_log | bool | false | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | ？ | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`upper`对象：

114
comment/readme.md
View File

@@ -2,7 +2,11 @@
<img src="/imgs/comment.svg" width="100" height="100"/>
评论区接口分为**查询**与**操作**两大类
评论系统为全站通用，且APP与web端接口共用，以type标明对象类型，以oid指向响应的对象id
---
**继续查看：**
- [查询类](list.md)
- [操作类](action.md)
@@ -41,24 +45,24 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ |
| rpid | num | 评论rpID | |
| oid | num | 目标评论区rpID | |
| oid | num | 评论区对象id | |
| type | num | 评论区类型代码 | **类型代码见上表** |
| mid | num | 评论发送者UID | |
| mid | num | 发送者UID | |
| 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 | 评论楼层号 | **重要：若不支持楼层则无此项** |
| count | num | 二级评论条数 | |
| rcount | num | 回复评论条数 | |
| floor | num | 评论楼层号 | **注：若不支持楼层则无此项** |
| state | num | 0 | **作用尚不明确** |
| fansgrade | num | 是否具有粉丝标签 | 0：无<br />1：有 |
| attr | num | ？？？ | **作用尚不明确** |
| attr | num | 某属性位？ | **作用尚不明确** |
| ctime | num | 评论发送时间 | 时间戳 |
| rpid_str | str | 评论rpID | 字串格式 |
| root_str | str | 根评论rpID | 字串格式 |
| parent_str | str | 回复父评论rpID | 字串格式 |
| like | num | 评论获赞数 | |
| action | num | 当前用户操作状态 | 需要登录(SESSDATA) <br />否则恒为0<br />0：无<br />1：已点赞<br />2：已点踩 |
| action | num | 当前用户操作状态 | 需要登录(Cookie或APP) <br />否则恒为0<br />0：无<br />1：已点赞<br />2：已点踩 |
| member | obj | 评论发送者信息 | |
| content | obj | 评论信息 | |
| replies | 无效时：null<br />有效时：array | 评论回复条目预览 | **仅嵌套一层**<br />否则为null |
@@ -84,9 +88,10 @@
| official_verify | obj | 发送者认证信息 | |
| vip | obj | 发送者会员信息 | |
| fans_detail | 无效时：null<br />有效时：obj | 发送者粉丝标签 | |
| following | num | 是否关注该用户 | 需要登录(SESSDATA) <br />否则恒为0<br />0：未关注<br />1：已关注 |
| is_followed | num | 是否被该用户关注 | 需要登录(SESSDATA) <br />否则恒为0<br />0：未关注<br />1：已关注 |
| 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`对象：
@@ -120,31 +125,31 @@
`member`中的`official_verify`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ------------------- |
| type | num | 是否认证 | -1：无<br />0：认证 |
| desc | str | 认证信息 | 无为空 |
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---------------------------------------- |
| 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 | 0 | **作用尚不明确** |
| label | obj | ？？？ | |
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | -------------- | --------------------------------------- |
| 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 | 会员类型 | |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ------------------------------------------------------------ |
| path | str | 空 | **作用尚不明确** |
| text | str | 会员类型文案 | |
| label_theme | str | 会员类型 | vip：大会员<br />annual_vip：年度大会员<br />ten_annual_vip：十年大会员<br />hundred_annual_vip：百年大会员 |
`member`中的`fans_detail`对象:
@@ -164,7 +169,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----------------------------- | ------------ | ---------------- |
| pendant | 无效时：null<br />有效时：obj | 头像框信息 | |
| cardbg | 无效时：null<br />有效时：obj | 评论条目装扮 | |
| cardbg | 无效时：null<br />有效时：obj | 评论卡片装扮 | |
| cardbg_with_focus | null | - | **作用尚不明确** |
`user_sailing`中的`pendant`对象：
@@ -200,15 +205,15 @@
`评论条目`中的`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 | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------------------ | ------------------------------------------------------------ |
| 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`数组：
@@ -246,21 +251,40 @@
| 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 />按照热度顺序排列 |
| 0 | obj | 回复条目1 | **为本对象的递归嵌套**<br />**仅可嵌套一层**<br />按照热度顺序排列 |
| 1 | obj | 回复条目2 | |
| 2 | obj | 回复条目3 | 最后一项 |
`评论条目`中的`folder`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------ | ---------------- |
| has_folded | bool | false | **作用尚不明确** |
| is_folded | bool | false | **作用尚不明确** |
| rule | str | ？？？ | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------------- | ---- |
| has_folded | bool | 是否有被折叠的二级评论 | |
| is_folded | bool | 评论是否被折叠 | |
| rule | str | 相关规则页面uel | |
`评论条目`中的`up_action`对象：