更新若干风纪委员会相关的接口 (#562)

* 更新风纪委员基本信息

2021年9月开始风纪委员改版之后,原API不再统计新数据,现将其信息更新

* 更新若干jury的接口

1. 更新仲裁操作、仲裁信息相关api
2. 修改风纪委员会用户基本信息某些字段的说明

* Update judgement_info.md
This commit is contained in:
Qiuyelin
2022-12-26 23:02:56 +08:00
committed by GitHub
parent 1c6d11137a
commit 8b3116206a
3 changed files with 632 additions and 30 deletions

View File

@@ -8,6 +8,51 @@
## 申请加入风纪委员会
> https://api.bilibili.com/x/credit/v2/jury/apply
*请求方式POST*
认证方式Cookie
只有用户会员90天内无违规、实名认证且非封禁状态才可以申请加入风纪委员会
申请成功后可获得30天资格
**正文参数( application/x-www-form-urlencoded**
| 参数名 | 类型 | 内容 | 必要性 |
| ------ | ---- | ---------------------- | ------ |
| csrf | str | cookie中`bili_jct`的值 | 必要 |
**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 | |
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
</details>
#### 旧API
<details>
<summary>查看旧版API</summary>
> http://api.bilibili.com/x/credit/jury/apply
*请求方式POST*
@@ -64,10 +109,70 @@ curl 'http://api.bilibili.com/x/credit/jury/apply' \
}
```
</details>
</details>
## 拉取新案件
> https://api.bilibili.com/x/credit/v2/jury/case/next
*请求方式GET*
认证方式Cookie
**标头参数Headers**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------ | ------ | ---- |
| Cookie | str | Cookie | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br/>25006风纪委员资格已过期<br />25008没有案件<br/>25014已审满 |
| message | str | 信息 | 默认为0当code不为0时显示错误信息 |
| ttl | num | 1 | 作用尚不明确 |
| data | object | 数据本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ---------- | ---- |
| case_id | str | 仲裁案件id | |
**示例:**
Cookie方式
```shell
curl -G 'https://api.bilibili.com/x/credit/v2/jury/case/next' \
--header 'cookie: XXXXX'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"case_id": "AC2m4HlrIrHv"
}
}
```
</details>
#### 旧API
<details>
<summary>查看旧版API</summary>
> http://api.bilibili.com/x/credit/jury/caseObtain
*请求方式POST*
@@ -130,9 +235,55 @@ curl 'http://api.bilibili.com/x/credit/jury/caseObtain' \
```
</details>
</details>
## 进行仲裁投票
> https://api.bilibili.com/x/credit/v2/jury/vote
*请求方式POST*
认证方式Cookie
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | ---------------------- | ------ | ----------------------------------------------------- |
| case_id | str | 案件id | 必要 | |
| vote | num | 投票类型 | 必要 | 见「[众裁信息](judgement_info.md)」中表 |
| insiders | num | 是否观看此类视频 | 非必要 | 默认值为0<br/>见「[众裁信息](judgement_info.md)」中表 |
| content | str | 理由 | 非必要 | |
| anonymous | num | 是否匿名 | 非必要 | 默认值为0<br/>0不匿名<br />1匿名 |
| csrf | str | cookie中`bili_jct`的值 | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------ | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br/>-101未登录<br />-111csrf 错误<br />-400请求错误投票类型错误<br />25005不是风纪委员<br />25011投票类型错误<br />25018不能进行此操作<br/><br/>*注:新版本对于一个不存在的`case_id`,不会报错。* |
| message | str | 信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
</details>
#### 旧API
<details>
<summary>查看旧版API</summary>
> http://api.bilibili.com/x/credit/jury/vote
*请求方式POST*
@@ -213,3 +364,4 @@ curl 'http://api.bilibili.com/x/credit/jury/vote' \
```
</details>
</details>