风纪委员会用户基本信息
基本数据
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 月。
查看折叠内容:
> 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 |
可不传此参数或将值留空或设为0 |
未传参或留空时,只返回最近一次已结束的任期的数据 |
json回复:
根对象:
| 字段 |
类型 |
内容 |
备注 |
| code |
num |
返回值 |
0:成功 -101:账号未登录 25018:不能进行此操作(还没有成为新风纪委员,或传入了不属于你的term_id) |
| message |
str |
信息 |
默认为 0 |
| ttl |
num |
1 |
|
| data |
object |
数据本体 |
|
data 对象:
| 项 |
类型 |
内容 |
备注 |
| mid |
num |
用户 UID |
|
| uname |
str |
留空 |
|
| face |
str |
留空 |
|
| term_id |
num |
任期 ID |
未传入term_id时,返回的是最近一次已结束的任期的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 |
object |
任期奖励 |
有pendant和coin两个子项 |
| rewards.pendant |
num |
头像挂件礼包 ID |
合格后一般为 1,不合格为 0 |
| rewards.coin |
num |
硬币礼包 ID |
合格后一般为 3,不合格为 0 |
查看响应示例:
注:本示例未传入`term_id`,返回的是最近一次已结束任期的统计结果
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 10001,
"uname": "",
"face": "",
"term_id": 300009,
"term_start": 1669100000,
"term_end": 1671690000,
"case_total": 591,
"active_days": 30,
"like_num": 0,
"accuracy_rate": 74,
"pass": 1,
"status": 1,
"apply_status": 3,
"prev_term_id": 300007,
"next_term_id": 0,
"rewards": {
"pendant": 1,
"coin": 3
}
}
}
```
统计信息(旧API)
查看折叠内容:
> https://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 'https://api.bilibili.com/x/credit/jury/kpi' \
-b 'SESSDATA=xxx'
```
APP方式:
```shell
curl -G 'https://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
}
]
}
```
检查申请风纪委员会资格
https://api.bilibili.com/x/credit/jury/requirement (旧版)
https://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方式:
curl 'https://api.bilibili.com/x/credit/v2/jury/requirement' \
-b 'SESSDATA=xxx'
APP方式:
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
}
}
```