XFE Git
XFE Studio Git
Git 首页 全局搜索
XFE 主站 文档 NuGet
公开
关注 0 Fork 0 Star 0
返回提交历史

XFEstudio/bilibili-API-collect

更新若干风纪委员会相关的接口 (#562)

* 更新风纪委员基本信息 2021年9月开始风纪委员改版之后,原API不再统计新数据,现将其信息更新 * 更新若干jury的接口 1. 更新仲裁操作、仲裁信息相关api 2. 修改风纪委员会用户基本信息某些字段的说明 * Update judgement_info.md

8b31162
Qiuyelin <85266337+pooneyy@users.noreply.github.com>
提交于

代码差异

3 个文件 +632 -30
Modified blackroom/jury/action.md +152 -0
@@ -8,6 +8,51 @@
8 8
9 9 ## 申请加入风纪委员会
10 10
11 > https://api.bilibili.com/x/credit/v2/jury/apply
12
13 *请求方式:POST*
14
15 认证方式:Cookie
16
17 只有用户会员90天内无违规、实名认证且非封禁状态才可以申请加入风纪委员会
18
19
20 申请成功后可获得30天资格
21
22 **正文参数( application/x-www-form-urlencoded):**
23
24 | 参数名 | 类型 | 内容 | 必要性 |
25 | ------ | ---- | ---------------------- | ------ |
26 | csrf | str | cookie中`bili_jct`的值 | 必要 |
27
28 **json回复:**
29
30 根对象:
31
32 | 字段 | 类型 | 内容 | 备注 |
33 | ------- | ---- | ------ | ------------------------------------------------------------ |
34 | code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-111:csrf 校验失败<br />25001:申请等级限制(会员等级<3)<br />25002:没有实名认证<br />25003:90天内有封禁记录<br />25013:不能重复申请风纪委资格<br />25016:当日风纪委员名额已发完 |
35 | message | str | 信息 | 默认为0 |
36 | ttl | num | 1 | |
37
38
39 <details>
40 <summary>查看响应示例:</summary>
41
42 ```json
43 {
44 "code": 0,
45 "message": "0",
46 "ttl": 1
47 }
48 ```
49
50 </details>
51
52 #### 旧API
53 <details>
54 <summary>查看旧版API:</summary>
55
11 56 > http://api.bilibili.com/x/credit/jury/apply
12 57
13 58 *请求方式:POST*
@@ -64,10 +109,70 @@ curl 'http://api.bilibili.com/x/credit/jury/apply' \
64 109 }
65 110 ```
66 111
112 </details>
67 113 </details>
68 114
69 115 ## 拉取新案件
70 116
117 > https://api.bilibili.com/x/credit/v2/jury/case/next
118
119 *请求方式:GET*
120
121 认证方式:Cookie
122
123 **标头参数(Headers):**
124
125 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
126 | ------ | ---- | ------ | ------ | ---- |
127 | Cookie | str | Cookie | 必要 | |
128
129 **json回复:**
130
131 根对象:
132
133 | 字段 | 类型 | 内容 | 备注 |
134 | ------- | ------ | -------- | ------------------------------------------------------------ |
135 | code | num | 返回值 | 0:成功<br/>25006:风纪委员资格已过期<br />25008:没有案件<br/>25014:已审满 |
136 | message | str | 信息 | 默认为0,当code不为0时,显示错误信息 |
137 | ttl | num | 1 | 作用尚不明确 |
138 | data | object | 数据本体 | |
139
140 `data`对象:
141
142 | 字段 | 类型 | 内容 | 备注 |
143 | ------- | ---- | ---------- | ---- |
144 | case_id | str | 仲裁案件id | |
145
146 **示例:**
147
148 Cookie方式:
149
150 ```shell
151 curl -G 'https://api.bilibili.com/x/credit/v2/jury/case/next' \
152 --header 'cookie: XXXXX'
153 ```
154
155
156 <details>
157 <summary>查看响应示例:</summary>
158
159 ```json
160 {
161 "code": 0,
162 "message": "0",
163 "ttl": 1,
164 "data": {
165 "case_id": "AC2m4HlrIrHv"
166 }
167 }
168 ```
169
170 </details>
171
172 #### 旧API
173 <details>
174 <summary>查看旧版API:</summary>
175
71 176 > http://api.bilibili.com/x/credit/jury/caseObtain
72 177
73 178 *请求方式:POST*
@@ -130,9 +235,55 @@ curl 'http://api.bilibili.com/x/credit/jury/caseObtain' \
130 235 ```
131 236
132 237 </details>
238 </details>
239
133 240
134 241 ## 进行仲裁投票
135 242
243 > https://api.bilibili.com/x/credit/v2/jury/vote
244
245 *请求方式:POST*
246
247 认证方式:Cookie
248
249 **正文参数( application/x-www-form-urlencoded ):**
250
251 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
252 | --------- | ---- | ---------------------- | ------ | ----------------------------------------------------- |
253 | case_id | str | 案件id | 必要 | |
254 | vote | num | 投票类型 | 必要 | 见「[众裁信息](judgement_info.md)」中表 |
255 | insiders | num | 是否观看此类视频 | 非必要 | 默认值为0<br/>见「[众裁信息](judgement_info.md)」中表 |
256 | content | str | 理由 | 非必要 | |
257 | anonymous | num | 是否匿名 | 非必要 | 默认值为0<br/>0:不匿名<br />1:匿名 |
258 | csrf | str | cookie中`bili_jct`的值 | 必要 | |
259
260 **json回复:**
261
262 根对象:
263
264 | 字段 | 类型 | 内容 | 备注 |
265 | ------- | ---- | ------ | ------------------------------------------------------------ |
266 | code | num | 返回值 | 0:成功<br/>-101:未登录<br />-111:csrf 错误<br />-400:请求错误(投票类型错误)<br />25005:不是风纪委员<br />25011:投票类型错误<br />25018:不能进行此操作<br/><br/>*注:新版本对于一个不存在的`case_id`,不会报错。* |
267 | message | str | 信息 | 默认为0 |
268 | ttl | num | 1 | 作用尚不明确 |
269
270
271 <details>
272 <summary>查看响应示例:</summary>
273
274 ```json
275 {
276 "code": 0,
277 "message": "0",
278 "ttl": 1
279 }
280 ```
281
282 </details>
283
284 #### 旧API
285 <details>
286 <summary>查看旧版API:</summary>
136 287 > http://api.bilibili.com/x/credit/jury/vote
137 288
138 289 *请求方式:POST*
@@ -213,3 +364,4 @@ curl 'http://api.bilibili.com/x/credit/jury/vote' \
213 364 ```
214 365
215 366 </details>
367 </details>
Modified blackroom/jury/base_info.md +5 -2
@@ -115,11 +115,13 @@ _请求方式:GET_
115 115 | status | num | 当前资格状态 | 0 未曾拥有资格<br />1 任期内<br />2 资格失效 |
116 116 | apply_status | num | 当前资格申请状态 | -1 资格失效,且未申请<br />0 刚申请连任时<br />5 申请后,等待审核<br />3 申请连任成功,status 为 1 |
117 117 | prev_term_id | num | 上一任期的任期 ID | 新版风纪委员启用后的第一个任期,此项的值为 0 |
118 | next_term_id | num | 下一任期的任期 ID | 本次任期统计结果未出来时,上一任期此项的值为 0 |
118 | next_term_id | num | 下一任期的任期 ID | 若任期尚未结束,此项的值为 0 |
119 119 | rewards.pendant | num | 头像挂件礼包 ID | 合格后一般为 1,不合格为 0 |
120 120 | rewards.coin | num | 硬币礼包 ID | 合格后一般为 3,不合格为 0 |
121 121
122 122 #### 旧API
123 <details>
124 <summary>查看旧 api:</summary>
123 125
124 126 > http://api.bilibili.com/x/credit/jury/kpi (旧)
125 127
@@ -222,11 +224,12 @@ curl -G 'http://api.bilibili.com/x/credit/jury/kpi' \
222 224 }
223 225 ```
224 226
227 </details>
225 228 </details>
226 229
227 230 ## 检查申请风纪委员会资格
228 231
229 > http://api.bilibili.com/x/credit/jury/requirement (旧版)
232 > ~~http://api.bilibili.com/x/credit/jury/requirement~~ (旧版)
230 233
231 234 > http://api.bilibili.com/x/credit/v2/jury/requirement (新版)
232 235