Skip to content

Commit

Permalink
添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”
Browse files Browse the repository at this point in the history
  • Loading branch information
@SocialSisterYi
SocialSisterYi committed Oct 11, 2020
1 parent a15ce71 commit ab04d51
Show file tree
Hide file tree
Showing 29 changed files with 621 additions and 274 deletions.
1 change: 1 addition & 0 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http`
- [API认证与鉴权（APP与Cookie方式）](other/API_auth.md)×
- [公共错误码](other/errcode.md)√
- [图片格式化](other/picture.md)√
- [bvID说明](other/bvID.md)√
- [登录](login)
- [登录操作（人机认证）](login/login_action)√
+ [短信登录](login/login_action/SMS.md)√
Expand Down
4 changes: 2 additions & 2 deletions audio/info.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,8 @@
| duration | num | 歌曲时间长度 | 单位为秒 |
| passtime | num | 歌曲发布时间 | 时间戳 |
| curtime | num | 当前请求时间 | 时间戳 |
| aid | num | 关联视频avID | 无为0 |
| bvid | str | 关联视频bvID | 无为空 |
| aid | num | 关联稿件avID | 无为0 |
| bvid | str | 关联稿件bvID | 无为空 |
| cid | num | 关联视频CID | 无为0 |
| msid | num | 0 | **作用尚不明确** |
| attr | num | 0 | **作用尚不明确** |
Expand Down
148 changes: 126 additions & 22 deletions bangumi/info.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -28,14 +28,14 @@
| --------------- | ------ | -------------------------- | ------------------------------------------ |
| activity | obj | 参与的活动 | |
| alias | str | 空 | 作用尚不明确 |
| bkg_cover | str | 背景图片url | 无则为空 |
| cover | str | 封面图片url | |
| episodes | array | 剧集列表 | |
| bkg_cover | str | 网页背景图片url | 无则为空 |
| cover | str | 剧集封面图片url | |
| episodes | array | 正片剧集列表 | |
| evaluate | str | 简介 | |
| jp_title | str | 空 | 作用尚不明确 |
| link | str | 简介网址url | |
| media_id | num | 番剧mdID | |
| mode | num | | |
| link | str | 简介页面url | |
| media_id | num | 剧集mdID | |
| mode | num | 2 | 作用尚不明确 |
| new_ep | obj | 更新信息 | |
| payment | obj | 会员&付费信息 | 若无相关内容则无此项 |
| positive | obj | | |
Expand All @@ -44,21 +44,21 @@
| record | str | 备案号 | 无则为空 |
| rights | obj | 属性标志信息 | |
| season_id | num | 番剧ssID | |
| season_title | str | 标题 | |
| seasons | array | 同系列其他季 | 无则为空 |
| season_title | str | 剧集标题 | |
| seasons | array | 同系列所以季信息 | |
| section | array | 花絮、PV、番外等非正片内容 | 若无相关内容则无此项 |
| series | obj | 系列信息 | |
| share_copy | str | 《标题》+签名 | |
| share_sub_title | str | 签名 | 无则为空 |
| share_copy | str | 《{标题}》+{备注} | |
| share_sub_title | str | 备注 | |
| share_url | str | 番剧播放页面url | |
| show | obj | 网页全屏标志 | |
| square_cover | str | 方形封面图片url | 若无相关内容则无此项 |
| square_cover | str | 方形封面图片url | |
| stat | obj | 状态数 | |
| status | num | | |
| subtitle | str | 观看次数文字介绍 | |
| title | str | 标题 | |
| total | num | 总计集数 | 未完结：大多为-1<br />已完结：大多为正整数 |
| type | num | | |
| subtitle | str | 剧集副标题 | |
| title | str | 剧集标题 | |
| total | num | 总计正片集数 | 未完结：大多为-1<br />已完结：正整数 |
| type | num | 剧集类型 | 1：番剧<br />2：电影<br />3：纪录片<br />4：国创<br />5：电视剧<br />7：综艺 |
| up_info | obj | UP主信息 | 若无相关内容则无此项 |

`result`中的`activity`对象：
Expand All @@ -71,6 +71,44 @@

`result`中的`episodes`数组：

| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ------------ |
| 0 | obj | 正片第1集 | |
| n | obj | 正片第（n+1）集 | 按照顺序排列 |
| …… | obj | | |

`episodes`数组中的对象：

| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | --------------------------------- | -------------------- |
| aid | num | 单集稿件avID | |
| badge | str | 标签文字 | 例如`会员`、`限免`等 |
| badge_info | obj | | |
| badge_type | num | | |
| bvid | str | 单集稿件bvID | |
| cid | num | 视频CID | |
| cover | str | 单集封面url | |
| dimension | obj | 分辨率信息 | |
| from | str | | |
| id | num | 单集epID | |
| 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 | 单集标题 | |
| vid | str | 单集vID | vupload_+{CID} |







`result`中的`new_ep`对象：
Expand All @@ -84,6 +122,17 @@

`result`中的`payment`对象：

| 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | ---- | ---- |
| discount | num | | |
| pay_type | obj | | |
| price | str | | |
| promotion | str | | |
| tip | str | | |
| vip_discount | num | | |
| vip_first_promotion | str | | |
| vip_promotion | str | | |



`result`中的`positive`对象：
Expand Down Expand Up @@ -132,21 +181,75 @@

`result`中的`seasons`数组：

| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | ------------ |
| 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 | | |









`result`中的`section`数组：

| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | ------------ |
| 0 | obj | 其他内容块1 | |
| n | obj | 其他内容块（n+1） | 按照顺序排列 |
| …… | obj | | |

`section`数组中的对象：

| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ---- |
| episode_id | num | 0 | |
| episodes | array | 板块内容 | |
| id | num | 板块ID？ | |
| title | str | 板块标题 | |
| type | num | ？ | |




`result`中的`series`对象：







`result`中的`series`对象：

| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------ | ---- |
| series_id | num | 系列ID | |
| series_title | str | 系列名 | |

`result`中的`show`对象：

| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------ | -------------------- |
| wide_screen | num | 投币数 | 0：正常<br />1：全屏 |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------- | -------------------- |
| wide_screen | num | 是否全屏 | 0：正常<br />1：全屏 |

`result`中的`stat`对象：

Expand All @@ -155,6 +258,7 @@
| coins | num | 投币数 | |
| danmakus | num | 弹幕数 | |
| favorites | num | 收藏数 | |
| likes | num | 点赞数 | |
| reply | num | 评论数 | |
| share | num | 分享数 | |
| views | num | 播放数 | |
Expand All @@ -165,11 +269,11 @@
| ----------- | ---- | ----------- | ---- |
| avatar | str | 头像图片url | |
| follower | num | 粉丝数 | |
| is_follow | num | | |
| is_follow | num | 0 | |
| mid | num | UP主UID | |
| pendant | obj | | |
| theme_type | num | | |
| uname | str | | |
| theme_type | num | 0 | |
| uname | str | UP主昵称 | |
| verify_type | num | | |
| vip_status | num | | |
| vip_type | num | | |
4 changes: 2 additions & 2 deletions broadcast/video_room.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

| 字段 | 类型 | 内容 | 备注 |
| -------- | ------ | -------- | ------------------------------ |
| room_id | str | 目标视频 | `video://{视频avID}/{视频CID}` |
| room_id | str | 目标视频 | `video://{稿件avID}/{视频CID}` |
| platform | str | 平台标识 | 默认为`web` |
| accepts | array | 操作标识 | |

Expand Down Expand Up @@ -97,7 +97,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------ | ------------------------------ |
| online | num | 实时观看人数 | |
| room_id | str | 目标视频 | `video://{视频avID}/{视频CID}` |
| room_id | str | 目标视频 | `video://{稿件avID}/{视频CID}` |

**示例：**

Expand Down
4 changes: 2 additions & 2 deletions cheese/info.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,7 @@

| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------------------------------------------ |
| aid | num | 课程分集avID | **与普通视频avID部分不互通** |
| aid | num | 课程分集avID | **与普通稿件avID部分不互通** |
| cid | num | 课程分集CID | **与普通视频CID部分不互通** |
| duration | num | 课程分集时间长度 | 单位为秒 |
| from | str | pugv | |
Expand Down Expand Up @@ -506,7 +506,7 @@ curl -G 'http://api.bilibili.com/pugv/view/web/season'\

| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------------------------------------------ |
| aid | num | 课程分集avID | **与普通视频avID部分不互通** |
| aid | num | 课程分集avID | **与普通稿件avID部分不互通** |
| cid | num | 课程分集CID | **与普通视频CID部分不互通** |
| duration | num | 课程分集时间长度 | 单位为秒 |
| from | str | pugv | |
Expand Down
2 changes: 1 addition & 1 deletion comment/readme.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@

| 代码 | 评论区类型 | oid的意义 |
| ---- | ----------------------- | ---------- |
| 1 | 视频稿件 | 视频avID |
| 1 | 视频稿件 | 稿件avID |
| 2 | 话题 | 话题ID |
| 4 | 活动 | 活动ID |
| 5 | 小视频 | 小视频ID |
Expand Down
6 changes: 3 additions & 3 deletions danmaku/action.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,8 @@
| type | num | 弹幕类选择 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | |
| msg | str | 弹幕内容 | 必要 | 长度小于100字符 |
| bvid | str | 视频bvID | 必要（可选） | avID与bvID任选一个 |
| aid | num | 视频avID | 必要（可选） | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 |
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
| color | num | 弹幕颜色设置 | 非必要 | 十进制RGB888值<br />默认为16777215（#FFFFFF）白色 |
| fontsize | num | 弹幕字号设置 | 非必要 | 默认为25<br />极小：12<br />超小：16<br />小：18<br />标准：25<br />大：36<br />超大：45<br />极大：64 |
Expand Down Expand Up @@ -111,7 +111,7 @@ curl 'http://api.bilibili.com/x/v2/dm/post'\
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 互动弹幕类型 | 必要 | 1：UP主头像弹幕<br />2：关联视频弹幕<br />5：视频内嵌引导关注按钮 |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
| cid | num | 视频CID | 必要 | |
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
| plat | num | 平台标识 | 必要 | 1：web端<br />2：安卓端<br />8：视频管理页面 |
Expand Down
Loading

0 comments on commit ab04d51

Please sign in to comment.