diff --git a/README.md b/README.md index 122568e..24aea49 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,7 @@ PS:所有http协议地址均可使用https,文档中为了统一写作`http` 计划整理分类&目录:(√代表已完成,x代表正在施工...)二级目录正在建设中..... - [API认证与鉴权(APP与Cookie方式)](other/API_auth.md)× +- [公共错误码](other/errcode.md)√ - [图片格式化](other/picture.md)√ - [登录](login) - [登录操作(人机认证)](login/login_action)√ @@ -102,7 +103,10 @@ PS:所有http协议地址均可使用https,文档中为了统一写作`http` - [小黑屋](blackroom) - 基本信息 - [封禁公示](blackroom/banlist.md)√ - - [仲裁信息](blackroom/judgement.md)√ + - [风纪委员及众裁案件相关](blackroom/jury) + - [风纪委员基本信息](blackroom/jury/base_info.md)√ + - [众裁案件基本信息](blackroom/jury/judgement_info.md)√ + - [裁决操作](blackroom/jury/action.md)√ - [评论区](comment) - [评论区明细](comment/comment_list.md)√ - [操作](comment/action.md)√ diff --git a/blackroom/banlist.md b/blackroom/banlist.md index a14eda8..b94a4e9 100644 --- a/blackroom/banlist.md +++ b/blackroom/banlist.md @@ -1,4 +1,4 @@ -# 封禁用户公示 +# 封禁公示 **已知的违规类型代码总览:** @@ -37,6 +37,20 @@ | 31 | 发布违规抽奖 | | 32 | 恶意冒充他人 | +**已知的违规来源代码:** + +| 代码 | 含义 | +| ---- | -------- | +| 1 | 评论 | +| 2 | 弹幕 | +| 3 | 私信 | +| 4 | 标签 | +| 5 | 个人资料 | +| 6 | 投稿 | +| 8 | 专栏 | +| 10 | 动态 | +| 11 | 相簿 | + ## 获取封禁用户公示列表 > http://api.bilibili.com/x/credit/blocked/list @@ -47,11 +61,11 @@ **url参数:** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | -------- | ------ | ------------------------------------------------------------ | -| btype | num | 来源筛选 | 非必要 | 空:全部类型
0:系统封禁
1:风纪仲裁 | -| otype | num | 类型筛选 | 非必要 | 0:全部类型
1:评论
2:弹幕
3:私信
4:标签
5:个人资料
6:投稿
8:专栏
10:动态
11:相簿 | -| pn | num | 页码 | 非必要 | 默认为1 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | -------- | ------ | ---------------------------------------------- | +| btype | num | 来源筛选 | 非必要 | 空:全部类型
0:系统封禁
1:风纪仲裁 | +| otype | num | 类型筛选 | 非必要 | **见上表**
**0:全部类型** | +| pn | num | 页码 | 非必要 | 默认为1 | **json回复:** @@ -74,33 +88,33 @@ `data`数组中的对象: -| 字段 | 类型 | 内容 | 备注 | -| ------------------- | ---- | --------------- | ------------------------------------------------------------ | -| id | num | 封禁公示ID | | -| uname | str | 对象用户名 | | -| face | str | 对象用户头像url | | -| uid | num | 对象用户UID | | -| originTitle | str | 来源标题 | | -| blockedRemark | str | | | -| originUrl | str | 来源url | | -| originContentModify | str | 裁决正文 | | -| originType | num | 来源类型 | 0:全部类型
1:评论
2:弹幕
3:私信
4:标签
5:个人资料
6:投稿
8:专栏
10:动态
11:相簿 | -| originTypeName | str | 来源名 | | -| punishTitle | str | 公示标题 | | -| punishTime | num | 处罚时间 | 时间戳 | -| punishType | num | 处理手段类型 | 2:封禁
3:永久封禁 | -| punishTypeName | str | 处理手段名 | | -| moralNum | num | 0 | 作用尚不明确 | -| blockedDays | num | 封禁天数 | 永封为0 | -| publishStatus | num | 1 | 作用尚不明确 | -| blockedType | num | 处理来源 | 0:系统封禁
1:风纪仲裁 | -| blockedForever | num | 是否永封 | 0:非永封
1:永封 | -| reasonType | num | 违规类型 | **违规类型见表** | -| reasonTypeName | str | 违规类型名称 | | -| operatorName | str | 空 | 作用尚不明确 | -| caseId | num | 仲裁信息 | 心态封禁时为0 | -| ctime | num | 创建时间 | 时间戳 | -| commentSum | num | 该条目评论数 | | +| 字段 | 类型 | 内容 | 备注 | +| ------------------- | ---- | --------------- | ---------------------------- | +| id | num | 封禁公示ID | | +| uname | str | 对象用户名 | | +| face | str | 对象用户头像url | | +| uid | num | 对象用户UID | | +| originTitle | str | 来源标题 | | +| blockedRemark | str | | | +| originUrl | str | 来源url | | +| originContentModify | str | 裁决正文 | | +| originType | num | 来源类型 | **见上表** | +| originTypeName | str | 来源名 | | +| punishTitle | str | 公示标题 | | +| punishTime | num | 处罚时间 | 时间戳 | +| punishType | num | 处理手段类型 | 2:封禁
3:永久封禁 | +| punishTypeName | str | 处理手段名 | | +| moralNum | num | 0 | 作用尚不明确 | +| blockedDays | num | 封禁天数 | 永封为0 | +| publishStatus | num | 1 | 作用尚不明确 | +| blockedType | num | 处理来源 | 0:系统封禁
1:风纪仲裁 | +| blockedForever | num | 是否永封 | 0:非永封
1:永封 | +| reasonType | num | 违规类型 | **见上表** | +| reasonTypeName | str | 违规类型名称 | | +| operatorName | str | 空 | 作用尚不明确 | +| caseId | num | 仲裁信息ID | 系统封禁时固定为0 | +| ctime | num | 创建时间 | 时间戳 | +| commentSum | num | 该条目评论数 | | **示例:** @@ -201,33 +215,33 @@ curl -G 'http://api.bilibili.com/x/credit/blocked/list'\ `data`对象: -| 字段 | 类型 | 内容 | 备注 | -| ------------------- | ---- | --------------- | ------------------------------------------------------------ | -| id | num | 封禁公示ID | | -| uname | str | 对象用户名 | | -| face | str | 对象用户头像url | | -| uid | num | 对象用户UID | | -| originTitle | str | 来源标题 | | -| blockedRemark | str | | | -| originUrl | str | 来源url | | -| originContentModify | str | 裁决正文 | | -| originType | num | 来源类型 | 0:全部类型
1:评论
2:弹幕
3:私信
4:标签
5:个人资料
6:投稿
8:专栏
10:动态
11:相簿 | -| originTypeName | str | 来源名 | | -| punishTitle | str | 公示标题 | | -| punishTime | num | 处罚时间 | 时间戳 | -| punishType | num | 处理手段类型 | 2:封禁
3:永久封禁 | -| punishTypeName | str | 处理手段名 | | -| moralNum | num | 0 | 作用尚不明确 | -| blockedDays | num | 封禁天数 | 永封为0 | -| publishStatus | num | 1 | 作用尚不明确 | -| blockedType | num | 处理来源 | 0:系统封禁
1:风纪仲裁 | -| blockedForever | num | 是否永封 | 0:非永封
1:永封 | -| reasonType | num | 违规类型 | **违规类型见表** | -| reasonTypeName | str | 违规类型名称 | | -| operatorName | str | 空 | 作用尚不明确 | -| caseId | num | 仲裁信息 | 心态封禁时为0 | -| ctime | num | 创建时间 | 时间戳 | -| commentSum | num | 该条目评论数 | | +| 字段 | 类型 | 内容 | 备注 | +| ------------------- | ---- | --------------- | ---------------------------- | +| id | num | 封禁公示ID | | +| uname | str | 对象用户名 | | +| face | str | 对象用户头像url | | +| uid | num | 对象用户UID | | +| originTitle | str | 来源标题 | | +| blockedRemark | str | | | +| originUrl | str | 来源url | | +| originContentModify | str | 裁决正文 | | +| originType | num | 来源类型 | **见上表** | +| originTypeName | str | 来源名 | | +| punishTitle | str | 公示标题 | | +| punishTime | num | 处罚时间 | 时间戳 | +| punishType | num | 处理手段类型 | 2:封禁
3:永久封禁 | +| punishTypeName | str | 处理手段名 | | +| moralNum | num | 0 | 作用尚不明确 | +| blockedDays | num | 封禁天数 | 永封为0 | +| publishStatus | num | 1 | 作用尚不明确 | +| blockedType | num | 处理来源 | 0:系统封禁
1:风纪仲裁 | +| blockedForever | num | 是否永封 | 0:非永封
1:永封 | +| reasonType | num | 违规类型 | **违规类型见表** | +| reasonTypeName | str | 违规类型名称 | | +| operatorName | str | 空 | 作用尚不明确 | +| caseId | num | 仲裁信息 | 系统封禁时固定为0 | +| ctime | num | 创建时间 | 时间戳 | +| commentSum | num | 该条目评论数 | | **示例:** diff --git a/blackroom/judgement.md b/blackroom/judgement.md deleted file mode 100644 index 7889f92..0000000 --- a/blackroom/judgement.md +++ /dev/null @@ -1,567 +0,0 @@ -# 众裁信息 - -**本页所有操作均需登录(SESSDATA)** - -投票类型码总览: - -| 代码 | 意义 | -| - | ---- | -| 1 | 封禁 | -| 2 | 否 | -| 3 | 弃权 | -| 4 | 删除 | - -## 基本数据 - -> - -*方式:GET* - -**JSON回复:** - -根对象: - -| 字段 | 类型 | 内容 | 备注 | -| ------- | ------ | -------- | ------------ | -| code | num | 返回值 | 0:成功
-101:账号未登录 | -| message | str | 信息 | 默认为0 | -| ttl | num | 1 | 作用尚不明确 | -| data | object | 数据 | | - -`data` 对象: - -| 字段 | 类型 | 内容 | 备注 | -| --------- | ------ | -------- | ------------ | -| caseTotal | num | 众裁数 | | -| face | str | 头像url | | -| restDays | num | 剩余天数 | | -| rightRadio | num | 尚不明确 | | -| status | num | 状态 | 无法测试,猜测1为风纪委员 | -| uname | str | 用户名 | | - -**示例:** - -查询我的数据 - - - -```json -{ - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "caseTotal": 9205, - "face": "http://i1.hdslb.com/bfs/face/aef00604488a2430a73eac4sd9e9890b7f3a5a3e.jpg", - "restDays": 27, - "rightRadio": 92, - "status": 1, - "uname": "myusername" - } -} -``` - -## 统计信息 - -> - -*方式:GET* - -**JSON回复:** - -根对象: - -| 字段 | 类型 | 内容 | 备注 | -| ------- | ------ | -------- | ------------ | -| code | num | 返回值 | 0:成功
-101:账号未登录 | -| message | str | 信息 | 默认为0 | -| ttl | num | 1 | 作用尚不明确 | -| data | array | 每月统计 | | - -`data` 数组中的每个对象: - -| 字段 | 类型 | 内容 | 备注 | -| --------- | ------ | -------- | ------------ | -| id | num | 0 | | -| mid | num | 用户id | | -| number | num | 尚不明确 | | -| day | num | 开始时间 | | -| rate | num | 尚不明确 | | -| rank | num | 尚不明确 | | -| rankper | num | 尚不明确 | | -| rankTotal | num | 尚不明确 | | -| point | num | 32767 | | -| activeDays | num | 活跃天数 | | -| voteTotal | num | 投票总数 | | -| voteRadio | num | 尚不明确 | | -| blockedTotal | num | 尚不明确 | | -| termStart | num | 尚不明确 | | -| termEnd | num | 尚不明确 | | -| opinion_likes | num | 观点获赞 | | - -**示例:** - -查询我的数据(删减至只有一个周期的) - - - -```json -{ - "code": 0, - "message": "0", - "ttl": 1, - "data": [ - { - "id": 0, - "mid": 114343368, - "number": 199046, - "day": 1539792000, - "rate": 1, - "rank": 0, - "rankper": 1, - "rankTotal": 39584, - "point": 32767, - "activeDays": 23, - "voteTotal": 422, - "voteRadio": 0, - "blockedTotal": 0, - "termStart": 1537200000, - "termEnd": 1539792000, - "opinion_likes": 18 - } - ] -} -``` - -## 查询单个案件 - -> - -只能查询我参与众裁的 - -*方式:GET* - -**url参数:** - -| 参数名 | 内容 | 必要性 | 备注 | -| ------ | ------------ | ------ | ------------- | -| cid | 案件id | 必要 | | - -**JSON回复:** - -根对象: - -| 字段 | 类型 | 内容 | 备注 | -| ------- | ------ | -------- | ------------ | -| code | num | 返回值 | 0:成功
-101:账号未登录 | -| message | str | 信息 | 默认为0 | -| ttl | num | 1 | 作用尚不明确 | -| data | object | 数据 | | - -`data` 对象: - -| 字段 | 类型 | 内容 | 备注 | -| --------- | ------ | -------- | ------------ | -| id | num | 案件id | | -| mid | num | 用户id | | -| status | num | 状态 | 4:已裁决
6:未裁决 | -| statusTitle | str | 封禁7/15天 | 就是这样的 | -| originType | num | 来源类型 | 需要对照表 | -| reasonType | num | 原因类型 | 需要对照表 | -| punishTitle | str | 处罚原因 | | -| judgeType | num | 裁决类型 | 0:未裁决
1:违规
2:不违规 | originUrl | str | 来源地址 | | -| blockedDays | num | 封禁天数 | | -| putTotal | num | 尚不明确 | | -| voteRule | num | 投不违规 | | -| voteBreak | num | 建议封禁 | | -| voteDelete | num | 建议删除 | | -| startTime | num | 尚不明确 | | -| endTime | num | 尚不明确 | | -| ctime | num | 尚不明确 | | -| mtime | num | 尚不明确 | | -| originTitle | str | 来源标题 | | -| relationId | str | 尚不明确 | | -| face | str | 用户头像url | | -| uname | str | 用户id | | -| vote | num | 投票类型 | | -| case_type | num | 尚不明确 | | - -**示例:** - -查询案件`1239790`的信息 - - - -```json -{ - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "id": 1239790, - "mid": 351783425, - "status": 4, - "statusTitle": "封禁7天", - "originType": 1, - "reasonType": 9, - "originContent": "up主,在和平精英里的喷子是霰(xian)弹枪,不是散(san)弹枪。", - "punishResult": 0, - "punishTitle": "在评论中发布引战言论", - "judgeType": 2, - "originUrl": "https://www.bilibili.com/video/BV15x411X7eV/#reply1728344012", - "blockedDays": 7, - "putTotal": 272, - "voteRule": 409, - "voteBreak": 17, - "voteDelete": 89, - "startTime": 1594467941, - "endTime": 1594471525, - "ctime": 1594464499, - "mtime": 1594471678, - "originTitle": "和平精英揭秘真相68:氪金试水最新抽奖活动,到底是亏了还是赚了?", - "relationId": "1728344012-1-57465308", - "face": "http://i2.hdslb.com/bfs/face/e1018566c615059b664dc6eae3a5235c31cd92fe.jpg", - "uname": "零酱a", - "vote": 4, - "case_type": 0 - } -} -``` - -## 众裁记录 - -> - -*方式:GET* - -**url参数:** - -| 参数名 | 内容 | 必要性 | 备注 | -| ------ | ------------ | ------ | ------------- | -| pn | 页码 | 非必要 | 无上限 | -| ps | 每页显示数量 | 非必要 | 默认30, 最大30 | - -**JSON回复:** - -根对象: - -| 字段 | 类型 | 内容 | 备注 | -| ------- | ------ | -------- | ------------ | -| code | num | 返回值 | 0:成功
-101:账号未登录 | -| message | str | 信息 | 默认为0 | -| ttl | num | 1 | 作用尚不明确 | -| data | array | 数据 | | - -`data` 数组中的每个对象与获取单个案件信息相比 - -缺少`statusTitle` - -增加`voteTime`, 内容为我的投票时间(毫秒) - -**示例:** - -查询我的历史众裁,第1页,每页显示1个案件 - - - -```json -{ - "code": 0, - "message": "0", - "ttl": 1, - "data": [ - { - "id": 1241808, - "mid": 298264370, - "status": 4, - "originType": 1, - "reasonType": 9, - "originContent": "别在发这种傻逼视频了好吗?真要搞到禁摩才甘心。", - "punishResult": 6, - "punishTitle": "在评论中发布引战言论", - "judgeType": 1, - "originUrl": "https://www.bilibili.com/video/av328669697/#reply3165369965", - "blockedDays": 7, - "putTotal": 251, - "voteRule": 14, - "voteBreak": 140, - "voteDelete": 373, - "startTime": 1594528662, - "endTime": 1594530687, - "ctime": 1594528108, - "mtime": 1594530802, - "originTitle": "我这里有记录仪!略略略略略略哈哈哈,干得漂亮!", - "relationId": "3165369965-1-328669697", - "face": "http://i1.hdslb.com/bfs/face/d69912bb2a51f08176bcdbf4ba15e4c2b0962ad9.jpg", - "uname": "MyLSTicKnight", - "vote": 4, - "voteTime": 1594528700000, - "case_type": 0 - } - ] -} -``` - -## 众议观点 - -> - -*方式:GET* - -**url参数:** - -| 参数名 | 内容 | 必要性 | 备注 | -| ------ | ------------ | ------ | ------------- | -| cid | 案件id | 必要 | | -| pn | 页码 | 非必要 | | -| ps | 每页显示数量 | 非必要 | | - -**JSON回复:** - -根对象: - -| 字段 | 类型 | 内容 | 备注 | -| ------- | ------ | -------- | ------------ | -| code | num | 返回值 | 0:成功
-101:账号未登录 | -| message | str | 信息 | 默认为0 | -| ttl | num | 1 | 作用尚不明确 | -| data | object | 数据 | | - -`data` 对象: - -| 字段 | 类型 | 内容 | 备注 | -| --------- | ------ | -------- | ------------ | -| count | num | 观点总数 | | -| opinion | array | 观点数组 | | - -`data` 对象中 `opinion` 数组的每个对象: - -前三个仅非匿名观点有 - -| 字段 | 类型 | 内容 | 备注 | -| --------- | ------ | -------- | ------------ | -| mid | num | 用户id | | -| face | str | 用户头像 | | -| name | str | 用户名 | | -| opid | num | 观点id | | -| vote | num | 投票选择 | | -| content | str | 观点内容 | | -| attr | num | 1 | 作用尚不明确 | -| hate | num | 喜欢人数 | | -| like | num | 不喜欢人数 | | - -**示例:** - -查看案件`1239790`的众议观点 - - - -```json -{ - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "count": 23, - "opinion": [ - { - "opid": 250943982, - "vote": 2, - "content": "不懂,正常的科普也有人杠吗?没文化真可怕", - "attr": 0, - "hate": 0, - "like": 0 - }, - { - "mid": 59894, - "face": "http://i2.hdslb.com/bfs/face/0cc48fc40867537d5a09a125e90f76183efbfdfa.gif", - "name": "雷歐諾斯", - "opid": 250956267, - "vote": 2, - "content": "这个虽然不是正确的说法,但本身是一种观点。而且已经成为一种梗了。不属于引战。", - "attr": 1, - "hate": 0, - "like": 0 - }, - { - "opid": 250956259, - "vote": 2, - "content": "正常科普,不构成引战。", - "attr": 0, - "hate": 0, - "like": 0 - }, - { - "mid": 215020429, - "face": "http://i1.hdslb.com/bfs/face/1d43c302e67db4d21b9c5c0f0dc0b8786e8086d5.jpg", - "name": "瞎子广_广告歌41", - "opid": 250955160, - "vote": 2, - "content": "这个其实也没啥事真的", - "attr": 1, - "hate": 0, - "like": 0 - }, - { - "mid": 108194360, - "face": "http://i0.hdslb.com/bfs/face/b78c92a69ff9977b7d08d4f7edc0a051a3d6ea3e.jpg", - "name": "籽云奕", - "opid": 250953998, - "vote": 2, - "content": "仅仅是科普评论,无过激言论", - "attr": 1, - "hate": 0, - "like": 0 - }, - { - "mid": 34503714, - "face": "http://i2.hdslb.com/bfs/face/eb2d0853235a56d035303f4f3614dcb6e0cf66fa.jpg", - "name": "十六夜紅月丶", - "opid": 250950982, - "vote": 2, - "content": "无过激言论,正常科普罢了", - "attr": 1, - "hate": 0, - "like": 0 - }, - { - "opid": 250950973, - "vote": 2, - "content": "其实两种读法都是正确的,虽然想要纠正别人的错误。不过自己本身就错了。还是保留吧,没什么引战的", - "attr": 0, - "hate": 0, - "like": 0 - }, - { - "mid": 436136443, - "face": "http://i1.hdslb.com/bfs/face/6b4151d8e030eddd073add6ef18ccbb00aa48d0f.jpg", - "name": "兄弟好牛啤", - "opid": 250950417, - "vote": 2, - "content": "有点经典的争议,但可能还会有人不知道", - "attr": 1, - "hate": 0, - "like": 0 - }, - { - "mid": 87385400, - "face": "http://i2.hdslb.com/bfs/face/0f567e7fa49bcef22010f3ff78e90553d8fffb09.jpg", - "name": "小学生de王者荣耀", - "opid": 250950402, - "vote": 2, - "content": "合理纠正up主的错误,建议追究恶意举报者的责任", - "attr": 1, - "hate": 0, - "like": 0 - }, - { - "opid": 250949840, - "vote": 2, - "content": "正常科普,没有过激言论,建议保留", - "attr": 0, - "hate": 0, - "like": 0 - } - ] - } -} -``` - -## 获取案件 - -> - -参数为`csrf`, 必选 - -*方式:POST* - -**json回复:** - -根对象: - -| 字段 | 类型 | 内容 | 备注 | -| ------- | ------ | -------- | ------------ | -| code | num | 返回值 | 0: 成功
25008: 没有案件
25014: 已审满 | -| message | str | 信息 | 默认为0 | -| ttl | num | 1 | 作用尚不明确 | -| data | object | 数据 | | - -**示例:** - -获取一个案件 - - - -参数: - -```json -{ - "csrf": "38e17ae249a8ea498eaea56a9743aa85a" -} -``` - -回复: - -```json -{ - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "id": 1239790 - } -} -``` - -## 进行众裁 - -> - -参数为`csrf`, 必选 - -*方式:POST* - -**正文参数:** - -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------- | ---- | ---------------- | ------ | ----------| -| cid | num | 案件id | 必要 | | -| vote | num | 投票类型 | 必要 | | -| content | str | 理由 | 非必要 | | -| csrf | str | csrf | 必要 | | - -**json回复:** - -根对象: - -| 字段 | 类型 | 内容 | 备注 | -| ------- | ------ | -------- | ------------ | -| code | num | 返回值 | 0: 成功
25009: 案件不存在
25012: 重复投票 | -| message | str | 信息 | 默认为0 | -| ttl | num | 1 | 作用尚不明确 | -| data | object | 数据 | | - -**示例:** - -给某个案件进行建议删除投票,没有理由 - - - -参数: - -```json -{ - "cid": 1234567, - "vote": 4, - "csrf": "38e17ae249a8ea498eaea56a9743aa85a" -} -``` - -回复: - -```json -{ - "code": 0, - "message": "0", - "ttl": 1 -} diff --git a/blackroom/jury/action.md b/blackroom/jury/action.md new file mode 100644 index 0000000..cb5b5d1 --- /dev/null +++ b/blackroom/jury/action.md @@ -0,0 +1,198 @@ +# 仲裁操作 + +**本页所有操作均需登录(Cookie或APP)** + +## 申请加入风纪委员会 + +> http://api.bilibili.com/x/credit/jury/apply + +*请求方式:POST* + +认证方式:Cookie(SESSDATA)或APP + +只有用户会员等级≥Lv4、90天内无违规、实名认证且非封禁状态才可以申请加入风纪委员会 + +每日10:00开放新名额 + +申请成功后可获得30天资格 + +**正文参数( application/x-www-form-urlencoded ):** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------ | -------------- | ---- | +| access_key | str | APP登录Token | APP方式必要 | | +| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | ------ | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf 校验失败
25001:申请等级限制(会员等级<3)
25002:没有实名认证
25003:90天内有封禁记录
25013:不能重复申请风纪委资格
25016:当日风纪委员名额已发完 | +| message | str | 信息 | 默认为0 | +| ttl | num | 1 | | + +**示例:** + +Cookie方式: + +```shell +curl 'http://api.bilibili.com/x/credit/jury/apply'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` + +APP方式: + +```shell +curl 'http://api.bilibili.com/x/credit/jury/apply'\ +--data-urlencode 'access_key=xxx' +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +## 拉取新案件 + +> http://api.bilibili.com/x/credit/jury/caseObtain + +*请求方式:POST* + +认证方式:Cookie(SESSDATA)或APP + +**正文参数( application/x-www-form-urlencoded ):** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------ | -------------- | ---- | +| access_key | str | APP登录Token | APP方式必要 | | +| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ------ | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
25005:不是风纪委员
25008:没有案件
25014:已审满 | +| message | str | 信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | object | 数据本体 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---------- | ---- | +| id | num | 仲裁案件ID | | + +**示例:** + +Cookie方式: + +```shell +curl 'http://api.bilibili.com/x/credit/jury/caseObtain'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` + +APP方式: + +```shell +curl 'http://api.bilibili.com/x/credit/jury/caseObtain'\ +--data-urlencode 'access_key=xxx' +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "id": 1239790 + } +} +``` + +## 进行仲裁投票 + +> http://api.bilibili.com/x/credit/jury/vote + +*请求方式:POST* + +认证方式:Cookie(SESSDATA)或APP + +**正文参数( application/x-www-form-urlencoded ):** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------------- | ---- | ------------------------ | -------------- | --------------------------------------- | +| cid | num | 案件ID | 必要 | | +| vote | num | 投票类型 | 必要 | | +| content | str | 理由 | 非必要 | 见「[众裁信息](judgement_info.md)」中表 | +| likes | nums | 支持的观点 | 非必要 | | +| hates | nums | 反对的观点 | 非必要 | | +| attr | num | 是否匿名 | 非必要 | 0:匿名
1:不匿名 | +| apply_type | num | 是否更改原因 | 非必要 | 0:保持原来原因
1:投票给新原因 | +| origin_reason | num | 原始原因 | 非必要 | 见「封禁公示」中表 | +| apply_reason | num | 新原因 | 非必要 | 见「封禁公示」中表 | +| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | ------ | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:未登录
-111:csrf 错误
25005:不是风纪委员
25009: 案件不存在
25011:投票类型错误
25012:重复投票 | +| message | str | 信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | + +**示例:** + +为案件`2333`投票,建议封禁,无理由,不匿名,无支持/反对观点,不修改投票原因 + +Cookie方式: + +```shell +curl 'http://api.bilibili.com/x/credit/jury/vote'\ +--data-urlencode 'cid=2333'\ +--data-urlencode 'vote=1'\ +--data-urlencode 'content='\ +--data-urlencode 'likes='\ +--data-urlencode 'hates='\ +--data-urlencode 'attr=1'\ +--data-urlencode 'apply_type=0'\ +--data-urlencode 'origin_reason='\ +--data-urlencode 'apply_reason='\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` + +APP方式: + +```shell +curl 'http://api.bilibili.com/x/credit/jury/vote'\ +--data-urlencode 'access_key=xxx'\ +--data-urlencode 'cid=2333'\ +--data-urlencode 'vote=1'\ +--data-urlencode 'content='\ +--data-urlencode 'likes='\ +--data-urlencode 'hates='\ +--data-urlencode 'attr=1'\ +--data-urlencode 'apply_type=0'\ +--data-urlencode 'origin_reason='\ +--data-urlencode 'apply_reason=' +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + diff --git a/blackroom/jury/base_info.md b/blackroom/jury/base_info.md new file mode 100644 index 0000000..f5b6cfb --- /dev/null +++ b/blackroom/jury/base_info.md @@ -0,0 +1,236 @@ +# 风纪委员会用户基本信息 + +**本页所有操作均需登录(Cookie或APP)** + +## 基本数据 + +> http://api.bilibili.com/x/credit/jury/jury + +*请求方式:GET* + +认证方式:Cookie(SESSDATA)或APP + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------ | ----------- | ---- | +| access_key | str | APP登录Token | APP方式必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ------ | -------- | ----------------------------- | +| code | num | 返回值 | 0:成功
-101:账号未登录 | +| message | str | 信息 | 默认为0 | +| ttl | num | 1 | | +| data | object | 数据本体 | | + +`data` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | -------------------- | ---------------------------- | +| caseTotal | num | 总众裁数 | | +| face | str | 用户头像url | | +| restDays | num | 当前资格剩余天数 | | +| rightRadio | num | 当前裁决正确率百分比 | 裁决数小于3时固定为50 | +| status | num | 当前状态 | 1:具有资格
2:资格失效 | +| uname | str | 用户昵称 | | + +**示例:** + +Cookie方式: + +```shell +curl 'http://api.bilibili.com/x/credit/jury/jury'\ +-b 'SESSDATA=xxx' +``` + +APP方式: + +```shell +curl -G 'http://api.bilibili.com/x/credit/jury/jury'\ +--data-urlencode 'access_key=xxx' +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "caseTotal": 7, + "face": "http://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", + "restDays": 30, + "rightRadio": 80, + "status": 1, + "uname": "社会易姐QwQ" + } +} +``` + +## 统计信息 + +> http://api.bilibili.com/x/credit/jury/kpi + +*方式:GET* + +认证方式:Cookie(SESSDATA)或APP + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------ | ----------- | ---- | +| access_key | str | APP登录Token | APP方式必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | -------- | ----------------------------- | +| code | num | 返回值 | 0:成功
-101:账号未登录 | +| message | str | 信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 数据本体 | | + +`data`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------------- | ---- | +| 0 | obj | 第1个月统计 | | +| n | obj | 第(n+1)个月统计 | | +| …… | obj | …… | …… | + +`data` 数组中的对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | -------- | ---- | +| id | num | 0 | | +| mid | num | 用户id | | +| number | num | 尚不明确 | | +| day | num | 开始时间 | | +| rate | num | 尚不明确 | | +| rank | num | 尚不明确 | | +| rankper | num | 尚不明确 | | +| rankTotal | num | 尚不明确 | | +| point | num | 32767 | | +| activeDays | num | 活跃天数 | | +| voteTotal | num | 投票总数 | | +| voteRadio | num | 尚不明确 | | +| blockedTotal | num | 尚不明确 | | +| termStart | num | 尚不明确 | | +| termEnd | num | 尚不明确 | | +| opinion_likes | num | 观点获赞 | | + +**示例:** + +Cookie方式: + +```shell +curl 'http://api.bilibili.com/x/credit/jury/kpi'\ +-b 'SESSDATA=xxx' +``` + +APP方式: + +```shell +curl -G 'http://api.bilibili.com/x/credit/jury/kpi'\ +--data-urlencode 'access_key=xxx' +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [ + { + "id": 0, + "mid": 114343368, + "number": 199046, + "day": 1539792000, + "rate": 1, + "rank": 0, + "rankper": 1, + "rankTotal": 39584, + "point": 32767, + "activeDays": 23, + "voteTotal": 422, + "voteRadio": 0, + "blockedTotal": 0, + "termStart": 1537200000, + "termEnd": 1539792000, + "opinion_likes": 18 + } + ] +} +``` + +## 检查申请风纪委员会资格 + +> http://api.bilibili.com/x/credit/jury/requirement + +*请求方式:GET* + +认证方式:Cookie(SESSDATA)或APP + +只有用户会员等级≥Lv4、90天内无违规、实名认证且非封禁状态才可以申请加入风纪委员会 + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------ | ----------- | ---- | +| access_key | str | APP登录Token | APP方式必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ------ | -------- | ----------------------------- | +| code | num | 返回值 | 0:成功
-101:账号未登录 | +| message | str | 信息 | 默认为0 | +| ttl | num | 1 | | +| data | object | 数据本体 | | + +`data` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | ---------------- | ------------------------------------- | +| blocked | bool | 是否被封禁 | true:是
false:否
**下同** | +| cert | bool | 是否实名认证 | | +| level | bool | 等级是否>=4 | | +| rule | bool | 是否90天内无违规 | | + +**示例:** + +Cookie方式: + +```shell +curl 'http://api.bilibili.com/x/credit/jury/requirement'\ +-b 'SESSDATA=xxx' +``` + +APP方式: + +```shell +curl -G 'http://api.bilibili.com/x/credit/jury/requirement'\ +--data-urlencode 'access_key=xxx' +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "blocked": false, + "cert": true, + "level": true, + "rule": true + } +} +``` + diff --git a/blackroom/jury/judgement_info.md b/blackroom/jury/judgement_info.md new file mode 100644 index 0000000..0fc21a5 --- /dev/null +++ b/blackroom/jury/judgement_info.md @@ -0,0 +1,525 @@ +# 众裁信息 + +投票类型码总览: + +| 代码 | 含义 | +| - | ---- | +| 0 | 未投票 | +| 1 | 封禁 | +| 2 | 否 | +| 3 | 弃权 | +| 4 | 删除 | + +## 查询投票过的单个案件 + +> http://api.bilibili.com/x/credit/jury/juryCase + +*请求方式:GET* + +认证方式:Cookie(SESSDATA)或APP + +只能查询自己参与众裁的 + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ------------ | ------ | ------------- | ------------- | +| access_key | str | APP登录Token | APP方式必要 | | +| cid | num | 案件ID | 必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ------ | -------- | ------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-400:请求错误
25010:没有权限查看案件 | +| message | str | 信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 数据本体 | | + +`data` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ------ | -------- | ------------ | +| id | num | 案件ID | | +| mid | num | 被举报用户UID | | +| status | num | 裁决状态 | 1:投票中
2:停止发放
3:复核中(结案中)
4:已裁决
5:待重启
6:未裁决
7:冻结中
8:队列中 | +| statusTitle | str | 封禁时间文字 | `judgeType`=1时有效 | +| originType | num | 来源类型 | 见「封禁公示」中表 | +| reasonType | num | 原因类型 | 见「封禁公示」中表 | +| originContent | str | 被举报的原文 | | +| punishResult | num | 处理结果 | 0:无
1:封禁3天
2:封禁7天
3:永封
4:其他封禁天数
5:封禁15天
6:仅删除不封禁 | +| punishTitle | str | 处罚原因 | | +| judgeType | num | 裁决类型 | `status`=4时有效
0:未裁决
1:违规
2:不违规 | +| originUrl | str | 来源url | | +| blockedDays | num | 封禁时间 | `judgeType`=1时有效 | +| putTotal | num | ??? | 作用尚不明确 | +| voteRule | num | 投票不违规人数 | | +| voteBreak | num | 投票建议封禁人数 | | +| voteDelete | num | 投票建议删除人数 | | +| startTime | num | 裁决起始时间 | 时间戳 | +| endTime | num | 裁决截止时间 | 时间戳
未结案固定为24小时 | +| ctime | num | 举报创建时间 | 时间戳 | +| mtime | num | 开始拉取时间 | 时间戳 | +| originTitle | str | 来源标题 | | +| relationId | str | 违规关系标识字 | {评论rpID}-{违规类型ID}-{来源对象ID} | +| face | str | 被举报用户头像url | | +| uname | str | 被举报用户昵称 | | +| vote | num | 我的投票 | **见上表** | +| case_type | num | 众裁类型 | 0:小众众裁
1:大众众裁 | + +**示例:** + +查询案件`1239790`的信息 + +Cookie方式: + +```shell +curl -G 'http://api.bilibili.com/x/credit/jury/juryCase'\ +--data-urlencode 'cid=1239790'\ +-b 'SESSDATA=xxx' +``` + +APP方式: + +```shell +curl -G 'http://api.bilibili.com/x/credit/jury/juryCase'\ +--data-urlencode 'access_key=xxx'\ +--data-urlencode 'cid=1239790'\ +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "id": 1239790, + "mid": 351783425, + "status": 4, + "statusTitle": "封禁7天", + "originType": 1, + "reasonType": 9, + "originContent": "up主,在和平精英里的喷子是霰(xian)弹枪,不是散(san)弹枪。", + "punishResult": 0, + "punishTitle": "在评论中发布引战言论", + "judgeType": 2, + "originUrl": "https://www.bilibili.com/video/BV15x411X7eV/#reply1728344012", + "blockedDays": 7, + "putTotal": 272, + "voteRule": 409, + "voteBreak": 17, + "voteDelete": 89, + "startTime": 1594467941, + "endTime": 1594471525, + "ctime": 1594464499, + "mtime": 1594471678, + "originTitle": "和平精英揭秘真相68:氪金试水最新抽奖活动,到底是亏了还是赚了?", + "relationId": "1728344012-1-57465308", + "face": "http://i2.hdslb.com/bfs/face/e1018566c615059b664dc6eae3a5235c31cd92fe.jpg", + "uname": "零酱a", + "vote": 4, + "case_type": 0 + } +} +``` + +## 查询案件众裁信息 + +> http://api.bilibili.com/x/credit/jury/caseInfo + +*请求方式:GET* + +注:该接口无需登录 + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------ | ------ | ---- | +| cid | num | 案件ID | 必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----------------------------- | -------- | --------------------------- | +| code | num | 返回值 | 0:成功
-400:请求错误 | +| message | str | 信息 | 默认为0 | +| ttl | num | 1 | | +| data | 有效时:obj
无效时:null | 数据本体 | | + +`data` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ----------------- | ------------------------------------------------------------ | +| id | num | 案件ID | | +| mid | num | 被举报用户UID | | +| status | num | 裁决状态 | 1:投票中
2:停止发放
3:复核中(结案中)
4:已裁决
5:待重启
6:未裁决
7:冻结中
8:队列中 | +| originType | num | 来源类型 | 见「封禁公示」中表 | +| reasonType | num | 原因类型 | 见「封禁公示」中表 | +| originContent | str | 被举报的原文 | | +| punishResult | num | 处理结果 | 0:无
1:封禁3天
2:封禁7天
3:永封
4:其他封禁天数
5:封禁15天
6:仅删除不封禁 | +| judgeType | num | 裁决类型 | `status`=4时有效
0:未裁决
1:违规
2:不违规 | +| originUrl | str | 来源url | | +| blockedDays | num | 封禁时间 | `judgeType`=1时有效 | +| putTotal | num | ??? | 作用尚不明确 | +| voteRule | num | 投票不违规人数 | | +| voteBreak | num | 投票建议封禁人数 | | +| voteDelete | num | 投票建议删除人数 | | +| startTime | num | 裁决起始时间 | 时间戳 | +| endTime | num | 裁决截止时间 | 时间戳
未结案固定为24小时 | +| ctime | num | 举报创建时间 | 时间戳 | +| mtime | num | 开始拉取时间 | 时间戳 | +| originTitle | str | 来源标题 | | +| relationId | str | 违规关系标识字 | {评论rpID}-{违规类型ID}-{来源对象ID} | +| face | str | 被举报用户头像url | | +| uname | str | 被举报用户昵称 | | +| vote | num | 0 | 固定为0 | +| case_type | num | 众裁类型 | 0:小众众裁
1:大众众裁 | + +**示例:** + +查询案件`1239790`的信息 + +```shell +curl -G 'http://api.bilibili.com/x/credit/jury/juryCase'\ +--data-urlencode 'cid=1239790' +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "id": 1239790, + "mid": 351783425, + "status": 4, + "originType": 1, + "reasonType": 9, + "originContent": "up主,在和平精英里的喷子是霰(xian)弹枪,不是散(san)弹枪。", + "punishResult": 0, + "judgeType": 2, + "originUrl": "https://www.bilibili.com/video/BV15x411X7eV/#reply1728344012", + "blockedDays": 7, + "putTotal": 272, + "voteRule": 409, + "voteBreak": 17, + "voteDelete": 89, + "startTime": 1594467941, + "endTime": 1594471525, + "ctime": 1594464499, + "mtime": 1594471678, + "originTitle": "和平精英揭秘真相68:氪金试水最新抽奖活动,到底是亏了还是赚了?", + "relationId": "1728344012-1-57465308", + "face": "http://i2.hdslb.com/bfs/face/e1018566c615059b664dc6eae3a5235c31cd92fe.jpg", + "uname": "零酱a", + "vote": 0, + "case_type": 0 + } +} +``` + +## 查询我的众裁记录 + +> http://api.bilibili.com/x/credit/jury/caseList + +*请求方式:GET* + +认证方式:Cookie(SESSDATA)或APP + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ------------ | ------ | ------------- | ------------- | +| access_key | str | APP登录Token | APP方式必要 | | +| pn | num | 页码 | 非必要 | 默认为1 | +| ps | num | 每页显示数量 | 非必要 | 默认为30
最大30 | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ------ | -------- | ------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-400:请求错误 | +| message | str | 信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 仲裁记录列表 | | + +`data`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ------------ | +| 0 | obj | 仲裁记录1 | | +| n | obj | 仲裁记录(n+1) | 按照时间顺序 | +| …… | obj | …… | …… | + +`data`数组中的对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ----------------- | ------------------------------------------------------------ | +| id | num | 案件ID | | +| mid | num | 被举报用户UID | | +| status | num | 裁决状态 | 1:投票中
2:停止发放
3:复核中(结案中)
4:已裁决
5:待重启
6:未裁决
7:冻结中
8:队列中 | +| originType | num | 来源类型 | 见「封禁公示」中表 | +| reasonType | num | 原因类型 | 见「封禁公示」中表 | +| originContent | str | 被举报的原文 | | +| punishResult | num | 处理结果 | 0:无
1:封禁3天
2:封禁7天
3:永封
4:其他封禁天数
5:封禁15天
6:仅删除不封禁 | +| punishTitle | str | 处罚原因 | | +| judgeType | num | 裁决类型 | `status`=4时有效
0:未裁决
1:违规
2:不违规 | +| originUrl | str | 来源url | | +| blockedDays | num | 封禁时间 | `judgeType`=1时有效 | +| putTotal | num | ??? | 作用尚不明确 | +| voteRule | num | 投票不违规人数 | | +| voteBreak | num | 投票建议封禁人数 | | +| voteDelete | num | 投票建议删除人数 | | +| startTime | num | 裁决起始时间 | 时间戳 | +| endTime | num | 裁决截止时间 | 时间戳
未结案固定为24小时 | +| ctime | num | 举报创建时间 | 时间戳 | +| mtime | num | 开始拉取时间 | 时间戳 | +| originTitle | str | 来源标题 | | +| relationId | str | 违规关系标识字 | {评论rpID}-{违规类型ID}-{来源对象ID} | +| face | str | 被举报用户头像url | | +| uname | str | 被举报用户昵称 | | +| vote | num | 我的投票 | **见上表** | +| voteTime | num | 我的裁决时间 | 毫秒 时间戳 | +| case_type | num | 众裁类型 | 0:小众众裁
1:大众众裁 | + +**示例:** + +查询我的历史众裁,第1页,每页显示1个案件 + +Cookie方式: + +```shell +curl -G 'http://api.bilibili.com/x/credit/jury/caseList'\ +--data-urlencode 'ps=1'\ +--data-urlencode 'pn=1'\ +-b 'SESSDATA=xxx' +``` + +APP方式: +```shell +curl -G 'http://api.bilibili.com/x/credit/jury/caseList'\ +--data-urlencode 'access_key=xxx'\ +--data-urlencode 'ps=1'\ +--data-urlencode 'pn=1' +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [ + { + "id": 1241808, + "mid": 298264370, + "status": 4, + "originType": 1, + "reasonType": 9, + "originContent": "别在发这种傻逼视频了好吗?真要搞到禁摩才甘心。", + "punishResult": 6, + "punishTitle": "在评论中发布引战言论", + "judgeType": 1, + "originUrl": "https://www.bilibili.com/video/av328669697/#reply3165369965", + "blockedDays": 7, + "putTotal": 251, + "voteRule": 14, + "voteBreak": 140, + "voteDelete": 373, + "startTime": 1594528662, + "endTime": 1594530687, + "ctime": 1594528108, + "mtime": 1594530802, + "originTitle": "我这里有记录仪!略略略略略略哈哈哈,干得漂亮!", + "relationId": "3165369965-1-328669697", + "face": "http://i1.hdslb.com/bfs/face/d69912bb2a51f08176bcdbf4ba15e4c2b0962ad9.jpg", + "uname": "MyLSTicKnight", + "vote": 4, + "voteTime": 1594528700000, + "case_type": 0 + } + ] +} +``` + +## 众议观点 + +> http://api.bilibili.com/x/credit/jury/case/opinion + +*请求方式:GET* + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ------------ | ------ | ------------- | ------------- | +| cid | num | 案件id | 必要 | | +| ps | num | 每页项数 | 非必要 | 默认为10 | +| pn | num | 页码 | 非必要 | 默认为1 | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ------ | -------- | ------------ | +| code | num | 返回值 | 0:成功
-400:请求错误 | +| message | str | 信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 数据本体 | | + +`data` 对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ------ | -------- | ------------ | +| count | num | 观点总数 | | +| opinion | 有效时:array
无效时:null | 观点列表 | | + +`data` 中的`opinion` 数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | ------------ | +| 0 | obj | 观点1 | | +| n | obj | 观点(n+1) | 按照时间顺序 | +| …… | obj | …… | …… | + +`opinion` 数组中的对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ------ | -------- | ------------ | +| mid | num | 用户UID | 仅非匿名有此项 | +| face | str | 用户头像 | 仅非匿名有此项 | +| name | str | 用户昵称 | 仅非匿名有此项 | +| opid | num | 观点ID | | +| vote | num | 投票选择 | **见上表** | +| content | str | 观点内容 | | +| attr | num | 是否匿名 | 0:匿名
1:不匿名 | +| hate | num | 喜欢人数 | | +| like | num | 不喜欢人数 | | + +**示例:** + +查看案件`1239790`的众议观点,每页10项,查看第一页 + +```shell +curl -G 'http://api.bilibili.com/x/credit/jury/case/opinion'\ +--data-urlencode 'cid=1239790'\ +--data-urlencode 'ps=10'\ +--data-urlencode 'pn=1'\ +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "count": 23, + "opinion": [ + { + "opid": 250943982, + "vote": 2, + "content": "不懂,正常的科普也有人杠吗?没文化真可怕", + "attr": 0, + "hate": 0, + "like": 0 + }, + { + "mid": 59894, + "face": "http://i2.hdslb.com/bfs/face/0cc48fc40867537d5a09a125e90f76183efbfdfa.gif", + "name": "雷歐諾斯", + "opid": 250956267, + "vote": 2, + "content": "这个虽然不是正确的说法,但本身是一种观点。而且已经成为一种梗了。不属于引战。", + "attr": 1, + "hate": 0, + "like": 0 + }, + { + "opid": 250956259, + "vote": 2, + "content": "正常科普,不构成引战。", + "attr": 0, + "hate": 0, + "like": 0 + }, + { + "mid": 215020429, + "face": "http://i1.hdslb.com/bfs/face/1d43c302e67db4d21b9c5c0f0dc0b8786e8086d5.jpg", + "name": "瞎子广_广告歌41", + "opid": 250955160, + "vote": 2, + "content": "这个其实也没啥事真的", + "attr": 1, + "hate": 0, + "like": 0 + }, + { + "mid": 108194360, + "face": "http://i0.hdslb.com/bfs/face/b78c92a69ff9977b7d08d4f7edc0a051a3d6ea3e.jpg", + "name": "籽云奕", + "opid": 250953998, + "vote": 2, + "content": "仅仅是科普评论,无过激言论", + "attr": 1, + "hate": 0, + "like": 0 + }, + { + "mid": 34503714, + "face": "http://i2.hdslb.com/bfs/face/eb2d0853235a56d035303f4f3614dcb6e0cf66fa.jpg", + "name": "十六夜紅月丶", + "opid": 250950982, + "vote": 2, + "content": "无过激言论,正常科普罢了", + "attr": 1, + "hate": 0, + "like": 0 + }, + { + "opid": 250950973, + "vote": 2, + "content": "其实两种读法都是正确的,虽然想要纠正别人的错误。不过自己本身就错了。还是保留吧,没什么引战的", + "attr": 0, + "hate": 0, + "like": 0 + }, + { + "mid": 436136443, + "face": "http://i1.hdslb.com/bfs/face/6b4151d8e030eddd073add6ef18ccbb00aa48d0f.jpg", + "name": "兄弟好牛啤", + "opid": 250950417, + "vote": 2, + "content": "有点经典的争议,但可能还会有人不知道", + "attr": 1, + "hate": 0, + "like": 0 + }, + { + "mid": 87385400, + "face": "http://i2.hdslb.com/bfs/face/0f567e7fa49bcef22010f3ff78e90553d8fffb09.jpg", + "name": "小学生de王者荣耀", + "opid": 250950402, + "vote": 2, + "content": "合理纠正up主的错误,建议追究恶意举报者的责任", + "attr": 1, + "hate": 0, + "like": 0 + }, + { + "opid": 250949840, + "vote": 2, + "content": "正常科普,没有过激言论,建议保留", + "attr": 0, + "hate": 0, + "like": 0 + } + ] + } +} +``` + diff --git a/other/errcode.md b/other/errcode.md new file mode 100644 index 0000000..9e0a042 --- /dev/null +++ b/other/errcode.md @@ -0,0 +1,59 @@ +# 公共错误码 + +下表为大部分接口返回值中`code`字段的值中公共的错误代码 + +## 权限类: + +| 代码 | 含义 | +| ---- | ------------------------ | +| -1 | 应用程序不存在或已被封禁 | +| -2 | Access Key错误 | +| -3 | API校验密匙错误 | +| -4 | 调用方对该Method没有权限 | +| -101 | 账号未登录 | +| -102 | 账号被封停 | +| -103 | 积分不足 | +| -104 | 硬币不足 | +| -105 | 验证码错误 | +| -106 | 账号非正式会员或在适应期 | +| -107 | 应用不存在或者被封禁 | +| -108 | 未绑定手机 | +| -110 | 未绑定手机 | +| -111 | csrf 校验失败 | +| -112 | 系统升级中 | +| -113 | 账号尚未实名认证 | +| -114 | 请先绑定手机 | +| -115 | 请先完成实名认证 | + +## 请求类: + +| 代码 | 含义 | +| ---- | --------------------- | +| -304 | 木有改动 | +| -307 | 撞车跳转 | +| -400 | 请求错误 | +| -401 | 未认证 | +| -403 | 访问权限不足 | +| -404 | 啥都木有 | +| -405 | 不支持该方法 | +| -409 | 冲突 | +| -500 | 服务器错误 | +| -503 | 过载保护,服务暂不可用 | +| -504 | 服务调用超时 | +| -509 | 超出限制 | +| -616 | 上传文件不存在 | +| -617 | 上传文件太大 | +| -625 | 登录失败次数太多 | +| -626 | 用户不存在 | +| -628 | 密码太弱 | +| -629 | 用户名或密码错误 | +| -632 | 操作对象数量限制 | +| -643 | 被锁定 | +| -650 | 用户等级太低 | +| -652 | 重复的用户 | +| -658 | Token 过期 | +| -662 | 密码时间戳过期 | +| -688 | 地理区域限制 | +| -689 | 版权限制 | +| -701 | 扣节操失败 | + diff --git a/user/space.md b/user/space.md index 8cb2f0d..c925a0d 100644 --- a/user/space.md +++ b/user/space.md @@ -1934,7 +1934,7 @@ curl 'http://api.bilibili.com/x/space/channel/edit'\ ### 删除频道 -> http://api.bilibili.com/x/space/channel/del +> http://api.bilibili.com/x/space/channel/del *请求方式:POST* @@ -2136,7 +2136,7 @@ curl 'http://api.bilibili.com/x/space/channel/video/sort'\ ### 检查频道中有无失效视频 -> http://api.bilibili.com/x/space/channel/video/check +> http://api.bilibili.com/x/space/channel/video/check *请求方式:GET* @@ -2154,7 +2154,7 @@ curl 'http://api.bilibili.com/x/space/channel/video/sort'\ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
-404:无此项
53005:频道内有失效视频 | +| code | num | 返回值 | 0:成功
-101:账号未登录
-400:请求错误
-404:无此项
53005:频道内有失效视频 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | | @@ -2182,7 +2182,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check ### 查询用户创建的视频收藏夹 -> http://api.bilibili.com/x/v3/fav/folder/created/list-all +> http://api.bilibili.com/x/v3/fav/folder/created/list-all *请求方式:GET* @@ -2304,7 +2304,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all'\ ### 查询用户收藏的视频收藏夹 -> http://api.bilibili.com/x/v3/fav/folder/collected/list +> http://api.bilibili.com/x/v3/fav/folder/collected/list *请求方式:GET*