# 风纪委员会用户基本信息
- [基本数据](#基本数据)
- [统计信息](#统计信息)
- [新API（2021年10月任期之后）](#新api2021年10月任期之后)
- [旧API](#旧api)
- [检查申请风纪委员会资格](#检查申请风纪委员会资格)
---
## 基本数据
> https://api.bilibili.com/x/credit/v2/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` 对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------ | -------------------------------------------------------------------------------------------------- |
| allow_apply | bool | true | 尚不明确（用户从未担任风纪委员时也为 true） |
| apply_status | num | 任期审核状态 | -1 资格失效，且未申请
0 刚申请连任时
5 申请后，等待审核
3 申请连任成功，status 为 1 |
| case_total | num | 总众裁数 | |
| err_msg | str | 空 | 尚不明确 |
| face | str | 用户头像 url | |
| status | num | 当前资格状态 | 0 未曾拥有资格
1 任期内
2 资格失效 |
| term_end | num | 任期结束时间 | 时间戳（秒级），无任期时为 0 |
| uname | str | 用户昵称 | |
**旧API**
部分字段信息停留在 2021 年 10 月。
查看旧 api：
> https://api.bilibili.com/x/credit/jury/jury （旧）
根数据与新 API 一致，`data` 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------------------- | ---------------------------- |
| caseTotal | num | 总众裁数 | |
| face | str | 用户头像 url | |
| restDays | num | 当前资格剩余天数 | 自 2021 年 10 月起，固定为 0 |
| rightRadio | num | 当前裁决正确率百分比 | 裁决数小于 3 时固定为 50 |
| status | num | 当前状态 | 1：具有资格
2：资格失效 |
| uname | str | 用户昵称 | |
## 统计信息
#### 新API（2021年10月任期之后）
>https://api.bilibili.com/x/credit/v2/jury/kpi
*方式：GET*
认证方式：Cookie
***备注**：该api只收录2021年10月开始，风纪委员改版之后的数据，且每次只返回一次任期的数据。*
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------- | ------------ | -------------------------------------- |
| term_id | num | 任期 id | 可不填或留空 | 不填或留空时，**只**返回上一任期的数据 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | -------------------------------------------------------------------------------- |
| code | num | 返回值 | 0：成功
-101：账号未登录
25018：不能进行此操作（还没有成为新风纪委员） |
| message | str | 信息 | 默认为 0 |
| ttl | num | 1 | |
| data | object | 数据本体 | |
`data` 对象：
| 项 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------------ | -------------------------------------------------------------------------------------------------- |
| mid | num | 用户 UID | |
| uname | str | 留空 | |
| face | str | 留空 | |
| term_id | num | 任期 ID | |
| term_start | num | 任期开始时间 | 时间戳，精确到秒 |
| term_end | num | 任期结束时间 | 时间戳，精确到秒 |
| case_total | num | 任内总投票数 | |
| active_days | num | 活跃天数 | |
| like_num | num | 发表观点，被点赞数 | |
| accuracy_rate | num | 投中率 | 所选观点与大多数风纪委员一致，记为一次“投中” |
| pass | num | 任期是否合格 | 0 不合格
1 合格 |
| status | num | 当前资格状态 | 0 未曾拥有资格
1 任期内
2 资格失效 |
| apply_status | num | 当前资格申请状态 | -1 资格失效，且未申请
0 刚申请连任时
5 申请后，等待审核
3 申请连任成功，status 为 1 |
| prev_term_id | num | 上一任期的任期 ID | 新版风纪委员启用后的第一个任期，此项的值为 0 |
| next_term_id | num | 下一任期的任期 ID | 本次任期统计结果未出来时，上一任期此项的值为 0 |
| rewards.pendant | num | 头像挂件礼包 ID | 合格后一般为 1，不合格为 0 |
| rewards.coin | num | 硬币礼包 ID | 合格后一般为 3，不合格为 0 |
#### 旧API
> http://api.bilibili.com/x/credit/jury/kpi （旧）
*方式：GET*
认证方式：Cookie（SESSDATA）或APP
***备注**：该api只统计到2021年9月任期，风纪委员改版之前。风纪委员改版之后的数据未收录*
**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 | 任期完成度 | 1=A；2=S；3=S+；4=S++ |
| 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 （旧版）
> http://api.bilibili.com/x/credit/v2/jury/requirement （新版）
*请求方式：GET*
认证方式：Cookie（SESSDATA）或APP
新版 api 与旧版的区别仅在新版没有 `level` 字段（新版风纪委员没有等级限制）。
只有用户~~会员等级≥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 'https://api.bilibili.com/x/credit/v2/jury/requirement' \
-b 'SESSDATA=xxx'
```
APP方式：
```shell
curl -G 'https://api.bilibili.com/x/credit/v2/jury/requirement' \
--data-urlencode 'access_key=xxx'
```
查看响应示例：
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"blocked": false,
"cert": true,
"rule": true
}
}
```