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

统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档

Browse Source
This commit is contained in:
社会易姐QwQ
2021-07-12 21:31:27 +08:00
parent 3512adf59d
commit a7a743dffd
87 changed files with 1027 additions and 978 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
comment/action.md
View File

@@ -23,9 +23,9 @@
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根评论rpID | 非必要 | 二级评论以上使用 |
| parent | num | 父评论rpID | 非必要 | 二级评论同根评论ID<br />大于二级评论为要回复的评论ID |
| 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方式必要 | |
@@ -49,14 +49,14 @@
| success_toast | str | 状态文字 | |
| need_captcha | bool | false | 评论需要验证码(未证实) |
| url | str | 空 | **作用尚不明确** |
| rpid | num | 评论rpID | |
| rpid_str | str | 评论rpID | 字串格式 |
| dialog | num | 回复对方rpID | 若为一级评论则为0<br />若为二级评论则为该评论ID<br />大于二级评论为上一级评论ID |
| dialog_str | str | 回复对方rpID | 字串格式 |
| root | num | 根评论rpID | 若为一级评论则为0<br />大于一级评论则为根评论ID |
| root_str | str | 根评论rpID | 字串格式 |
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论ID<br />大于二级评论为上一级评论ID |
| parent_str | str | 回复父评论rpID | 字串格式 |
| rpid | num | 评论rpid | |
| rpid_str | str | 评论rpid | 字串格式 |
| dialog | num | 回复对方rpid | 若为一级评论则为0<br />若为二级评论则为该评论id<br />大于二级评论为上一级评论id |
| dialog_str | str | 回复对方rpid | 字串格式 |
| root | num | 根评论rpid | 若为一级评论则为0<br />大于一级评论则为根评论id |
| root_str | str | 根评论rpid | 字串格式 |
| parent | num | 回复父评论rpid | 若为一级评论则为0<br />若为二级评论则为根评论id<br />大于二级评论为上一级评论id |
| parent_str | str | 回复父评论rpid | 字串格式 |
| emote | obj | 表情转义符信息 | [对象定义见表](readme.md#评论条目对象) |
| reply | 有效时：obj<br />无效时：null | | [对象定义见表](readme.md#评论条目对象) |
@@ -249,8 +249,8 @@ curl 'http://api.bilibili.com/x/v2/reply/add' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpid | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消赞<br />1：点赞 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@@ -266,7 +266,7 @@ curl 'http://api.bilibili.com/x/v2/reply/add' \
**示例：**
点赞视频`av243322853`下评论`rpID=3039053308`
点赞视频`av243322853`下评论`rpid=3039053308`
```shell
curl 'http://api.bilibili.com/x/v2/reply/action' \
@@ -307,8 +307,8 @@ curl 'http://api.bilibili.com/x/v2/reply/action' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpid | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消踩<br />1：点踩 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@@ -324,7 +324,7 @@ curl 'http://api.bilibili.com/x/v2/reply/action' \
**示例：**
点踩视频`av243322853`下评论`rpID=3039053308`
点踩视频`av243322853`下评论`rpid=3039053308`
```shell
curl 'http://api.bilibili.com/x/v2/reply/hate' \
@@ -365,8 +365,8 @@ curl 'http://api.bilibili.com/x/v2/reply/hate' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@@ -381,7 +381,7 @@ curl 'http://api.bilibili.com/x/v2/reply/hate' \
**示例：**
删除`av243322853`下评论`rpID=3039053308`
删除`av243322853`下评论`rpid=3039053308`
```shell
curl 'http://api.bilibili.com/x/v2/reply/del' \
@@ -421,8 +421,8 @@ curl 'http://api.bilibili.com/x/v2/reply/del' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpid | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消置顶<br />1：设为置顶 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@@ -438,7 +438,7 @@ curl 'http://api.bilibili.com/x/v2/reply/del' \
**示例：**
置顶视频`av243322853`下评论`rpID=2940645593`
置顶视频`av243322853`下评论`rpid=2940645593`
```shell
curl 'http://api.bilibili.com/x/v2/reply/top' \
@@ -477,8 +477,8 @@ curl 'http://api.bilibili.com/x/v2/reply/top' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpid | 必要 | |
| reason | num | 举报类型 | 必要 | **类型代码见下表** |
| content | str | 其他举报备注 | 非必要 | `reason=0`时有效 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@@ -518,7 +518,7 @@ curl 'http://api.bilibili.com/x/v2/reply/top' \
**示例：**
举报视频` av752881391 `下评论`rpID=3062537442`，理由是`引战`
举报视频` av752881391 `下评论`rpid=3062537442`，理由是`引战`
```shell
curl 'http://api.bilibili.com/x/v2/reply/report' \

46
comment/list.md
View File

@@ -23,7 +23,7 @@
| ---------- | ---- | -------------- | ----------- | -------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1：按点赞数<br />2：按回复数 |
| nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 |
| pn | num | 页码 | 非必要 | 默认为1 |
@@ -102,7 +102,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | ---------- | -------------------------------------- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
| top | 有效时：obj<br />无效时：null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | 有效时：obj<br />无效时：null | 投票评论？ | |
@@ -111,7 +111,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | --------------- | ---- |
| content | str | 公告正文 | |
| id | num | 公告ID | |
| id | num | 公告id | |
| link | str | 公告页面链接url | |
| title | str | 公告标题 | |
@@ -2342,7 +2342,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \
| ---------- | ---- | -------------- | ----------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | |
| 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 |
@@ -2442,14 +2442,14 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
`data`中的`notice`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | --------------- | ---- |
| content | str | 公告正文 | |
| id | num | 公告ID | |
| id | num | 公告id | |
| link | str | 公告页面链接url | |
| title | str | 公告标题 | |
@@ -4724,8 +4724,8 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
| ---------- | ---- | ---------------- | ----------- | ---------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 目标一级评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| root | num | 目标一级评论rpid | 必要 | |
| pn | num | 二级评论页码 | 非必要 | 默认为1 |
| ps | num | 二级评论每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
@@ -4750,7 +4750,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
| replies | array | 二级评论列表 | |
| root | obj | 根评论 | [对象定义见表](readme.md#评论条目对象) |
| show_bvid | bool | true | **作用尚不明确** |
| upper | obj | UP主UID | |
| upper | obj | UP主mid | |
`data`中的`page`对象：
@@ -4785,11 +4785,11 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
**示例：**
获取视频`av2`下评论`rpID=476670`的二级评论，每页5项，查看第1页
获取视频`av2`下评论`rpid=476670`的二级评论，每页5项，查看第1页
```shell
curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
@@ -5462,8 +5462,8 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
| ---------- | ---- | -------------- | ----------- | ---------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根回复rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| root | num | 根回复rpid | 必要 | |
| next | num | 评论页选择 | 非必要 | 第一页为0<br />默认为0<br />顺序楼层号 |
| ps | num | 每页项数 | 非必要 | 默认为0 |
@@ -5488,7 +5488,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
| vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主UID | |
| upper | obj | UP主mid | |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
| root | obj | 根评论 | [对象定义见表](readme.md#评论条目对象) |
@@ -5519,7 +5519,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
`data`中的`control`对象：
@@ -5537,7 +5537,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
**示例：**
获取视频`av2`下评论`rpID=476670`的二级评论，每页5项，查看第1页
获取视频`av2`下评论`rpid=476670`的二级评论，每页5项，查看第1页
```shell
curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
@@ -6219,9 +6219,9 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
| ---------- | ---- | -------------- | ----------- | ---------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根回复rpID | 必要 | |
| dialog | num | 对话树根rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| root | num | 根回复rpid | 必要 | |
| dialog | num | 对话树根rpid | 必要 | |
| size | num | 每页最大项数 | 必要 | |
**json回复：**
@@ -6247,7 +6247,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
| vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主UID | |
| upper | obj | UP主mid | |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
@@ -6290,7 +6290,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
`data`中的`control`对象：
@@ -6308,7 +6308,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
**示例：**
获取视频`av201022189`下评论`rpID=3030790837`的对话`rpID=3030978856`，每页最大5项
获取视频`av201022189`下评论`rpid=3030790837`的对话`rpid=3030978856`，每页最大5项
```shell
curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor' \
@@ -7087,7 +7087,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | -------------------------------------------- |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
**json回复：**

58
comment/readme.md
View File

@@ -17,40 +17,40 @@
| 代码 | 评论区类型 | oid的意义 |
| ---- | ----------------------- | ---------- |
| 1 | 视频稿件 | 稿件avID |
| 2 | 话题 | 话题ID |
| 4 | 活动 | 活动ID |
| 5 | 小视频 | 小视频ID |
| 6 | 小黑屋封禁信息 | 封禁公示ID |
| 7 | 公告信息 | 公告ID |
| 8 | 直播活动 | 直播间ID |
| 1 | 视频稿件 | 稿件avid |
| 2 | 话题 | 话题id |
| 4 | 活动 | 活动id |
| 5 | 小视频 | 小视频id |
| 6 | 小黑屋封禁信息 | 封禁公示id |
| 7 | 公告信息 | 公告id |
| 8 | 直播活动 | 直播间id |
| 9 | 活动稿件 | |
| 10 | 直播公告 | |
| 11 | 相簿（图片动态） | 相簿ID |
| 12 | 专栏 | 专栏cvID |
| 11 | 相簿（图片动态） | 相簿id |
| 12 | 专栏 | 专栏cvid |
| 13 | 票务 | |
| 14 | 音频 | 音频auID |
| 15 | 风纪委员会 | 众裁项目ID |
| 14 | 音频 | 音频auid |
| 15 | 风纪委员会 | 众裁项目id |
| 16 | 点评 | |
| 17 | 动态（纯文字动态&分享） | 动态ID |
| 17 | 动态（纯文字动态&分享） | 动态id |
| 18 | 播单 | |
| 19 | 音乐播单 | |
| 20 | 漫画 | |
| 21 | 漫画 | |
| 22 | 漫画 | 漫画mcID |
| 33 | 课程 | 课程epID |
| 22 | 漫画 | 漫画mcid |
| 33 | 课程 | 课程epid |
## 评论条目对象
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ |
| rpid | num | 评论rpID | |
| rpid | num | 评论rpid | |
| oid | num | 评论区对象id | |
| 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 |
| 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 | 评论楼层号 | **注：若不支持楼层则无此项** |
@@ -58,9 +58,9 @@
| fansgrade | num | 是否具有粉丝标签 | 0：无<br />1：有 |
| attr | num | 某属性位？ | **作用尚不明确** |
| ctime | num | 评论发送时间 | 时间戳 |
| rpid_str | str | 评论rpID | 字串格式 |
| root_str | str | 根评论rpID | 字串格式 |
| parent_str | str | 回复父评论rpID | 字串格式 |
| 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 | 评论发送者信息 | |
@@ -75,7 +75,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ----------------------------- | ---------------------- | ------------------------------------------------------------ |
| mid | str | 发送者UID | |
| mid | str | 发送者mid | |
| uname | str | 发送者昵称 | |
| sex | str | 发送者性别 | 男 女 保密 |
| sign | str | 发送者签名 | |
@@ -155,8 +155,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | -------------------- |
| uid | num | 用户UID | |
| medal_id | num | 粉丝标签ID | **详细说明有待补充** |
| uid | num | 用户mid | |
| medal_id | num | 粉丝标签id | **详细说明有待补充** |
| medal_name | str | 粉丝标签名 | |
| score | num | 0 | **作用尚不明确** |
| level | num | 当前标签等级 | |
@@ -176,7 +176,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------- | ------------------------------------- |
| id | num | 头像框ID | |
| id | num | 头像框id | |
| name | str | 头像框名称 | |
| image | str | 头像框图片url | |
| jump_url | str | 空 | |
@@ -186,7 +186,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ----------------------- | ------------------------------------- |
| id | num | 评论条目装扮ID | |
| id | num | 评论条目装扮id | |
| name | str | 评论条目装扮名称 | |
| image | str | 评论条目装扮图片url | |
| jump_url | str | 评论条目装扮商城页面url | |
@@ -234,8 +234,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | -------------------------------------------------------- |
| id | num | 表情ID | |
| package_id | num | 表情包ID | |
| id | num | 表情id | |
| package_id | num | 表情包id | |
| state | num | 0 | |
| type | num | 表情类型 | 1：免费<br />2：会员专属<br />3：购买所得<br />4：颜文字 |
| attr | num | 0 | **作用尚不明确** |