mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2025-02-16 06:00:08 +08:00
332 lines
14 KiB
Markdown
332 lines
14 KiB
Markdown
# 风纪委员会用户基本信息
|
||
|
||
## 基本数据
|
||
|
||
> https://api.bilibili.com/x/credit/v2/jury/jury
|
||
|
||
*请求方式：GET*
|
||
|
||
认证方式：Cookie（SESSDATA）或 APP
|
||
|
||
**url 参数：**
|
||
|
||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||
| ---------- | ---- | -------------- | ------------ | ---- |
|
||
| access_key | str | APP 登录 Token | APP 方式必要 | |
|
||
|
||
**json 回复：**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ------ | -------- | ----------------------------- |
|
||
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
|
||
| message | str | 信息 | 默认为 0 |
|
||
| ttl | num | 1 | |
|
||
| data | object | 数据本体 | |
|
||
|
||
`data` 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------ | ---- | ------------ | -------------------------------------------------------------------------------------------------- |
|
||
| allow_apply | bool | true | 尚不明确（用户从未担任风纪委员时也为 true） |
|
||
| apply_status | num | 任期审核状态 | -1 资格失效，且未申请<br />0 刚申请连任时<br />5 申请后，等待审核<br />3 申请连任成功，status 为 1 |
|
||
| case_total | num | 总众裁数 | |
|
||
| err_msg | str | 空 | 尚不明确 |
|
||
| face | str | 用户头像 url | |
|
||
| status | num | 当前资格状态 | 0 未曾拥有资格<br />1 任期内<br />2 资格失效 |
|
||
| term_end | num | 任期结束时间 | 时间戳（秒级），无任期时为 0 |
|
||
| uname | str | 用户昵称 | |
|
||
|
||
## 基本数据(旧API)
|
||
|
||
部分字段信息停留在 2021 年 10 月。
|
||
|
||
<details>
|
||
<summary>查看折叠内容：</summary>
|
||
|
||
> 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：具有资格<br />2：资格失效 |
|
||
| uname | str | 用户昵称 | |
|
||
|
||
</details>
|
||
|
||
## 统计信息
|
||
|
||
新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：成功<br />-101：账号未登录<br />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 不合格<br />1 合格 |
|
||
| status | num | 当前资格状态 | 0 未曾拥有资格<br />1 任期内<br />2 资格失效 |
|
||
| apply_status | num | 当前资格申请状态 | -1 资格失效，且未申请<br />0 刚申请连任时<br />5 申请后，等待审核<br />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 |
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
注：本示例未传入`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
|
||
}
|
||
}
|
||
}
|
||
```
|
||
</details>
|
||
|
||
## 统计信息(旧API)
|
||
|
||
<details>
|
||
<summary>查看折叠内容：</summary>
|
||
|
||
> 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：成功<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 | 任期完成度 | 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'
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```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
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
</details>
|
||
</details>
|
||
|
||
## 检查申请风纪委员会资格
|
||
|
||
> ~~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：成功<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 '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'
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "0",
|
||
"ttl": 1,
|
||
"data": {
|
||
"blocked": false,
|
||
"cert": true,
|
||
"rule": true
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|