Skip to content

Latest commit

 

History

History
331 lines (252 loc) · 13.5 KB

base_info.md

File metadata and controls

331 lines (252 loc) · 13.5 KB
Raw

风纪委员会用户基本信息

基本数据

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，返回的是最近一次已结束任期的统计结果

{
    "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方式：

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

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