修改并补完风纪委相关 并勘误

This commit is contained in:
SocialSisterYi 2020-08-02 10:06:21 +08:00
parent aeef858c64
commit 4ee9074f22
8 changed files with 1102 additions and 633 deletions

View File

@ -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)√

View File

@ -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 | 来源筛选 | 非必要 | 空:全部类型<br />0系统封禁<br />1风纪仲裁 |
| otype | num | 类型筛选 | 非必要 | 0全部类型<br />1评论<br />2弹幕<br />3私信<br />4标签<br />5个人资料<br />6投稿<br />8专栏<br />10动态<br />11相簿 |
| pn | num | 页码 | 非必要 | 默认为1 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---------------------------------------------- |
| btype | num | 来源筛选 | 非必要 | 空:全部类型<br />0系统封禁<br />1风纪仲裁 |
| otype | num | 类型筛选 | 非必要 | **见上表**<br />**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全部类型<br />1评论<br />2弹幕<br />3私信<br />4标签<br />5个人资料<br />6投稿<br />8专栏<br />10动态<br />11相簿 |
| originTypeName | str | 来源名 | |
| punishTitle | str | 公示标题 | |
| punishTime | num | 处罚时间 | 时间戳 |
| punishType | num | 处理手段类型 | 2封禁<br />3永久封禁 |
| punishTypeName | str | 处理手段名 | |
| moralNum | num | 0 | 作用尚不明确 |
| blockedDays | num | 封禁天数 | 永封为0 |
| publishStatus | num | 1 | 作用尚不明确 |
| blockedType | num | 处理来源 | 0系统封禁<br />1风纪仲裁 |
| blockedForever | num | 是否永封 | 0非永封<br />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封禁<br />3永久封禁 |
| punishTypeName | str | 处理手段名 | |
| moralNum | num | 0 | 作用尚不明确 |
| blockedDays | num | 封禁天数 | 永封为0 |
| publishStatus | num | 1 | 作用尚不明确 |
| blockedType | num | 处理来源 | 0系统封禁<br />1风纪仲裁 |
| blockedForever | num | 是否永封 | 0非永封<br />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全部类型<br />1评论<br />2弹幕<br />3私信<br />4标签<br />5个人资料<br />6投稿<br />8专栏<br />10动态<br />11相簿 |
| originTypeName | str | 来源名 | |
| punishTitle | str | 公示标题 | |
| punishTime | num | 处罚时间 | 时间戳 |
| punishType | num | 处理手段类型 | 2封禁<br />3永久封禁 |
| punishTypeName | str | 处理手段名 | |
| moralNum | num | 0 | 作用尚不明确 |
| blockedDays | num | 封禁天数 | 永封为0 |
| publishStatus | num | 1 | 作用尚不明确 |
| blockedType | num | 处理来源 | 0系统封禁<br />1风纪仲裁 |
| blockedForever | num | 是否永封 | 0非永封<br />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封禁<br />3永久封禁 |
| punishTypeName | str | 处理手段名 | |
| moralNum | num | 0 | 作用尚不明确 |
| blockedDays | num | 封禁天数 | 永封为0 |
| publishStatus | num | 1 | 作用尚不明确 |
| blockedType | num | 处理来源 | 0系统封禁<br />1风纪仲裁 |
| blockedForever | num | 是否永封 | 0非永封<br />1永封 |
| reasonType | num | 违规类型 | **违规类型见表** |
| reasonTypeName | str | 违规类型名称 | |
| operatorName | str | 空 | 作用尚不明确 |
| caseId | num | 仲裁信息 | 系统封禁时固定为0 |
| ctime | num | 创建时间 | 时间戳 |
| commentSum | num | 该条目评论数 | |
**示例:**

View File

@ -1,567 +0,0 @@
# 众裁信息
**本页所有操作均需登录SESSDATA**
投票类型码总览:
| 代码 | 意义 |
| - | ---- |
| 1 | 封禁 |
| 2 | 否 |
| 3 | 弃权 |
| 4 | 删除 |
## 基本数据
> <https://api.bilibili.com/x/credit/jury/jury>
*方式GET*
**JSON回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录 |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | object | 数据 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | -------- | ------------ |
| caseTotal | num | 众裁数 | |
| face | str | 头像url | |
| restDays | num | 剩余天数 | |
| rightRadio | num | 尚不明确 | |
| status | num | 状态 | 无法测试猜测1为风纪委员 |
| uname | str | 用户名 | |
**示例:**
查询我的数据
<https://api.bilibili.com/x/credit/jury/jury>
```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"
}
}
```
## 统计信息
> <https://api.bilibili.com/x/credit/jury/kpi>
*方式GET*
**JSON回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------ |
| code | num | 返回值 | 0成功<br />-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 | 观点获赞 | |
**示例:**
查询我的数据(删减至只有一个周期的)
<https://api.bilibili.com/x/credit/jury/kpi>
```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
}
]
}
```
## 查询单个案件
> <https://api.bilibili.com/x/credit/jury/juryCase>
只能查询我参与众裁的
*方式GET*
**url参数**
| 参数名 | 内容 | 必要性 | 备注 |
| ------ | ------------ | ------ | ------------- |
| cid | 案件id | 必要 | |
**JSON回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录 |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | object | 数据 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | -------- | ------------ |
| id | num | 案件id | |
| mid | num | 用户id | |
| status | num | 状态 | 4:已裁决<br />6:未裁决 |
| statusTitle | str | 封禁7/15天 | 就是这样的 |
| originType | num | 来源类型 | 需要对照表 |
| reasonType | num | 原因类型 | 需要对照表 |
| punishTitle | str | 处罚原因 | |
| judgeType | num | 裁决类型 | 0:未裁决<br/>1:违规<br/>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`的信息
<https://api.bilibili.com/x/credit/jury/juryCase?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
}
}
```
## 众裁记录
> <https://api.bilibili.com/x/credit/jury/caseList>
*方式GET*
**url参数**
| 参数名 | 内容 | 必要性 | 备注 |
| ------ | ------------ | ------ | ------------- |
| pn | 页码 | 非必要 | 无上限 |
| ps | 每页显示数量 | 非必要 | 默认30, 最大30 |
**JSON回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录 |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | array | 数据 | |
`data` 数组中的每个对象与获取单个案件信息相比
缺少`statusTitle`
增加`voteTime`, 内容为我的投票时间(毫秒)
**示例:**
查询我的历史众裁第1页每页显示1个案件
<https://api.bilibili.com/x/credit/jury/caseList?pn=1&ps=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
}
]
}
```
## 众议观点
> <https://api.bilibili.com/x/credit/jury/case/opinion>
*方式GET*
**url参数**
| 参数名 | 内容 | 必要性 | 备注 |
| ------ | ------------ | ------ | ------------- |
| cid | 案件id | 必要 | |
| pn | 页码 | 非必要 | |
| ps | 每页显示数量 | 非必要 | |
**JSON回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------ |
| code | num | 返回值 | 0成功<br />-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`的众议观点
<https://api.bilibili.com/x/credit/jury/case/opinion?cid=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
}
]
}
}
```
## 获取案件
> <https://api.bilibili.com/x/credit/jury/caseObtain>
参数为`csrf`, 必选
*方式POST*
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------ |
| code | num | 返回值 | 0: 成功<br/>25008: 没有案件<br/>25014: 已审满 |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | object | 数据 | |
**示例:**
获取一个案件
<https://api.bilibili.com/x/credit/jury/caseObtain>
参数:
```json
{
"csrf": "38e17ae249a8ea498eaea56a9743aa85a"
}
```
回复:
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"id": 1239790
}
}
```
## 进行众裁
> <https://api.bilibili.com/x/credit/jury/vote>
参数为`csrf`, 必选
*方式POST*
**正文参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ---------------- | ------ | ----------|
| cid | num | 案件id | 必要 | |
| vote | num | 投票类型 | 必要 | |
| content | str | 理由 | 非必要 | |
| csrf | str | csrf | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------ |
| code | num | 返回值 | 0: 成功<br/>25009: 案件不存在<br/>25012: 重复投票 |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | object | 数据 | |
**示例:**
给某个案件进行建议删除投票,没有理由
<https://api.bilibili.com/x/credit/jury/vote>
参数:
```json
{
"cid": 1234567,
"vote": 4,
"csrf": "38e17ae249a8ea498eaea56a9743aa85a"
}
```
回复:
```json
{
"code": 0,
"message": "0",
"ttl": 1
}

198
blackroom/jury/action.md Normal file
View File

@ -0,0 +1,198 @@
# 仲裁操作
**本页所有操作均需登录Cookie或APP**
## 申请加入风纪委员会
> http://api.bilibili.com/x/credit/jury/apply
*请求方式POST*
认证方式CookieSESSDATA或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成功<br />-101账号未登录<br />-111csrf 校验失败<br />25001申请等级限制(会员等级<3)<br />25002没有实名认证<br />2500390天内有封禁记录<br />25013不能重复申请风纪委资格<br />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*
认证方式CookieSESSDATA或APP
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br/>25005不是风纪委员<br />25008没有案件<br/>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*
认证方式CookieSESSDATA或APP
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | ------------------------ | -------------- | --------------------------------------- |
| cid | num | 案件ID | 必要 | |
| vote | num | 投票类型 | 必要 | |
| content | str | 理由 | 非必要 | 见「[众裁信息](judgement_info.md)」中表 |
| likes | nums | 支持的观点 | 非必要 | |
| hates | nums | 反对的观点 | 非必要 | |
| attr | num | 是否匿名 | 非必要 | 0匿名<br />1不匿名 |
| apply_type | num | 是否更改原因 | 非必要 | 0保持原来原因<br />1投票给新原因 |
| origin_reason | num | 原始原因 | 非必要 | 见「封禁公示」中表 |
| apply_reason | num | 新原因 | 非必要 | 见「封禁公示」中表 |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------ | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br/>-101未登录<br />-111csrf 错误<br />25005不是风纪委员<br />25009 案件不存在<br/>25011投票类型错误<br />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
}
```

236
blackroom/jury/base_info.md Normal file
View File

@ -0,0 +1,236 @@
# 风纪委员会用户基本信息
**本页所有操作均需登录Cookie或APP**
## 基本数据
> http://api.bilibili.com/x/credit/jury/jury
*请求方式GET*
认证方式CookieSESSDATA或APP
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ----------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录 |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | |
| data | object | 数据本体 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------------------- | ---------------------------- |
| caseTotal | num | 总众裁数 | |
| face | str | 用户头像url | |
| restDays | num | 当前资格剩余天数 | |
| rightRadio | num | 当前裁决正确率百分比 | 裁决数小于3时固定为50 |
| status | num | 当前状态 | 1具有资格<br />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*
认证方式CookieSESSDATA或APP
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | ----------------------------- |
| code | num | 返回值 | 0成功<br />-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*
认证方式CookieSESSDATA或APP
只有用户会员等级≥Lv4、90天内无违规、实名认证且非封禁状态才可以申请加入风纪委员会
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ----------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录 |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | |
| data | object | 数据本体 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ---------------- | ------------------------------------- |
| blocked | bool | 是否被封禁 | true<br />false<br />**下同** |
| 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
}
}
```

View File

@ -0,0 +1,525 @@
# 众裁信息
投票类型码总览:
| 代码 | 含义 |
| - | ---- |
| 0 | 未投票 |
| 1 | 封禁 |
| 2 | 否 |
| 3 | 弃权 |
| 4 | 删除 |
## 查询投票过的单个案件
> http://api.bilibili.com/x/credit/jury/juryCase
*请求方式GET*
认证方式CookieSESSDATA或APP
只能查询自己参与众裁的
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ------------ | ------ | ------------- | ------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| cid | num | 案件ID | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误<br />25010没有权限查看案件 |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | -------- | ------------ |
| id | num | 案件ID | |
| mid | num | 被举报用户UID | |
| status | num | 裁决状态 | 1投票中<br />2停止发放<br />3复核中结案中<br />4已裁决<br />5待重启<br />6未裁决<br />7冻结中<br />8队列中 |
| statusTitle | str | 封禁时间文字 | `judgeType`=1时有效 |
| originType | num | 来源类型 | 见「封禁公示」中表 |
| reasonType | num | 原因类型 | 见「封禁公示」中表 |
| originContent | str | 被举报的原文 | |
| punishResult | num | 处理结果 | 0<br />1封禁3天<br />2封禁7天<br />3永封<br />4其他封禁天数<br />5封禁15天<br />6仅删除不封禁 |
| punishTitle | str | 处罚原因 | |
| judgeType | num | 裁决类型 | `status`=4时有效<br />0未裁决<br/>1违规<br/>2不违规 |
| originUrl | str | 来源url | |
| blockedDays | num | 封禁时间 | `judgeType`=1时有效 |
| putTotal | num | | 作用尚不明确 |
| voteRule | num | 投票不违规人数 | |
| voteBreak | num | 投票建议封禁人数 | |
| voteDelete | num | 投票建议删除人数 | |
| startTime | num | 裁决起始时间 | 时间戳 |
| endTime | num | 裁决截止时间 | 时间戳<br />未结案固定为24小时 |
| ctime | num | 举报创建时间 | 时间戳 |
| mtime | num | 开始拉取时间 | 时间戳 |
| originTitle | str | 来源标题 | |
| relationId | str | 违规关系标识字 | 评论rpID-违规类型ID-来源对象ID |
| face | str | 被举报用户头像url | |
| uname | str | 被举报用户昵称 | |
| vote | num | 我的投票 | **见上表** |
| case_type | num | 众裁类型 | 0小众众裁<br />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成功<br />-400请求错误 |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | |
| data | 有效时obj<br />无效时null | 数据本体 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ----------------- | ------------------------------------------------------------ |
| id | num | 案件ID | |
| mid | num | 被举报用户UID | |
| status | num | 裁决状态 | 1投票中<br />2停止发放<br />3复核中结案中<br />4已裁决<br />5待重启<br />6未裁决<br />7冻结中<br />8队列中 |
| originType | num | 来源类型 | 见「封禁公示」中表 |
| reasonType | num | 原因类型 | 见「封禁公示」中表 |
| originContent | str | 被举报的原文 | |
| punishResult | num | 处理结果 | 0<br />1封禁3天<br />2封禁7天<br />3永封<br />4其他封禁天数<br />5封禁15天<br />6仅删除不封禁 |
| judgeType | num | 裁决类型 | `status`=4时有效<br />0未裁决<br/>1违规<br/>2不违规 |
| originUrl | str | 来源url | |
| blockedDays | num | 封禁时间 | `judgeType`=1时有效 |
| putTotal | num | | 作用尚不明确 |
| voteRule | num | 投票不违规人数 | |
| voteBreak | num | 投票建议封禁人数 | |
| voteDelete | num | 投票建议删除人数 | |
| startTime | num | 裁决起始时间 | 时间戳 |
| endTime | num | 裁决截止时间 | 时间戳<br />未结案固定为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小众众裁<br />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*
认证方式CookieSESSDATA或APP
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ------------ | ------ | ------------- | ------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页显示数量 | 非必要 | 默认为30<br />最大30 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-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投票中<br />2停止发放<br />3复核中结案中<br />4已裁决<br />5待重启<br />6未裁决<br />7冻结中<br />8队列中 |
| originType | num | 来源类型 | 见「封禁公示」中表 |
| reasonType | num | 原因类型 | 见「封禁公示」中表 |
| originContent | str | 被举报的原文 | |
| punishResult | num | 处理结果 | 0<br />1封禁3天<br />2封禁7天<br />3永封<br />4其他封禁天数<br />5封禁15天<br />6仅删除不封禁 |
| punishTitle | str | 处罚原因 | |
| judgeType | num | 裁决类型 | `status`=4时有效<br />0未裁决<br/>1违规<br/>2不违规 |
| originUrl | str | 来源url | |
| blockedDays | num | 封禁时间 | `judgeType`=1时有效 |
| putTotal | num | | 作用尚不明确 |
| voteRule | num | 投票不违规人数 | |
| voteBreak | num | 投票建议封禁人数 | |
| voteDelete | num | 投票建议删除人数 | |
| startTime | num | 裁决起始时间 | 时间戳 |
| endTime | num | 裁决截止时间 | 时间戳<br />未结案固定为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小众众裁<br />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成功<br />-400请求错误 |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | -------- | ------------ |
| count | num | 观点总数 | |
| opinion | 有效时array<br />无效时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匿名<br />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
}
]
}
}
```

59
other/errcode.md Normal file
View File

@ -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 | 扣节操失败 |

View File

@ -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成功<br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />-404无此项<br />53005频道内有失效视频 |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误<br />-404无此项<br />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*