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

* 更新风纪委员基本信息 2021年9月开始风纪委员改版之后，原API不再统计新数据，现将其信息更新 * 更新若干jury的接口 1. 更新仲裁操作、仲裁信息相关api 2. 修改风纪委员会用户基本信息某些字段的说明 * Update judgement_info.md
2024-12-27 13:00:29 +08:00 · 2022-12-26 23:02:56 +08:00 · 2022-12-26 23:02:56 +08:00 · 8b3116206a
commit 8b3116206a
parent 1c6d11137a
3 changed files with 632 additions and 30 deletions
--- a/blackroom/jury/action.md
+++ b/blackroom/jury/action.md
@ -8,6 +8,51 @@

 ## 申请加入风纪委员会

+> https://api.bilibili.com/x/credit/v2/jury/apply
+
+*请求方式：POST*
+
+认证方式：Cookie
+
+只有用户会员90天内无违规、实名认证且非封禁状态才可以申请加入风纪委员会
+
+
+申请成功后可获得30天资格
+
+**正文参数（ application/x-www-form-urlencoded）：**
+
+| 参数名 | 类型 | 内容                   | 必要性 |
+| ------ | ---- | ---------------------- | ------ |
+| csrf   | str  | cookie中`bili_jct`的值 | 必要   |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容   | 备注                                                         |
+| ------- | ---- | ------ | ------------------------------------------------------------ |
+| code    | num  | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf 校验失败<br />25001：申请等级限制(会员等级<3)<br />25002：没有实名认证<br />25003：90天内有封禁记录<br />25013：不能重复申请风纪委资格<br />25016：当日风纪委员名额已发完 |
+| message | str  | 信息   | 默认为0                                                      |
+| ttl     | num  | 1      |                                                              |
+
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "message": "0",
+    "ttl": 1
+}
+```
+
+</details>
+
+#### 旧API
+<details>
+<summary>查看旧版API：</summary>
+
 > http://api.bilibili.com/x/credit/jury/apply

 *请求方式：POST*
@ -64,10 +109,70 @@ curl 'http://api.bilibili.com/x/credit/jury/apply' \
 }
 ```

+</details>
 </details>

 ## 拉取新案件

+> https://api.bilibili.com/x/credit/v2/jury/case/next
+
+*请求方式：GET*
+
+认证方式：Cookie
+
+**标头参数（Headers）：**
+
+| 参数名 | 类型 | 内容   | 必要性 | 备注 |
+| ------ | ---- | ------ | ------ | ---- |
+| Cookie | str  | Cookie | 必要   |      |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型   | 内容     | 备注                                                         |
+| ------- | ------ | -------- | ------------------------------------------------------------ |
+| code    | num    | 返回值   | 0：成功<br/>25006：风纪委员资格已过期<br />25008：没有案件<br/>25014：已审满 |
+| message | str    | 信息     | 默认为0，当code不为0时，显示错误信息                         |
+| ttl     | num    | 1        | 作用尚不明确                                                 |
+| data    | object | 数据本体 |                                                              |
+
+`data`对象：
+
+| 字段    | 类型 | 内容       | 备注 |
+| ------- | ---- | ---------- | ---- |
+| case_id | str  | 仲裁案件id |      |
+
+**示例：**
+
+Cookie方式：
+
+```shell
+curl -G 'https://api.bilibili.com/x/credit/v2/jury/case/next' \
+--header 'cookie: XXXXX'
+```
+
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "message": "0",
+    "ttl": 1,
+    "data": {
+        "case_id": "AC2m4HlrIrHv"
+    }
+}
+```
+
+</details>
+
+#### 旧API
+<details>
+<summary>查看旧版API：</summary>
+
 > http://api.bilibili.com/x/credit/jury/caseObtain

 *请求方式：POST*
@ -130,9 +235,55 @@ curl 'http://api.bilibili.com/x/credit/jury/caseObtain' \
 ```

 </details>
+</details>
+

 ## 进行仲裁投票

+> https://api.bilibili.com/x/credit/v2/jury/vote
+
+*请求方式：POST*
+
+认证方式：Cookie
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名    | 类型 | 内容                   | 必要性 | 备注                                                  |
+| --------- | ---- | ---------------------- | ------ | ----------------------------------------------------- |
+| case_id   | str  | 案件id                 | 必要   |                                                       |
+| vote      | num  | 投票类型               | 必要   | 见「[众裁信息](judgement_info.md)」中表               |
+| insiders  | num  | 是否观看此类视频       | 非必要 | 默认值为0<br/>见「[众裁信息](judgement_info.md)」中表 |
+| content   | str  | 理由                   | 非必要 |                                                       |
+| anonymous | num  | 是否匿名               | 非必要 | 默认值为0<br/>0：不匿名<br />1：匿名                  |
+| csrf      | str  | cookie中`bili_jct`的值 | 必要   |                                                       |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容   | 备注                                                         |
+| ------- | ---- | ------ | ------------------------------------------------------------ |
+| code    | num  | 返回值 | 0：成功<br/>-101：未登录<br />-111：csrf 错误<br />-400：请求错误（投票类型错误）<br />25005：不是风纪委员<br />25011：投票类型错误<br />25018：不能进行此操作<br/><br/>*注：新版本对于一个不存在的`case_id`，不会报错。* |
+| message | str  | 信息   | 默认为0                                                      |
+| ttl     | num  | 1      | 作用尚不明确                                                 |
+
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "message": "0",
+    "ttl": 1
+}
+```
+
+</details>
+
+#### 旧API
+<details>
+<summary>查看旧版API：</summary>
 > http://api.bilibili.com/x/credit/jury/vote

 *请求方式：POST*
@ -213,3 +364,4 @@ curl 'http://api.bilibili.com/x/credit/jury/vote' \
 ```

 </details>
+</details>
--- a/blackroom/jury/base_info.md
+++ b/blackroom/jury/base_info.md
@ -115,11 +115,13 @@ _请求方式：GET_
 | 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                                                     |
+| next_term_id    | num  | 下一任期的任期 ID  | 若任期尚未结束，此项的值为 0                                                     |
 | rewards.pendant | num  | 头像挂件礼包 ID    | 合格后一般为 1，不合格为 0                                                                         |
 | rewards.coin    | num  | 硬币礼包 ID        | 合格后一般为 3，不合格为 0                                                                         |

 #### 旧API
+<details>
+<summary>查看旧 api：</summary>

 > http://api.bilibili.com/x/credit/jury/kpi （旧）

@ -222,11 +224,12 @@ curl -G 'http://api.bilibili.com/x/credit/jury/kpi' \
 }
 ```

+</details>
 </details>

 ## 检查申请风纪委员会资格

-> http://api.bilibili.com/x/credit/jury/requirement （旧版）
+> ~~http://api.bilibili.com/x/credit/jury/requirement~~ （旧版）

 > http://api.bilibili.com/x/credit/v2/jury/requirement （新版）

--- a/blackroom/jury/judgement_info.md
+++ b/blackroom/jury/judgement_info.md
@ -7,18 +7,272 @@

 ---

-投票类型码总览：

-| 代码 | 含义 |
-| - | ---- |
-| 0 | 未投票 |
-| 1 | 封禁 |
-| 2 | 否   |
-| 3 | 弃权 |
-| 4 | 删除 |
+<table>
+    <tr>
+        <th colspan="3">投票类型码总览</th>
+    </tr >
+    <tr>
+        <td>代码</td>
+        <td>含义</td>
+    </tr>
+    <tr>
+        <td >0</td>
+        <td>未投票</td>
+    </tr>
+    <tr>
+        <td >1</td>
+        <td>封禁</td>
+    </tr>
+    <tr>
+        <td>2</td>
+        <td>否</td>
+    </tr>
+    <tr>
+        <td>3</td>
+        <td>弃权</td>
+    </tr>
+    <tr>
+        <td>4</td>
+        <td>删除</td>
+    </tr>
+</table>
+
+
+<table>
+    <tr>
+        <th colspan="3">投票选项码总览</th>
+    </tr >
+    <tr>
+        <td >任务类型</td>
+        <td>代码</td>
+        <td>含义</td>
+    </tr>
+    <tr >
+        <td rowspan="4">单条评论（弹幕）</td>
+        <td >1</td>
+        <td>合适</td>
+    </tr>
+    <tr>
+        <td>2</td>
+        <td>一般</td>
+    </tr>
+    <tr>
+        <td>3</td>
+        <td>不合适</td>
+    </tr>
+    <tr>
+        <td>4</td>
+        <td>无法判断</td>
+    </tr>
+    <tr>
+        <td rowspan="4">评论（弹幕）氛围</td>
+        <td>11</td>
+        <td>好</td>
+    </tr>
+    <tr>
+        <td>12</td>
+        <td>一般</td>
+    </tr>
+    <tr>
+        <td>13</td>
+        <td>差</td>
+    </tr>
+    <tr>
+        <td>14</td>
+        <td>无法判断</td>
+    </tr>
+</table>
+
+

 ## 查询投票过的单个案件

+> https://api.bilibili.com/x/credit/v2/jury/case/info
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）或APP
+
+可查询任意案件，无论自己是否参与投票。
+
+**url参数：**
+
+| 参数名 | 类型 | 内容          | 必要性 | 备注           |
+| ------ | ------------ | ------ | ------------- | ------------- |
+| access_key | str | APP登录Token | APP方式必要 |  |
+| case_id | str | 案件id     |  必要  |                |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型   | 内容      | 备注         |
+| ------- | ------ | -------- | ------------ |
+| code    | num    | 返回值   | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
+| message | str    | 信息     | 默认为0      |
+| ttl     | num    | 1        |  |
+| data    | object | 数据本体   |             |
+
+`data` 对象：
+
+| 字段      | 类型   | 内容      | 备注         |
+| --------- | ------ | -------- | ------------ |
+| case_id | str  | 案件id |              |
+| case_type | num    | 任务类型 | 1：单条评论<br />2：评论氛围<br />3：单条弹幕<br />4：弹幕氛围 |
+| jury_state | num    | `1` | 改版后未见过其它值 |
+| participate | num | 是否投票 | 0：未投票<br />1：已投票 |
+| vote_items | object | 投票选项 | 见开头「投票选项码总览」 |
+| default_vote | num   | 默认投票选项 | `4`或`14`即`无法判断` |
+| status | num | 裁决状态（新版） | 0：进行中<br />1：已结束 |
+| origin_start | num | 案件关联视频，播放进度条起始坐标 | 单位：`秒` |
+| avid | num | 视频av号 |              |
+| cid | num    | 弹幕池id | 弹幕相关参见「[xml弹幕](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/danmaku/danmaku_xml.md)」 |
+| vote_cd | num | `-1` | 暂不明确 |
+| result | num  | 众议结论 | 见开头「投票选项码总览」 |
+| result_text | str | 众议结论文本 |  |
+| title | str | 视频标题 |              |
+| case_info | object | 案件信息 | 见「[附表1](#####附表1：`data` 对象下的`case_info`对象)」 |
+| my_point | object | 我的观点 | 见「[附表4](#####附表4：`data` 对象下的`my_point`对象)」 |
+| vote_info | object | 投票信息 | 见「[附表5](#####附表5：`data` 对象下的`vote_info`对象)」 |
+
+###### 附表1：`data` 对象下的`case_info`对象
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------------ | ------ | ------------ | ------------------------------------------------------------ |
+| comment      | object | 单条评论信息 | 仅当`case_type`为`1`有值。见「[附表2](#####附表2：评论信息)」 |
+| danmu_img    | str    | 弹幕截图     | 仅当`case_type`为`4`有值，截图URL                            |
+| comments     | object | 若干条评论   | 仅当`case_type`为`2`有值。见「[附表2](#####附表2：评论信息)」 |
+| single_danmu | str    | 单条弹幕信息 | 仅当`case_type`为`3`有值。见「[附表3](#####附表3：弹幕信息)」 |
+
+###### 附表2：评论信息
+
+| 字段  | 类型 | 内容 | 备注 |
+| ---- | ---- | ---- | ---- |
+| mid | num | 用户uid |      |
+| uname | str | 用户名 |      |
+| face | str | 用户头像 | 头像URL |
+| content | str | 评论内容 |      |
+| child_comments | object | 子评论（对该评论的回复） | 见「[附表2](#####附表2：评论信息)」，单条评论和子评论下无`child_comments`字段 |
+
+###### 附表3：弹幕信息
+
+| 字段     | 类型 | 内容     | 备注                                                         |
+| -------- | ---- | -------- | ------------------------------------------------------------ |
+| id_str   | str  | 弹幕dmid | 见「[xml弹幕](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/danmaku/danmaku_xml.md#%E5%B1%9E%E6%80%A7-p)」 |
+| content  | str  | 弹幕内容 |                                                              |
+| progress | num  |          | 尚不明确                                                     |
+
+###### 附表4：`data` 对象下的`my_point`对象
+
+记录了某个风纪委员的某个投票（观点）信息
+
+| 字段        | 类型 | 内容             | 备注                                                         |
+| ----------- | ---- | ---------------- | ------------------------------------------------------------ |
+| opid        | num  | 观点编号         | 每当某个一个风纪委员给某个仲裁案件发表观点，就+1             |
+| mid         | num  | 风纪委员用户ID   |                                                              |
+| uname       | str  | 风纪委员用户名   | 风纪委勾选匿名投票则显示“匿名用户”                           |
+| face        | str  | 头像URL          | 头像                                                         |
+| vote        | num  | 投票选项         | “合适题”分别为 `1` 或者 `2` 或者 `3` 或者 `4`，<br/>对应：“合适”、“一般”、“不合适”、“无法判断”<br/><br/>“氛围题”分别为 `11` 或者 `12` 或者 `13` 或者 `14`，<br/>对应：“好”、“一般”、“差”、“无法判断”<br/><br/>注释<br/>合适题：“单条弹幕（评论）是否合适？”<br/>氛围题：“弹幕（评论区）氛围如何” |
+| vote_text   |      | 内容为空         | *现在系统已不再展示其他风纪委所投的票*                       |
+| content     | str  | 观点内容         | 该风纪委员所发表的观点内容                                   |
+| anonymous   | num  | 0                | 尚不明确                                                     |
+| like        | num  | 被点赞数量       |                                                              |
+| hate        | num  | 被点踩数量       |                                                              |
+| like_status | num  | 点赞（踩）状态   | 本账号是否给该条评论点赞：<br/>0：没做操作；1：给评论点赞；2：给评论点踩 |
+| vote_time   | num  | 投票时间         | 时间戳，精确到秒                                             |
+| insiders    | num  | 是否观看此类视频 | 1：平时观看此类视频；0：平时不观看此类视频                   |
+
+###### 附表5：`data` 对象下的`vote_info`对象
+
+| 字段            | 类型  | 内容     | 备注                                         |
+| --------------- | ----- | -------- | -------------------------------------------- |
+| all_count       | num   | 总投票数 |                                              |
+| counts          | array | 观点分布 | 格式：`[合适, 一般, 不合适, 无法判断]`       |
+| insiders_counts | array | 行为分布 | 格式：`[平时会看此类视频, 平时不看此类视频]` |
+
+**示例：**
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "message": "0",
+    "ttl": 1,
+    "data": {
+        "case_id": "AC2SiaD8jlrL",
+        "case_type": 3,
+        "jury_state": 1,
+        "participate": 1,
+        "vote_items": [
+            {
+                "vote": 1,
+                "vote_text": "合适"
+            },
+            {
+                "vote": 2,
+                "vote_text": "一般"
+            },
+            {
+                "vote": 3,
+                "vote_text": "不合适"
+            },
+            {
+                "vote": 4,
+                "vote_text": "无法判断"
+            }
+        ],
+        "default_vote": 4,
+        "status": 1,
+        "origin_start": 0,
+        "avid": 727792866,
+        "cid": 756815216,
+        "vote_cd": -1,
+        "result": 3,
+        "result_text": "不合适",
+        "title": "“国家队”守门员和朋友打赌，谁能在湿滑的地面踢进足球就送美刀",
+        "case_info": {
+            "comment": null,
+            "danmu_img": "",
+            "comments": null,
+            "single_danmu": {
+                "id_str": "1086612690354524160",
+                "content": "这守门员干啥呢？给块骨头我家狗都比他防的好",
+                "progress": 27859
+            }
+        },
+        "my_point": {
+            "opid": 10001,
+            "mid": 10001,
+            "uname": "风纪委员用户名",
+            "face": "http://i0.hdslb.com/bfs/face/e48952d599dbf011c2235239fafa2bf0deccef5a.jpg",
+            "vote": 3,
+            "vote_text": "不合适",
+            "content": "",
+            "anonymous": 0,
+            "like": 0,
+            "hate": 0,
+            "like_status": 0,
+            "vote_time": 1663655000,
+            "insiders": 1
+        },
+        "vote_info": {
+            "all_count": 306,
+            "counts": [90, 33, 177, 6],
+            "insiders_counts": [245, 61]
+        }
+    }
+}
+```
+</details>
+
+#### 旧 api
+
+<details>
+<summary>查看旧 api：</summary>
+
 > http://api.bilibili.com/x/credit/jury/juryCase

 *请求方式：GET*
@ -43,7 +297,7 @@
 | code    | num    | 返回值   | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />25010：没有权限查看案件 |
 | message | str    | 信息     | 默认为0      |
 | ttl     | num    | 1        |  |
-| data    | obj | 数据本体   |             |
+| data    | object | 数据本体   |             |

 `data` 对象：

@ -135,10 +389,14 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
 }
 ```

+</details>
 </details>

 ## 查询案件众裁信息

+注：这是一个旧版的API，暂未找到对应的新版API。
+<details>
+<summary>展开：</summary>
 > http://api.bilibili.com/x/credit/jury/caseInfo

 *请求方式：GET*
@ -155,12 +413,12 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \

 根对象：

-| 字段    | 类型                          | 内容     | 备注                        |
-| ------- | ----------------------------- | -------- | --------------------------- |
-| code    | num                           | 返回值   | 0：成功<br />-400：请求错误 |
-| message | str                           | 信息     | 默认为0                     |
-| ttl     | num                           | 1        |                             |
-| data    | 有效时：obj<br />无效时：null | 数据本体 |                             |
+| 字段    | 类型                             | 内容     | 备注                        |
+| ------- | -------------------------------- | -------- | --------------------------- |
+| code    | num                              | 返回值   | 0：成功<br />-400：请求错误 |
+| message | str                              | 信息     | 默认为0                     |
+| ttl     | num                              | 1        |                             |
+| data    | 有效时：object<br />无效时：null | 数据本体 |                             |

 `data` 对象：

@ -236,11 +494,93 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
    }
 }
 ```
-
+</details>
 </details>

 ## 查询我的众裁记录

+> https://api.bilibili.com/x/credit/v2/jury/case/list
+
+*请求方式：GET*
+
+认证方式：Cookie
+
+**url参数：**
+
+| 参数名     | 类型 | 内容         | 必要性      | 备注                 |
+| ---------- | ---- | ------------ | ----------- | -------------------- |
+| pn         | num  | 页码         | 非必要      | 默认为1              |
+| ps         | num  | 每页显示数量 | 非必要      | 默认为30<br />最大30 |
+
+**Headers参数**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ---- | ------ | ---- |
+| cookie | str  |      | 必要   |      |
+
+**json回复：**
+
+根对象：
+
+| 字段       | 类型   | 内容         | 备注                                              |
+| ---------- | ------ | ------------ | ------------------------------------------------- |
+| code       | num    | 返回值       | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
+| message    | str    | 信息         | 默认为0                                           |
+| ttl        | num    | 1            |                                                   |
+| data       | object | 数据本体     |                                                   |
+| data.total | num    | 仲裁案例数   |                                                   |
+| data.list  | array  | 仲裁记录列表 |                                                   |
+
+`list`数组：
+
+| 项   | 类型   | 内容            | 备注         |
+| ---- | ------ | --------------- | ------------ |
+| 0    | object | 仲裁记录1       |              |
+| n    | object | 仲裁记录（n+1） | 按照时间顺序 |
+| ……   | object | ……              | ……           |
+
+`list`数组中的对象：
+
+| 字段      | 类型 | 内容         | 备注                                                         |
+| --------- | ---- | ------------ | ------------------------------------------------------------ |
+| case_id   | str  | 案件id       |                                                              |
+| case_type | num  | 案件类型     | 1：单条评论<br/>2：评论氛围<br/>3：单条弹幕<br/>4：弹幕氛围  |
+| status    | num  | 裁决状态     | 0：投票中<br />1：已结束                                     |
+| vote      | num  | 投票选项     | “单条评论（弹幕）”分别为 `1` 或者 `2` 或者 `3` 或者 `4`，<br/>对应：“合适”、“一般”、“不合适”、“无法判断”<br/><br/>“评论（弹幕）氛围”分别为 `11` 或者 `12` 或者 `13` 或者 `14`，<br/>对应：“好”、“一般”、“差”、“无法判断” |
+| vote_text | str  | 投票选项文本 | *参考上条*                                                   |
+| vote_time | num  | 投票时间     | 时间戳，精确到秒                                             |
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "message": "0",
+    "ttl": 1,
+    "data": {
+        "total": 5428,
+        "list": [
+            {
+                "case_id": "AC2sOiNenwj1",
+                "case_type": 4,
+                "status": 1,
+                "vote": 11,
+                "vote_text": "好",
+                "vote_time": 1662700609
+            }
+        ]
+    }
+}
+```
+
+</details>
+
+#### 旧 api
+
+<details>
+<summary>查看旧版API：</summary>
+
 > http://api.bilibili.com/x/credit/jury/caseList

 *请求方式：GET*
@ -268,11 +608,11 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \

 `data`数组：

-| 项   | 类型 | 内容            | 备注         |
-| ---- | ---- | --------------- | ------------ |
-| 0    | obj  | 仲裁记录1       |              |
-| n    | obj  | 仲裁记录（n+1） | 按照时间顺序 |
-| ……   | obj  | ……              | ……           |
+| 项   | 类型   | 内容            | 备注         |
+| ---- | ------ | --------------- | ------------ |
+| 0    | object | 仲裁记录1       |              |
+| n    | object | 仲裁记录（n+1） | 按照时间顺序 |
+| ……   | object | ……              | ……           |

 `data`数组中的对象：

@ -367,10 +707,116 @@ curl -G 'http://api.bilibili.com/x/credit/jury/caseList' \
 }
 ```

+</details>
 </details>

 ## 获取众议观点

+> https://api.bilibili.com/x/credit/v2/jury/case/opinion
+
+*请求方式：GET*
+
+认证方式：Cookie
+
+**标头参数（Headers）：**
+
+| 参数名 | 类型 | 内容   | 必要性 | 备注 |
+| ------ | ---- | ------ | ------ | ---- |
+| Cookie | str  | Cookie | 必要   |      |
+
+**URL参数（Query Params）：**
+
+| 参数名  | 类型 | 内容       | 备注                                        |
+| ------- | ---- | ---------- | ------------------------------------------- |
+| case_id | str  | 仲裁案件id | **必填**                                    |
+| pn      | num  |            | 显示第x页（default = 1）                    |
+| ps      | num  |            | 每页显示y条观点（Max = 20）（default = 10） |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型   | 内容     | 备注                                              |
+| ------- | ------ | -------- | ------------------------------------------------- |
+| code    | num    | 返回值   | 0：成功；<br>-400：`ps`参数大于可允许的最大值`20` |
+| message | str    | 信息     | 默认为0                                           |
+| ttl     | num    | 1        | 作用尚不明确                                      |
+| data    | object | 数据本体 |                                                   |
+
+`data`对象：
+
+| 字段  | 类型  | 内容                       | 备注 |
+| ----- | ----- | -------------------------- | ---- |
+| total | num   | 当前案件众议观点总数       |      |
+| list  | array | 无数据时是一个空数组：“[]” |      |
+
+`data.list`对象是一个数组，里面包含`ps`个object（参数`ps`见上文，object结构见「[附表4](#####附表4：`data` 对象下的`my_point`对象)」）
+
+**示例：**
+
+查看案件`AC1xx411c7ac`的众议观点，每页`2`项，查看第`1`页
+
+```shell
+curl -G 'https://api.bilibili.com/x/credit/v2/jury/case/opinion' \
+--data-urlencode 'case_id=AC1xx411c7ac' \
+--data-urlencode 'pn=1' \
+--data-urlencode 'ps=2' \
+--header 'cookie: xxxx'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "message": "0",
+    "ttl": 1,
+    "data": {
+        "total": 48,
+        "list": [
+            {
+                "opid": 46087379,
+                "mid": 22006415,
+                "uname": "匿名用户",
+                "face": "http://i0.hdslb.com/bfs/face/e48952d599dbf011c2235239fafa2bf0deccef5a.jpg",
+                "vote": 11,
+                "vote_text": "",
+                "content": "正常评论",
+                "anonymous": 1,
+                "like": 0,
+                "hate": 0,
+                "like_status": 0,
+                "vote_time": 1661430391,
+                "insiders": 1
+            },
+            {
+                "opid": 46087280,
+                "mid": 19243907,
+                "uname": "匿名用户",
+                "face": "http://i0.hdslb.com/bfs/face/e85d7ab3425d3dd0f0796bd7f945b47ac27ca82a.jpg",
+                "vote": 11,
+                "vote_text": "",
+                "content": "并未发现明显问题。",
+                "anonymous": 1,
+                "like": 0,
+                "hate": 0,
+                "like_status": 0,
+                "vote_time": 1661430337,
+                "insiders": 0
+            }
+        ]
+    }
+}
+```
+
+</details>
+
+#### 旧 api
+
+<details>
+<summary>查看旧版API：</summary>
+
 > http://api.bilibili.com/x/credit/jury/case/opinion

 *请求方式：GET*
@ -392,7 +838,7 @@ curl -G 'http://api.bilibili.com/x/credit/jury/caseList' \
 | code    | num    | 返回值   | 0：成功<br />-400：请求错误 |
 | message | str    | 信息     | 默认为0      |
 | ttl     | num    | 1        |  |
-| data    | obj | 数据本体   |             |
+| data    | object | 数据本体   |             |

 `data` 对象：

@ -403,11 +849,11 @@ curl -G 'http://api.bilibili.com/x/credit/jury/caseList' \

 `data` 中的`opinion` 数组：

-| 项   | 类型 | 内容        | 备注         |
-| ---- | ---- | ----------- | ------------ |
-| 0    | obj  | 观点1       |              |
-| n    | obj  | 观点（n+1） | 按照时间顺序 |
-| ……   | obj  | ……          | ……           |
+| 项   | 类型   | 内容        | 备注         |
+| ---- | ------ | ----------- | ------------ |
+| 0    | object | 观点1       |              |
+| n    | object | 观点（n+1） | 按照时间顺序 |
+| ……   | object | ……          | ……           |

 `opinion` 数组中的对象：

@ -548,4 +994,5 @@ curl -G 'http://api.bilibili.com/x/credit/jury/case/opinion' \
 }
 ```

-</details>
+</details>
+</details>