bilibili-API-collect/blackroom/jury/base_info.md
2023-01-17 15:23:59 +08:00

14 KiB
Raw Blame History

风纪委员会用户基本信息


基本数据

https://api.bilibili.com/x/credit/v2/jury/jury

请求方式GET

认证方式CookieSESSDATA或 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 用户昵称

统计信息

新API2021年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 任期奖励 pendantcoin两个子项
rewards.pendant num 头像挂件礼包 ID 合格后一般为 1不合格为 0
rewards.coin num 硬币礼包 ID 合格后一般为 3不合格为 0
查看响应示例:

注:本示例未传入term_id,返回的是最近一次已结束任期的统计结果

{
    "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

查看旧 api

https://api.bilibili.com/x/credit/jury/kpi (旧)

方式GET

认证方式CookieSESSDATA或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=A2=S3=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方式

curl 'https://api.bilibili.com/x/credit/jury/kpi' \
-b 'SESSDATA=xxx'

APP方式

curl -G 'https://api.bilibili.com/x/credit/jury/kpi' \
--data-urlencode 'access_key=xxx'
查看响应示例:
{
    "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

认证方式CookieSESSDATA或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'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "blocked": false,
        "cert": true,
        "rule": true
    }
}