github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2025-01-17 07:10:09 +08:00
Code Issues Packages Projects Releases Wiki Activity
17eee20dce
bilibili-API-collect/bangumi/info.md

423 lines
18 KiB
Markdown
Raw Normal View History

修改剧集基本信息
2020-10-23 20:12:15 +08:00
# 剧集基本信息
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
- [剧集基本信息（mdid方式）](#剧集基本信息（mdid方式）)
- [获取剧集明细（web端）（ssid/epid方式）](#获取剧集明细（web端）（ssid/epid方式）)
所有文档添加索引目录
2020-11-20 20:13:12 +08:00
---
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
## 剧集基本信息（mdid方式）
修改剧集基本信息
2020-10-23 20:12:15 +08:00
> http://api.bilibili.com/pgc/review/user
*请求方式：GET*
鉴权方式：Cookie（SESSDATA）或APP
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | -------- | ------ | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| media_id | str | 剧集mdid | 必要 | |
修改剧集基本信息
2020-10-23 20:12:15 +08:00
**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 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| media_id | num | 剧集mdid | |
修改剧集基本信息
2020-10-23 20:12:15 +08:00
| new_ep | obj | 最新一话信息 | |
| rating | obj | 评分信息 | |
添加：剧集时间轴，修改：统一int至num (#374) * Create timeline.md * Upd 05.18 2 I. finish writing documents II. refactor 'int' to 'num' in all documents * Upd 05.18 3 I. delete writing reference II. add demo * Upd 05.18 Fix 1 Adding change to README
2022-05-26 11:38:35 +08:00
| season_id | num | 剧集ssid | |
修改剧集基本信息
2020-10-23 20:12:15 +08:00
| 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`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------- | -------------------------- |
添加：剧集时间轴，修改：统一int至num (#374) * Create timeline.md * Upd 05.18 2 I. finish writing documents II. refactor 'int' to 'num' in all documents * Upd 05.18 3 I. delete writing reference II. add demo * Upd 05.18 Fix 1 Adding change to README
2022-05-26 11:38:35 +08:00
| id | num | 最新一话的epid | |
修改剧集基本信息
2020-10-23 20:12:15 +08:00
| 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>
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
## 获取剧集明细（web端）（ssid/epid方式）
优化文档格式
2020-07-14 18:44:44 +08:00
> http://api.bilibili.com/pgc/view/web/season
*请求方式：GET*
修改剧集基本信息
2020-10-23 20:12:15 +08:00
**url参数：**
优化文档格式
2020-07-14 18:44:44 +08:00
修改剧集基本信息
2020-10-23 20:12:15 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------- | ------------ | ------------------------ |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| season_id | num | 番剧ssid | 必要（可选） | season_id与ep_id任选其一 |
| ep_id | num | 剧集epid | 必要（可选） | season_id与ep_id任选其一 |
优化文档格式
2020-07-14 18:44:44 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------- |
| code | num | 返回值 | 0：成功<br />-404：错误 |
| message | str | 错误信息 | 默认为success |
| ttl | num | 1 | 作用尚不明确 |
| result | obj | 信息本体 | |
`result`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------ | -------------------------- | ------------------------------------------ |
| activity | obj | 参与的活动 | |
| alias | str | 空 | 作用尚不明确 |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| bkg_cover | str | 网页背景图片url | 无则为空 |
| cover | str | 剧集封面图片url | |
| episodes | array | 正片剧集列表 | |
优化文档格式
2020-07-14 18:44:44 +08:00
| evaluate | str | 简介 | |
| jp_title | str | 空 | 作用尚不明确 |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| link | str | 简介页面url | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| media_id | num | 剧集mdid | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| mode | num | 2 | 作用尚不明确 |
优化文档格式
2020-07-14 18:44:44 +08:00
| new_ep | obj | 更新信息 | |
| payment | obj | 会员&付费信息 | 若无相关内容则无此项 |
| positive | obj | | |
| publish | obj | 发布信息 | |
| rating | obj | 评分信息 | 若无相关内容则无此项 |
| record | str | 备案号 | 无则为空 |
| rights | obj | 属性标志信息 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| season_id | num | 番剧ssid | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| season_title | str | 剧集标题 | |
Fix typo (#227)
2021-08-24 23:43:58 +08:00
| seasons | array | 同系列所有季信息 | |
优化文档格式
2020-07-14 18:44:44 +08:00
| section | array | 花絮、PV、番外等非正片内容 | 若无相关内容则无此项 |
| series | obj | 系列信息 | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| share_copy | str | 《{标题}》+{备注} | |
| share_sub_title | str | 备注 | |
优化文档格式
2020-07-14 18:44:44 +08:00
| share_url | str | 番剧播放页面url | |
| show | obj | 网页全屏标志 | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| square_cover | str | 方形封面图片url | |
优化文档格式
2020-07-14 18:44:44 +08:00
| stat | obj | 状态数 | |
| status | num | | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| subtitle | str | 剧集副标题 | |
| title | str | 剧集标题 | |
| total | num | 总计正片集数 | 未完结：大多为-1<br />已完结：正整数 |
| type | num | 剧集类型 | 1：番剧<br />2：电影<br />3：纪录片<br />4：国创<br />5：电视剧<br />7：综艺 |
优化文档格式
2020-07-14 18:44:44 +08:00
| up_info | obj | UP主信息 | 若无相关内容则无此项 |
`result`中的`activity`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------- | ------------ |
| head_bg_url | str | 空 | 作用尚不明确 |
| id | num | 活动id | |
| title | str | 活动标题 | |
`result`中的`episodes`数组：
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ------------ |
| 0 | obj | 正片第1集 | |
| n | obj | 正片第（n+1）集 | 按照顺序排列 |
| …… | obj | | |
`episodes`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | --------------------------------- | -------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| aid | num | 单集稿件avid | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| badge | str | 标签文字 | 例如`会员`、`限免`等 |
| badge_info | obj | | |
| badge_type | num | | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| bvid | str | 单集稿件bvid | |
| cid | num | 视频cid | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| cover | str | 单集封面url | |
| dimension | obj | 分辨率信息 | |
| from | str | | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| id | num | 单集epid | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| link | str | 单集网页url | |
| long_title | str | 单集完整标题 | |
| pub_time | num | 发布时间 | 时间戳 |
| pv | num | 0 | 作用尚不明确 |
| release_date | str | 空 | 作用尚不明确 |
| rights | obj | | |
| share_copy | str | 《{标题}》+第n话+｛单集完整标题｝ | |
| share_url | str | 单集网页url | |
| short_link | str | 单集网页url短链接 | |
| status | num | | |
| subtitle | str | 单集副标题 | 观看次数文字 |
| title | str | 单集标题 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| vid | str | 单集vid | vupload_+{cid} |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
`result`中的`new_ep`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | ---------------- |
| desc | str | 更新备注 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| id | num | 最新一话epid | |
优化文档格式
2020-07-14 18:44:44 +08:00
| is_new | num | 是否最新发布 | 0：否<br />1：是 |
| title | str | 最新一话标题 | |
`result`中的`payment`对象：
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | ---- | ---- |
| discount | num | | |
| pay_type | obj | | |
| price | str | | |
| promotion | str | | |
| tip | str | | |
| vip_discount | num | | |
| vip_first_promotion | str | | |
| vip_promotion | str | | |
优化文档格式
2020-07-14 18:44:44 +08:00
`result`中的`positive`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ---- | ---- |
| id | num | | |
| title | str | | |
`result`中的`publish`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ---------------- | ------------------------ |
| is_finish | num | 完结状态 | 0：未完结<br />1：已完结 |
| is_started | num | 是否发布 | 0：未发布<br />1：已发布 |
| pub_time | str | 发布时间 | YYYY-MM-DDD hh:mm:ss |
| pub_time_show | str | 发布时间文字介绍 | |
| unknow_pub_date | num | 0 | 作用尚不明确 |
| weekday | num | 0 | 作用尚不明确 |
`result`中的`rating`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------ | ---- |
| count | num | 总计评分人数 | |
| score | num | 评分 | |
`result`中的`rights`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | -------- | ------------------------------- |
| allow_bp | num | | |
| allow_bp_rank | num | | |
| allow_download | num | | |
| allow_review | num | | |
| area_limit | num | | |
| ban_area_show | num | | |
| can_watch | num | | |
| copyright | str | 版权标志 | bilibili：授权<br />dujia：独家 |
| forbid_pre | num | | |
| is_cover_show | num | | |
| is_preview | num | | |
| only_vip_download | num | | |
| resource | str | | |
| watch_platform | num | | |
`result`中的`seasons`数组：
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | ------------ |
| 0 | obj | 同系列剧集1 | |
| n | obj | 同系列剧集（n+1） | 按照顺序排列 |
| …… | obj | | |
`seasons`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---- | ---- |
| badge | str | | |
| badge_info | obj | | |
| badge_type | num | | |
| cover | str | | |
| media_id | str | | |
| new_ep | num | | |
| season_id | obj | | |
| season_title | num | | |
| season_type | str | | |
| stat | obj | | |
优化文档格式
2020-07-14 18:44:44 +08:00
`result`中的`section`数组：
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | ------------ |
| 0 | obj | 其他内容块1 | |
| n | obj | 其他内容块（n+1） | 按照顺序排列 |
| …… | obj | | |
`section`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ---- |
| episode_id | num | 0 | |
| episodes | array | 板块内容 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| id | num | 板块id？ | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| title | str | 板块标题 | |
| type | num | ？ | |
优化文档格式
2020-07-14 18:44:44 +08:00
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
`result`中的`series`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------ | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| series_id | num | 系列id | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| series_title | str | 系列名 | |
优化文档格式
2020-07-14 18:44:44 +08:00
`result`中的`show`对象：
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------- | -------------------- |
| wide_screen | num | 是否全屏 | 0：正常<br />1：全屏 |
优化文档格式
2020-07-14 18:44:44 +08:00
`result`中的`stat`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ------ | ---- |
| coins | num | 投币数 | |
| danmakus | num | 弹幕数 | |
| favorites | num | 收藏数 | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| likes | num | 点赞数 | |
优化文档格式
2020-07-14 18:44:44 +08:00
| reply | num | 评论数 | |
| share | num | 分享数 | |
| views | num | 播放数 | |
`result`中的`up_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ----------- | ---- |
| avatar | str | 头像图片url | |
| follower | num | 粉丝数 | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| is_follow | num | 0 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | UP主mid | |
优化文档格式
2020-07-14 18:44:44 +08:00
| pendant | obj | | |
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
2020-10-11 15:41:50 +08:00
| theme_type | num | 0 | |
| uname | str | UP主昵称 | |
优化文档格式
2020-07-14 18:44:44 +08:00
| verify_type | num | | |
| vip_status | num | | |
为番剧info添加了一个api
2020-10-11 19:53:22 +08:00
| vip_type | num | | |
Fix typo (#227)
2021-08-24 23:43:58 +08:00
##
Reference in New Issue Copy Permalink