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

添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口

Browse Source
This commit is contained in:
SocialSisterYi
2020-10-03 00:53:53 +08:00
parent e6176a0fcd
commit 8edc21f2bf
10 changed files with 970 additions and 513 deletions
Download Patch File Download Diff File Expand all files Collapse all files

114
comment/action.md
View File

@@ -1,6 +1,6 @@
# 评论区操作
**本页所有操作均需登录（Cookie）**
**本页所有操作均需登录（Cookie或APP）**
使用该登录token识别用户身份
@@ -10,19 +10,20 @@
*请求方式：POST*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根评论rpID | 非必要 | 二级评论以上使用 |
| parent | num | 父评论rpID | 非必要 | 二级评论同根评论ID<br />大于二级评论为要回复的评论ID |
| message | str | 发送评论内容 | 必要 | 最大1000字符<br />表情使用表情转义符 |
| plat | num | 发送平台标识 | 非必要 | 1：web端<br />2：安卓客户端<br />3：ios客户端<br />4：wp客户端<br />默认为1 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根评论rpID | 非必要 | 二级评论以上使用 |
| parent | num | 父评论rpID | 非必要 | 二级评论同根评论ID<br />大于二级评论为要回复的评论ID |
| message | str | 发送评论内容 | 必要 | 最大1000字符<br />表情使用表情转义符 |
| plat | num | 发送平台标识 | 非必要 | 1：web端<br />2：安卓客户端<br />3：ios客户端<br />4：wp客户端<br />默认为1 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@@ -41,7 +42,7 @@
| -------------- | ----------------------------- | -------------- | ------------------------------------------------------------ |
| success_action | num | 0 | **作用尚不明确** |
| success_toast | str | 状态文字 | |
| need_captcha | bool | false | 评论需要验证码(未证实) |
| need_captcha | bool | false | 评论需要验证码(未证实) |
| url | str | 空 | **作用尚不明确** |
| rpid | num | 评论rpID | |
| rpid_str | str | 评论rpID | 字串格式 |
@@ -51,8 +52,8 @@
| root_str | str | 根评论rpID | 字串格式 |
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论ID<br />大于二级评论为上一级评论ID |
| parent_str | str | 回复父评论rpID | 字串格式 |
| emote | obj | 表情转义符信息 | 无表情时无此项<br />**见「[评论区明细](comment_list.md#附表-评论条目对象)」的附表** |
| reply | 有效时：obj<br />无效时：null | | **见「[评论区明细](comment_list.md#附表-评论条目对象)」的附表** |
| emote | obj | 表情转义符信息 | [对象定义见表](readme.md) |
| reply | 有效时：obj<br />无效时：null | | [对象定义见表](readme.md) |
**示例：**
@@ -233,19 +234,20 @@ curl 'http://api.bilibili.com/x/v2/reply/add'\
*请求方式：POST*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
点赞成功后会同时消去该评论的点踩
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ----------------------------------------------- |
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消赞<br />1：点赞 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ----------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消赞<br />1：点赞 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@@ -290,19 +292,20 @@ curl 'http://api.bilibili.com/x/v2/reply/action'\
*请求方式：POST*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
点踩成功后会同时消去该评论的点赞
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ----------------------------------------------- |
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消踩<br />1：点踩 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ----------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消踩<br />1：点踩 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@@ -347,18 +350,19 @@ curl 'http://api.bilibili.com/x/v2/reply/hate'\
*请求方式：POST*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
只能删除自己的评论，或自己管理的评论区下的评论
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ----------------------------------------------- |
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ----------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@@ -402,19 +406,20 @@ curl 'http://api.bilibili.com/x/v2/reply/del'\
*请求方式：POST*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
只能置顶自己管理的评论区中的一级评论
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ----------------------------------------------- |
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消置顶<br />1：设为置顶 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ----------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消置顶<br />1：设为置顶 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@@ -459,18 +464,19 @@ curl 'http://api.bilibili.com/x/v2/reply/top'\
*请求方式：POST*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | ----------------------------------------------- |
| type | num | 评论区类型代码 | 必要 | **类型代码见「[评论区明细](comment_list.md)」** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| reason | num | 举报类型 | 必要 | **类型代码见下表** |
| content | str | 其他举报备注 | 非必要 | `reason=0`时有效 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ----------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| reason | num | 举报类型 | 必要 | **类型代码见下表** |
| content | str | 其他举报备注 | 非必要 | `reason=0`时有效 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
举报类型`reason`：

374
comment/comment_list.md → comment/list.md
View File

@@ -1,52 +1,24 @@
# 点评评论区明细
# 评论区明细
<img src="/imgs/comment.svg" width="100" height="100"/>
**已知的评论区类型代码总览：**
| 代码 | 评论区类型 | 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 |
## 获取评论区明细1(web端)（无楼层号）
## 获取评论区明细1（无楼层号）
> http://api.bilibili.com/x/v2/reply
*请求方式：GET*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | -------------------------------------------------------- |
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
| oid | num | 目标评论区ID | 必要 | |
| sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1：按点赞数<br />2：按回复数 |
| nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 |
| pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ----------- | -------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1：按点赞数<br />2：按回复数 |
| nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 |
| pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
**json回复：**
@@ -2347,25 +2319,24 @@ curl -G 'http://api.bilibili.com/x/v2/reply'\
</details>
## 获取评论区明细2(APP端)（带有楼层号 ）
## 获取评论区明细2（带有楼层号 ）
> http://api.bilibili.com/x/v2/reply/main
*请求方式：GET*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | ------------------------------------------------------------ |
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
| oid | num | 目标评论区ID | 必要 | |
| mode | num | 排序方式 | 非必要 | 默认为0<br />0 3：仅按热度<br />1：按热度+按时间<br />2：仅按时间 |
| next | num | 评论页选择 | 非必要 | 按热度时：热度顺序页码（0为第一页）<br />按时间时：时间倒序楼层号<br />默认为0 |
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ----------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| mode | num | 排序方式 | 非必要 | 默认为0<br />0 3：仅按热度<br />1：按热度+按时间<br />2：仅按时间 |
| next | num | 评论页选择 | 非必要 | 按热度时：热度顺序页码（0为第一页）<br />按时间时：时间倒序楼层号<br />默认为0 |
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
**json回复：**
@@ -4728,27 +4699,26 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main'\
</details>
## 获取指定评论条目及二级回复明细1（web端）（分离结构 无楼层号）
## 获取指定评论条目及二级回复明细1（分离结构 无楼层号）
> http://api.bilibili.com/x/v2/reply/reply
*请求方式：GET*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
按照热度排列
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------------- | ------ | -------------------------- |
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 目标一级评论rpID | 必要 | |
| pn | num | 二级评论页码 | 非必要 | 默认为1 |
| ps | num | 二级评论每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------------- | ----------- | ----------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 目标一级评论rpID | 必要 | |
| pn | num | 二级评论页码 | 非必要 | 默认为1 |
| ps | num | 二级评论每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
**json回复：**
@@ -5467,25 +5437,26 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply'\
## 获取指定评论条目及二级回复明细2（APP端）（嵌套结构 带有楼层号）
## 获取指定评论条目及二级回复明细2（嵌套结构 带有楼层号）
> http://api.bilibili.com/x/v2/reply/detail
*请求方式：GET*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
按照楼层排列
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | -------------------------------------- |
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根回复rpID | 必要 | |
| next | num | 评论页选择 | 非必要 | 第一页为0<br />默认为0<br />顺序楼层号 |
| ps | num | 每页项数 | 非必要 | 默认为0 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ----------- | -------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根回复rpID | 必要 | |
| next | num | 评论页选择 | 非必要 | 第一页为0<br />默认为0<br />顺序楼层号 |
| ps | num | 每页项数 | 非必要 | 默认为0 |
**json回复：**
@@ -6223,25 +6194,26 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail'\
</details>
## 获取指定评论对话树（APP端）（带有楼层）
## 获取指定评论对话树（带有楼层）
> http://api.bilibili.com/x/v2/reply/dialog/cursor
*请求方式：GET*
认证方式：Cookie（SESSDATA）
认证方式：Cookie（SESSDATA）或APP
按照楼层排列
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | ------------------ |
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根回复rpID | 必要 | |
| dialog | num | 对话树根rpID | 必要 | |
| size | num | 每页最大项数 | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ----------- | ----------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根回复rpID | 必要 | |
| dialog | num | 对话树根rpID | 必要 | |
| size | num | 每页最大项数 | 必要 | |
**json回复：**
@@ -7095,7 +7067,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor'\
</details>
## 获取评论区评论总数（APP端）
## 获取评论区评论总数
> http://api.bilibili.com/x/v2/reply/count
@@ -7103,10 +7075,10 @@ curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor'\
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | ------------------ |
| type | num | 评论区类型代码 | 必要 | **类型代码见上表** |
| oid | num | 目标评论区ID | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | ----------------------------- |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md)** |
| oid | num | 目标评论区ID | 必要 | |
**json回复：**
@@ -7152,235 +7124,3 @@ curl -G 'http://api.bilibili.com/x/v2/reply/count'\
</details>
## 附表-评论条目对象
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ |
| rpid | num | 评论rpID | |
| oid | num | 目标评论区rpID | |
| type | num | 评论区类型代码 | **类型代码见上表** |
| 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 | 评论楼层号 | **重要：若不支持楼层则无此项** |
| 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 | 当前用户操作状态 | 需要登录(SESSDATA) <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 | 发送者UID | |
| 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 | 是否关注该用户 | 需要登录(SESSDATA) <br />否则恒为0<br />0：未关注<br />1：已关注 |
| is_followed | num | 是否被该用户关注 | 需要登录(SESSDATA) <br />否则恒为0<br />0：未关注<br />1：已关注 |
| user_sailing | obj | 发送者评论条目装扮信息 | |
`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：认证 |
| 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 | ？？？ | |
`vip`中的`label`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ---------------- |
| path | str | 空 | **作用尚不明确** |
| text | str | 会员类型信息 | |
| label_theme | str | 会员类型 | |
`member`中的`fans_detail`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | -------------------- |
| uid | num | 用户UID | |
| 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 | 简写名 | 无则无此项 |
`评论条目`中的`replies`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ------------------------------------------------------------ |
| 0 | obj | 回复条目1 | **为本对象的递归嵌套**<br />**仅嵌套一层**<br />按照热度顺序排列 |
| 1 | obj | 回复条目2 | |
| 2 | obj | 回复条目3 | 最后一项 |
`评论条目`中的`folder`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------ | ---------------- |
| has_folded | bool | false | **作用尚不明确** |
| is_folded | bool | false | **作用尚不明确** |
| rule | str | ？？？ | **作用尚不明确** |
`评论条目`中的`up_action`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ---------------- | ----------------------- |
| like | bool | 是否UP主觉得很赞 | false：否<br />true：是 |
| reply | bool | 是否被UP主回复 | false：否<br />true：是 |

268
comment/readme.md Normal file
View File

@@ -0,0 +1,268 @@
# 评论区
<img src="/imgs/comment.svg" width="100" height="100"/>
评论区接口分为**查询**与**操作**两大类
- [查询类](list.md)
- [操作类](action.md)
## 已知的评论区类型代码总览
| 代码 | 评论区类型 | 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 | 目标评论区rpID | |
| type | num | 评论区类型代码 | **类型代码见上表** |
| 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 | 评论楼层号 | **重要：若不支持楼层则无此项** |
| 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 | 当前用户操作状态 | 需要登录(SESSDATA) <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 | 发送者UID | |
| 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 | 是否关注该用户 | 需要登录(SESSDATA) <br />否则恒为0<br />0：未关注<br />1：已关注 |
| is_followed | num | 是否被该用户关注 | 需要登录(SESSDATA) <br />否则恒为0<br />0：未关注<br />1：已关注 |
| user_sailing | obj | 发送者评论条目装扮信息 | |
`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：认证 |
| 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 | ？？？ | |
`vip`中的`label`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ---------------- |
| path | str | 空 | **作用尚不明确** |
| text | str | 会员类型信息 | |
| label_theme | str | 会员类型 | |
`member`中的`fans_detail`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | -------------------- |
| uid | num | 用户UID | |
| 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 | 简写名 | 无则无此项 |
`评论条目`中的`replies`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ------------------------------------------------------------ |
| 0 | obj | 回复条目1 | **为本对象的递归嵌套**<br />**仅嵌套一层**<br />按照热度顺序排列 |
| 1 | obj | 回复条目2 | |
| 2 | obj | 回复条目3 | 最后一项 |
`评论条目`中的`folder`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------ | ---------------- |
| has_folded | bool | false | **作用尚不明确** |
| is_folded | bool | false | **作用尚不明确** |
| rule | str | ？？？ | **作用尚不明确** |
`评论条目`中的`up_action`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ---------------- | ----------------------- |
| like | bool | 是否UP主觉得很赞 | false：否<br />true：是 |
| reply | bool | 是否被UP主回复 | false：否<br />true：是 |