Merge branch 'pr/76'

bangumi/info.md

@@ -1,15 +1,151 @@
-# 番剧基本信息
+# 剧集基本信息
+
+## 剧集基本信息（mdID方式）
+
+
+> http://api.bilibili.com/pgc/review/user
+
+*请求方式：GET*
+
+鉴权方式：Cookie（SESSDATA）或APP
+
+**url参数：**
+
+| 参数名   | 类型 | 内容     | 必要性 | 备注 |
+| -------- | ---- | -------- | ------ | ---- |
+| media_id | str  | 剧集mdID | 必要   |      |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容     | 备注                                        |
+| ------- | ---- | -------- | ------------------------------------------- |
+| code    | num  | 返回值   | 0：成功<br />-400：请求错误<br />-404：错误 |
+| message | str  | 错误信息 | 默认为success                               |
+| result  | obj  | 信息本体 |                                             |
+
+`result`对象：
+
+| 字段   | 类型 | 内容         | 备注             |
+| ------ | ---- | ------------ | ---------------- |
+| media  | obj  | 剧集信息     |                  |
+| review | obj  | 用户操作信息 | 仅登录时存在此项 |
+
+`result`中的`media`对象：
+
+| 字段      | 类型  | 内容           | 备注                       |
+| --------- | ----- | -------------- | -------------------------- |
+| areas     | array | 地区           |                            |
+| cover     | str   | 封面图片url    |                            |
+| media_id  | num   | 剧集mdID       |                            |
+| new_ep    | obj   | 最新一话信息   |                            |
+| rating    | obj   | 评分信息       |                            |
+| season_id | int   | 剧集ssID       |                            |
+| share_url | url   | 剧集详情页连接 |                            |
+| title     | str   | 标题           |                            |
+| type_name | str   | 剧集类型       | `番剧`、`国创`、`电影`等等 |
+
+`media`中的`areas`数组：
+
+| 项   | 类型 | 内容            | 备注 |
+| ---- | ---- | --------------- | ---- |
+| 0    | obj  | 地区信息1       |      |
+| n    | obj  | 地区信息（n+1） |      |
+| ……   | obj  | ……              |      |
+
+`areas`数组中的对象：
+
+| 字段 | 类型 | 内容         | 备注                                                         |
+| ---- | ---- | ------------ | ------------------------------------------------------------ |
+| id   | num  | 所属地区编号 | 1：中国大陆<br />2：日本<br />3：美国<br />4：英国<br />6：中国香港<br />8：韩国<br />9：法国<br />10：泰国<br />13：西班牙<br />15：德国<br />35：意大利<br />39：新西兰<br />43：澳大利亚 |
+| name | str  | 所属地区名称 |                                                              |
+
+`media`中的`new_ep`对象：
+
+| 字段       | 类型 | 内容             | 备注                       |
+| ---------- | ---- | ---------------- | -------------------------- |
+| id         | int  | 最新一话的epID   |                            |
+| index      | str  | 最新一话名称     |                            |
+| index_show | str  | 最新一话显示名称 | eg. `第1话`、`更新至第4话` |
+
+`media`中的`rating`对象：
+
+| 字段  | 类型 | 内容         | 备注 |
+| ----- | ---- | ------------ | ---- |
+| count | num  | 总计评分人数 |      |
+| score | num  | 评分         |      |
+
+`result`中的`review`对象：
+
+| 字段    | 类型 | 内容 | 备注         |
+| ------- | ---- | ---- | ------------ |
+| is_coin | num  | 0    | 作用尚不明确 |
+| is_open | num  | 1    | 作用尚不明确 |
+
+**示例：**
+
+查询剧集`md28220978`的基本信息
+
+```shell
+curl -G 'http://api.bilibili.com/pgc/review/user' \
+--data-urlencode 'media_id=28220978' \
+-b 'SESSDATA=xxx'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+    "code": 0,
+    "message": "success",
+    "result": {
+        "media": {
+            "areas": [
+                {
+                    "id": 2,
+                    "name": "日本"
+                }
+            ],
+            "cover": "http://i0.hdslb.com/bfs/bangumi/8aa0bfce050c72c6626b63d3093a88527c251026.jpg",
+            "media_id": 28220978,
+            "new_ep": {
+                "id": 21278,
+                "index": "14",
+                "index_show": "全14话"
+            },
+            "rating": {
+                "count": 53376,
+                "score": 9.9
+            },
+            "season_id": 1172,
+            "share_url": "https://www.bilibili.com/bangumi/media/md28220978",
+            "title": "轻音少女 第一季",
+            "type_name": "番剧"
+        },
+        "review": {
+            "is_coin": 0,
+            "is_open": 1
+        }
+    }
+}
+```
+
+</details>
+
+## 获取剧集明细（web端）（ssID/epID方式）
 
 > http://api.bilibili.com/pgc/view/web/season
 
 *请求方式：GET*
 
-**参数：**
+**url参数：**
 
-| 参数名    | 类型 | 内容     | 必要性 | 备注                     |
+| 参数名    | 类型 | 内容     | 必要性       | 备注                     |
-| --------- | ---- | -------- | ------ | ------------------------ |
+| --------- | ---- | -------- | ------------ | ------------------------ |
-| season_id | url  | 番剧ssID | 非必要 | season_id与ep_id任选其一 |
+| season_id | num  | 番剧ssID | 必要（可选） | season_id与ep_id任选其一 |
-| ep_id     | url  | 剧集epID | 非必要 | season_id与ep_id任选其一 |
+| ep_id     | num  | 剧集epID | 必要（可选） | season_id与ep_id任选其一 |
 
 **json回复：**
 
@@ -276,4 +412,6 @@
 | uname       | str  | UP主昵称    |      |
 | verify_type | num  |             |      |
 | vip_status  | num  |             |      |
-| vip_type    | num  |             |      |
+| vip_type    | num  |             |      |
+
+##