From 9dc6ad4dc1697fde023149a5df0ae8e481f68dab Mon Sep 17 00:00:00 2001 From: little_fish12345 <18819303050@163.com> Date: Sun, 11 Oct 2020 19:53:22 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E4=B8=BA=E7=95=AA=E5=89=A7info=E6=B7=BB?= =?UTF-8?q?=E5=8A=A0=E4=BA=86=E4=B8=80=E4=B8=AAapi?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- bangumi/info.md | 71 ++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 70 insertions(+), 1 deletion(-) diff --git a/bangumi/info.md b/bangumi/info.md index b984fdd..4bcbbff 100644 --- a/bangumi/info.md +++ b/bangumi/info.md @@ -276,4 +276,73 @@ | uname | str | UP主昵称 | | | verify_type | num | | | | vip_status | num | | | -| vip_type | num | | | \ No newline at end of file +| vip_type | num | | | + +> http://api.bilibili.com/pgc/review/user + +*请求方式：GET* + +**参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| --------- | ---- | -------- | ------ | ---- | +| media_id | url | 番剧mID | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------------------- | +| code | num | 返回值 | 0：成功
-404：错误 | +| message | str | 错误信息 | 默认为success | +| result | obj | 信息本体 | | + +`result`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | -------- | ---- | +| media | obj | 番剧信息 | | + +`result`中的`media`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ------ | ---------- | ------------------------- | +| areas | array | 地区 | | +| cover | url | 封面 | | +| media_id | int | 番剧mID | | +| new_ep | obj | 最新一话 | | +| rating | obj | 评分 | | +| season_id | int | 番剧ssID | | +| share_url | url | 分享链接 | | +| title | str | 标题 | | +| type_name | str | "番剧" | 还有其他什么用这个api吗？ | + +`media`中的`areas`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | ---------------------- | +| 0 | obj | 地区信息 | | +| …… | obj | | 暂时没有看到有第二项的 | + +`areas`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | ------------ | +| id | int | 2 | 作用暂不明确 | +| name | str | 番剧地区 | | + +`media`中的`new_ep`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | -------------------------- | ---------------------- | +| id | int | 最新一话的epID | | +| index | str | 这一话是第几话 | | +| index_show | str | 该怎么显示最新一话的字符串 | e.g. "第1话"、"全12话" | + +`media`中的`rating`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ----- | -------- | ---- | +| count | int | 评分总数 | | +| score | float | 评分 | | \ No newline at end of file From f44fd54317e252a92e3065a8d306761f75dcbf68 Mon Sep 17 00:00:00 2001 From: SocialSisterYi <45892418+SocialSisterYi@users.noreply.github.com> Date: Fri, 23 Oct 2020 20:12:15 +0800 Subject: [PATCH 2/2] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E5=89=A7=E9=9B=86?= =?UTF-8?q?=E5=9F=BA=E6=9C=AC=E4=BF=A1=E6=81=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- bangumi/info.md | 217 +++++++++++++++++++++++++++++++----------------- 1 file changed, 143 insertions(+), 74 deletions(-) diff --git a/bangumi/info.md b/bangumi/info.md index 4bcbbff..05ec62c 100644 --- a/bangumi/info.md +++ b/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：成功
-400：请求错误
-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：中国大陆
2：日本
3：美国
4：英国
6：中国香港
8：韩国
9：法国
10：泰国
13：西班牙
15：德国
35：意大利
39：新西兰
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' +``` + +
+查看响应示例： + +```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 + } + } +} +``` + +
+ +## 获取剧集明细（web端）（ssID/epID方式） > http://api.bilibili.com/pgc/view/web/season *请求方式：GET* -**参数：** +**url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| --------- | ---- | -------- | ------ | ------------------------ | -| season_id | url | 番剧ssID | 非必要 | season_id与ep_id任选其一 | -| ep_id | url | 剧集epID | 非必要 | season_id与ep_id任选其一 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| --------- | ---- | -------- | ------------ | ------------------------ | +| season_id | num | 番剧ssID | 必要（可选） | season_id与ep_id任选其一 | +| ep_id | num | 剧集epID | 必要（可选） | season_id与ep_id任选其一 | **json回复：** @@ -278,71 +414,4 @@ | vip_status | num | | | | vip_type | num | | | -> http://api.bilibili.com/pgc/review/user - -*请求方式：GET* - -**参数：** - -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| --------- | ---- | -------- | ------ | ---- | -| media_id | url | 番剧mID | 必要 | | - -**json回复：** - -根对象： - -| 字段 | 类型 | 内容 | 备注 | -| ------- | ---- | -------- | ----------------------- | -| code | num | 返回值 | 0：成功
-404：错误 | -| message | str | 错误信息 | 默认为success | -| result | obj | 信息本体 | | - -`result`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ----- | ---- | -------- | ---- | -| media | obj | 番剧信息 | | - -`result`中的`media`对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------- | ------ | ---------- | ------------------------- | -| areas | array | 地区 | | -| cover | url | 封面 | | -| media_id | int | 番剧mID | | -| new_ep | obj | 最新一话 | | -| rating | obj | 评分 | | -| season_id | int | 番剧ssID | | -| share_url | url | 分享链接 | | -| title | str | 标题 | | -| type_name | str | "番剧" | 还有其他什么用这个api吗？ | - -`media`中的`areas`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | -------- | ---------------------- | -| 0 | obj | 地区信息 | | -| …… | obj | | 暂时没有看到有第二项的 | - -`areas`数组中的对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | -------- | ------------ | -| id | int | 2 | 作用暂不明确 | -| name | str | 番剧地区 | | - -`media`中的`new_ep`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ---- | -------------------------- | ---------------------- | -| id | int | 最新一话的epID | | -| index | str | 这一话是第几话 | | -| index_show | str | 该怎么显示最新一话的字符串 | e.g. "第1话"、"全12话" | - -`media`中的`rating`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ----- | ----- | -------- | ---- | -| count | int | 评分总数 | | -| score | float | 评分 | | \ No newline at end of file +## \ No newline at end of file