添加【bvID说明】文档 更新【视频基本信息】 修改参数名“视频”为“稿件”

This commit is contained in:
SocialSisterYi 2020-10-11 15:41:50 +08:00
parent a15ce711ce
commit ab04d512cf
29 changed files with 620 additions and 273 deletions

View File

@ -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)√

View File

@ -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 | **作用尚不明确** |

View File

@ -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 | | |
@ -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`对象:
@ -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`对象:
@ -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`对象:
@ -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`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------ | ---- |
| series_id | num | 系列ID | |
| series_title | str | 系列名 | |
`result`中的`show`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------ | -------------------- |
| wide_screen | num | 投币数 | 0正常<br />1全屏 |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------- | -------------------- |
| wide_screen | num | 是否全屏 | 0正常<br />1全屏 |
`result`中的`stat`对象:
@ -155,6 +258,7 @@
| coins | num | 投币数 | |
| danmakus | num | 弹幕数 | |
| favorites | num | 收藏数 | |
| likes | num | 点赞数 | |
| reply | num | 评论数 | |
| share | num | 分享数 | |
| views | num | 播放数 | |
@ -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 | | |

View File

@ -8,7 +8,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ------ | -------- | ------------------------------ |
| room_id | str | 目标视频 | `video://{视频avID}/{视频CID}` |
| room_id | str | 目标视频 | `video://{稿件avID}/{视频CID}` |
| platform | str | 平台标识 | 默认为`web` |
| accepts | array | 操作标识 | |
@ -97,7 +97,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------ | ------------------------------ |
| online | num | 实时观看人数 | |
| room_id | str | 目标视频 | `video://{视频avID}/{视频CID}` |
| room_id | str | 目标视频 | `video://{稿件avID}/{视频CID}` |
**示例:**

View File

@ -124,7 +124,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------------------------------------------ |
| aid | num | 课程分集avID | **与普通视频avID部分不互通** |
| aid | num | 课程分集avID | **与普通稿件avID部分不互通** |
| cid | num | 课程分集CID | **与普通视频CID部分不互通** |
| duration | num | 课程分集时间长度 | 单位为秒 |
| from | str | pugv | |
@ -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 | |

View File

@ -11,7 +11,7 @@
| 代码 | 评论区类型 | oid的意义 |
| ---- | ----------------------- | ---------- |
| 1 | 视频稿件 | 视频avID |
| 1 | 视频稿件 | 稿件avID |
| 2 | 话题 | 话题ID |
| 4 | 活动 | 活动ID |
| 5 | 小视频 | 小视频ID |

View File

@ -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 |
@ -111,7 +111,7 @@ curl 'http://api.bilibili.com/x/v2/dm/post'\
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 互动弹幕类型 | 必要 | 1UP主头像弹幕<br />2关联视频弹幕<br />5视频内嵌引导关注按钮 |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
| cid | num | 视频CID | 必要 | |
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
| plat | num | 平台标识 | 必要 | 1web端<br />2安卓端<br />8视频管理页面 |

View File

@ -6,9 +6,11 @@
## 获取实时弹幕
> http://api.bilibili.com/x/v2/dm/web/seg.so
> http://api.bilibili.com/x/v2/dm/web/seg.so web端
>
> http://api.bilibili.com/x/v2/dm/list/seg.so
> http://api.bilibili.com/x/v2/dm/list/seg.so APP端
>
> http://i0.hdslb.com/bfs/dm/{data}.bin BAS/代码弹幕专包)
*请求方式GET*
@ -26,16 +28,16 @@
| ------------- | ---- | -------- | ------ | ----------- |
| type | num | 弹幕类 | 必要 | 1视频弹幕 |
| oid | num | 视频CID | 必要 | |
| pid | num | 视频avID | 非必要 | |
| pid | num | 稿件avID | 非必要 | |
| segment_index | num | 分包 | 必要 | 6分钟一包 |
**proto回复**
消息`DmSegMobileReply`
| 名称 | 类型 | 含义 | 备注 |
| ----- | ---------------- | -------- | ---- |
| elems | repeated message | 弹幕条目 | |
| 名称 | 类型 | 含义 | 备注 |
| ----- | -------------------- | -------- | ---- |
| elems | repeated DanmakuElem | 弹幕条目 | |
消息`DanmakuElem`
@ -43,7 +45,7 @@
| -------- | ------ | ------------------ | ------------------------------------------------------------ |
| id | int64 | 弹幕dmID | 唯一 可用于操作参数 |
| progress | int32 | 视频内弹幕出现时间 | 毫秒 |
| mode | int32 | 弹幕类型 | 1 2 3普通弹幕<br />4底部弹幕<br />5顶部弹幕<br />6逆向弹幕<br />7高级弹幕<br />8代码弹幕<br />~~9BAS弹幕~~ |
| mode | int32 | 弹幕类型 | 1 2 3普通弹幕<br />4底部弹幕<br />5顶部弹幕<br />6逆向弹幕<br />7高级弹幕<br />8代码弹幕<br />9BAS弹幕仅限于特殊弹幕专包 |
| fontsize | int32 | 弹幕字号 | 18<br />25标准<br />36大 |
| color | uint32 | 弹幕颜色 | 十进制RGB888值 |
| midHash | string | 发送者UID的HASH | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户ID |

View File

@ -22,24 +22,24 @@
| ------ | ---- | -------- | ------ | ----------- |
| type | num | 弹幕类 | 必要 | 1视频弹幕 |
| oid | num | 视频CID | 必要 | |
| pid | num | 视频avID | 非必要 | |
| pid | num | 稿件avID | 非必要 | |
**proto回复**
消息`DmWebViewReply`
| 名称 | 类型 | 含义 | 备注 |
| ---------- | ---------------- | ---------------------- | ---------------------------- |
| state | int32 | 弹幕开放状态 | 0开放弹幕<br />1禁止弹幕 |
| text | string | | |
| textSide | string | | |
| dmSge | message | 分段弹幕包信息? | |
| flag | message | | |
| specialDms | repeated message | BAS代码弹幕专包url | |
| checkBox | bool | | |
| count | int64 | 实际弹幕总数 | 具有1500-6000不等的上限 |
| commandDms | repeated message | 互动弹幕条目 | |
| dmSetting | message | 弹幕个人配置 | 仅登录后存在 |
| 名称 | 类型 | 含义 | 备注 |
| ---------- | -------------------- | ---------------------- | ---------------------------- |
| state | int32 | 弹幕开放状态 | 0开放弹幕<br />1禁止弹幕 |
| text | string | | |
| textSide | string | | |
| dmSge | DmSegConfig | 分段弹幕包信息? | |
| flag | DanmakuFlagConfig | | |
| specialDms | repeated string | BAS代码弹幕专包url | |
| checkBox | bool | | |
| count | int64 | 实际弹幕总数 | 具有1500-6000不等的上限 |
| commandDms | repeated CommandDm | 互动弹幕条目 | |
| dmSetting | DanmuWebPlayerConfig | 弹幕个人配置 | 仅登录后存在 |
消息`dmSge`
@ -217,8 +217,9 @@ curl -G 'http://api.bilibili.com/x/v2/dm/web/view'\
import web_dmview_pb2
import requests
AVID = 797164471
CID = 236871317
url = 'http://api.bilibili.com/x/v2/dm/web/view?type=1&oid='+str(CID)
url = 'http://api.bilibili.com/x/v2/dm/web/view?type=1&oid=' + str(CID) + '&pid=' + str(AVID)
data = requests.get(url)
target = web_dmview_pb2.DmWebViewReply()
@ -267,8 +268,9 @@ BAS弹幕`pool=2` `mode=9`)只能从此包获取,代码弹幕(`pool=2`
import web_dmview_pb2
import requests
AVID = 2
CID = 62131
url = 'http://api.bilibili.com/x/v2/dm/web/view?type=1&oid='+str(CID)
url = 'http://api.bilibili.com/x/v2/dm/web/view?type=1&oid=' + str(CID) + '&pid=' + str(AVID)
data = requests.get(url)
target = web_dmview_pb2.DmWebViewReply()

View File

@ -12,7 +12,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | -------- | ------------------ | ------ | ---- |
| aid | num或str | 视频avID或视频bvID | 必要 | |
| aid | num或str | 稿件avID或稿件bvID | 必要 | |
**json回复**

View File

@ -17,7 +17,7 @@
| elec_num | num | 充电电池数量 | 必要 | 必须在20-99990之间 |
| up_mid | num | 充电对象用户UID | 必要 | |
| otype | str | 充电来源 | 必要 | up空间充电<br />archive视频充电 |
| oid | num | 充电来源代码 | 必要 | 空间充电充电对象用户UID<br />视频充电:视频avID |
| oid | num | 充电来源代码 | 必要 | 空间充电充电对象用户UID<br />视频充电:稿件avID |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**

View File

@ -32,7 +32,7 @@
| up_mid | num | 充电对象用户UID | 必要 | |
| is_bp_remains_prior | bool | 是否优先扣除B币 | 必要 | true<br />false<br />在B币不足时剩余的部分利用支付平台支付 |
| otype | str | 充电来源 | 必要 | up空间充电<br />archive视频充电 |
| oid | num | 充电来源代码 | 必要 | 空间充电充电对象用户UID<br />视频充电:视频avID |
| oid | num | 充电来源代码 | 必要 | 空间充电充电对象用户UID<br />视频充电:稿件avID |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**

View File

@ -148,8 +148,8 @@ curl -G 'http://elec.bilibili.com/api/query.rank.do'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------------ | ------------------ |
| mid | num | 目标用户UID | 必要 | |
| aid | num | 目标视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 目标视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 目标稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 目标稿件bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**

View File

@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------------------- | ------ | ------------------------------------------------------------ |
| max | num | 历史记录截止目标ID | 非必要 | 默认为0<br />稿件:视频avID<br />番剧影视剧集ssID<br />直播直播间ID<br />文集文集rlID<br />文章文章cvID |
| max | num | 历史记录截止目标ID | 非必要 | 默认为0<br />稿件:稿件avID<br />番剧影视剧集ssID<br />直播直播间ID<br />文集文集rlID<br />文章文章cvID |
| business | num | 历史记录截止目标ID类型 | 非必要 | 默认为空<br />archive稿件<br />pgc番剧影视<br />live直播<br />article-list文集<br />article文章 |
| view_at | num | 历史记录截止时间 | 非必要 | 时间戳<br />默认为0<br />0为当前时间 |
| ps | num | 每页项数 | 非必要 | 默认为20 |
@ -112,9 +112,9 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------------- | ------------------------------------------------------------ |
| oid | num | 目标ID | 稿件视频&剧集(当`business=archive`或`business=pgc`时):视频avID<br />直播(当`business=live`时直播间ID<br />文章(当`business=article`时文章cvID<br />文集(当`business=article-list`时文集rlID |
| oid | num | 目标ID | 稿件视频&剧集(当`business=archive`或`business=pgc`时):稿件avID<br />直播(当`business=live`时直播间ID<br />文章(当`business=article`时文章cvID<br />文集(当`business=article-list`时文集rlID |
| epid | num | 剧集epID | 仅用于剧集 |
| bvid | str | 视频bvID | 仅用于稿件视频 |
| bvid | str | 稿件bvID | 仅用于稿件视频 |
| page | num | 观看到的视频分P数 | 仅用于稿件视频 |
| cid | num | 观看到的对象ID | 稿件视频&剧集(当`business=archive`或`business=pgc`时视频CID<br />文集(当`business=article-list`时文章cvID |
| part | str | 观看到的视频分P标题 | 仅用于稿件视频 |
@ -380,7 +380,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor'\
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------------------------ | ------------------------------------------------------------ |
| aid | num | 视频avID | |
| aid | num | 稿件avID | |
| videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区ID | |
| tname | str | 子分区名称 | |
@ -409,10 +409,10 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor'\
| count | num | 分P数 | 非投稿视频无此项 |
| progress | num | 观看进度 | 单位为秒 |
| view_at | num | 观看时间 | 时间戳 |
| kid | num | 视频avID | |
| kid | num | 稿件avID | |
| business | str | 视频类型标识 | archive用户投稿视频<br />pgc番剧/影视<br />cheese课程 |
| redirect_link | str | 重定向url | |
| bvid | str | 视频bvID | |
| bvid | str | 稿件bvID | |
`data`数组中的对象中的`rights`对象:
@ -443,7 +443,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor'\
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------------------------ | ------------ |
| aid | num | 视频avID | |
| aid | num | 稿件avID | |
| view | num | 普通:观看次数<br />屏蔽时:-1 | |
| danmaku | num | 弹幕条数 | |
| reply | num | 评论条数 | |
@ -727,7 +727,7 @@ curl -G 'http://api.bilibili.com/x/v2/history'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| kid | str | 删除的目标记录 | 必要 | 视频archive\_{视频avID}<br />直播live_{直播间ID}<br />专栏article\_{专栏cvID}<br />剧集pgc\_{剧集ssID}<br />文集article-list\_{文集rlID} |
| kid | str | 删除的目标记录 | 必要 | 视频archive\_{稿件avID}<br />直播live_{直播间ID}<br />专栏article\_{专栏cvID}<br />剧集pgc\_{剧集ssID}<br />文集article-list\_{文集rlID} |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**

View File

@ -16,8 +16,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**
@ -158,48 +158,77 @@ curl 'http://space.bilibili.com/ajax/channel/addAllToView'\
`data`中的`list`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ------------------------------ | -------------------- |
| aid | num | 视频avID | |
| videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区ID | |
| tname | str | 子分区名称 | |
| copyright | num | 版权标志 | 1自制<br />2转载 |
| pic | str | 视频封面图片url | |
| title | str | 视频标题 | |
| pubdate | num | 视频上传时间 | 时间戳 |
| ctime | num | 视频审核通过时间 | 时间戳 |
| desc | str | 视频简介 | |
| state | num | 0 | 作用尚不明确 |
| attribute | num | | 作用尚不明确 |
| duration | num | 视频总计持续时长所有分P | 单位为秒 |
| rights | obj | 视频属性标志 | |
| owner | obj | 视频UP主信息 | |
| stat | obj | 视频状态数 | |
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| dimension | obj | 视频1P分辨率 | |
| count | num | 分P数 | 非投稿视频无此项 |
| cid | num | 视频CID | |
| progress | num | 观看进度时间 | 单位为秒 |
| add_at | num | 添加时间 | 时间戳 |
| bvid | str | 视频bvID | |
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ------------------------------ | ------------------------------------------------------------ |
| aid | num | 稿件avID | |
| videos | num | 稿件分P总数 | 默认为1 |
| tid | num | 分区tID | |
| tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1原创<br />2转载 |
| pic | str | 稿件封面图片url | |
| title | str | 稿件标题 | |
| pubdate | num | 稿件发布时间 | 时间戳 |
| ctime | num | 用户提交稿件的时间 | 时间戳 |
| desc | str | 视频简介 | |
| state | num | 视频状态 | 0开放浏览<br />1橙色通过<br />-1待审<br />-2被打回<br />-3网警锁定<br />-4被锁定<br />-5管理员锁定可浏览<br />-6修复待审<br />-7暂缓审核<br />-8补档待审<br />-9等待转码<br />-10延迟审核<br />-11视频源待修<br />-12转储失败<br />-13允许评论待审<br />-14临时回收站<br />-15分发中<br />-16转码失败<br />-20创建未提交<br />-30创建已提交<br />-40定时发布<br />-100用户删除 |
| attribute | num | 稿件属性位配置 | |
| duration | num | 稿件总时长所有分P | 单位为秒 |
| rights | obj | 稿件属性标志 | |
| owner | obj | 稿件UP主信息 | |
| stat | obj | 稿件状态数 | |
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| dimension | obj | 稿件1P分辨率 | |
| count | num | 稿件分P数 | 非投稿视频无此项 |
| cid | num | 视频CID | |
| progress | num | 观看进度时间 | 单位为秒 |
| add_at | num | 添加时间 | 时间戳 |
| bvid | str | 稿件bvID | |
`attribute`属性位二进制值表:
| 位 | 内容 | 备注 |
| ---- | ----------------- | ----------------------- |
| 0 | 禁止排行 | |
| 1 | 动态禁止 | |
| 2 | 禁止网页输出 | |
| 3 | 禁止客户端列表 | |
| 4 | 搜索禁止 | |
| 5 | 海外禁止 | |
| 6 | 禁止推荐 | |
| 7 | 禁止转载 | |
| 8 | 是否高清 | 视频清晰度>=1080P |
| 9 | 是否PGC稿件 | 番剧及影视 |
| 10 | 允许承包 | |
| 11 | 是否番剧 | |
| 12 | 是否私单 | |
| 13 | 是否限制地区 | 大多数番剧 |
| 14 | 允许其他人添加tag | |
| 15 | | |
| 16 | 跳转 | 番剧及影视av/bv->ep跳转 |
| 17 | 是否影视 | |
| 18 | 付费 | |
| 19 | 推送动态 | |
| 20 | 家长模式 | |
| 21 | UGC付费 | |
| 22 | | |
| 23 | 是否失效 | |
`data`中的`list`数组中的对象中的`rights`对象:
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ---------------- | ---------------------------------------- |
| bp | num | 0 | 作用尚不明确 |
| elec | num | 0 | 作用尚不明确 |
| download | num | 允许下载标志 | 0不允许<br />1允许 |
| movie | num | 视频时电影标志 | 0<br />1是 |
| pay | num | 仅会员可观看标志 | 0<br />1有 |
| hd5 | num | 有高码率标志 | 0<br />1有 |
| no_reprint | num | 禁止转载标志 | 0<br />1禁止 |
| autoplay | num | 可自动播放标志 | 0<br />1有 区别影视番剧与普通视频 |
| ugc_pay | num | 0 | 作用尚不明确 |
| is_cooperation | num | 视频合作标志 | 0<br />1是 |
| ugc_pay_preview | num | 0 | 作用尚不明确 |
| no_background | num | 0 | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ---------------- | ------------ |
| bp | num | 0 | 作用尚不明确 |
| elec | num | 是否支持充电 | |
| download | num | 是否允许下载 | |
| movie | num | 是否电影 | |
| pay | num | 是否PGC付费 | |
| hd5 | num | 是否有高码率 | |
| no_reprint | num | 是否禁止转载 | |
| autoplay | num | 是否可以自动播放 | |
| ugc_pay | num | 是否UGC付费 | |
| is_cooperation | num | 是否联合投稿 | |
| ugc_pay_preview | num | 0 | 作用尚不明确 |
| no_background | num | 0 | 作用尚不明确 |
`data`中的`list`数组中的对象中的`owner`对象:
@ -213,7 +242,7 @@ curl 'http://space.bilibili.com/ajax/channel/addAllToView'\
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------------------------ | ------------ |
| aid | num | 视频avID | |
| aid | num | 稿件avID | |
| view | num | 普通:观看次数<br />屏蔽时:-1 | |
| danmaku | num | 弹幕条数 | |
| reply | num | 评论条数 | |

160
other/bvID.md Normal file
View File

@ -0,0 +1,160 @@
# bvID说明
2020-03-23 B站推出了全新的稿件视频ID“bvID”来接替之前的“avID”其用法与性质等价于“avID”
详见:
1. [【升级公告】AV号全面升级至BV号专栏](https://www.bilibili.com/read/cv5167957)
2. [【升级公告】AV号全面升级至BV号](https://www.bilibili.com/blackboard/activity-BV-PC.html)
## 格式:
“bvID”恒为长度为12的字符串前两个字母为大写“BV”后10个位base58计算结果
## 实质:
“bvID"为“avID”的base58编码可通过算法进行相互转化
## avID发放方式的变化
从2009-09-09 09:09:09 [av2](https://www.bilibili.com/video/av2)的发布到2020-03-28 19:45:02 [av99999999](https://www.bilibili.com/video/av99999999)的发布B站结束了以投稿时间为顺序的avID发放改为随机发放avID
~~暗示B站东方要完泪目~~
## av->bv算法
1. a=(avID⊕177451812)+100618342136696320
2. 以i为循环变量循环10次b[i]=(a/58^i)%58
3. 将b[i]中各个数字转换为以下码表中的字符
码表:
> fZodR9XQDSUm21yCkr6zBqiveYah8bt4xsWpHnJE7jL5VG3guMTKNPAwcF
4. 按照以下字符顺序编码表编码
字符编码表:
> 0->11
>
> 1->10
>
> 2->3
>
> 3->8
>
> 4->4
>
> 5->6
>
> 6->2
>
> 7->9
>
> 8->5
>
> 9->7
5. 最后在前面添加字符`BV`
[援引知乎@mcfx的回答](https://www.zhihu.com/question/381784377/answer/1099438784)
## bv->av算法
为以上算法的逆运算
## 转换程序:
目前使用python与c作为示例
### python
```python
table = 'fZodR9XQDSUm21yCkr6zBqiveYah8bt4xsWpHnJE7jL5VG3guMTKNPAwcF' //码表
tr = {} //反查码表
for i in range(58):
tr[table[i]] = i
s = [11, 10, 3, 8, 4, 6, 2, 9, 5, 7] //位置编码表
xor = 177451812 //固定异或值
add = 100618342136696320 //固定加法值
def bv2av(x):
r = 0
for i in range(10):
r += tr[x[s[i]]] * 58 ** i
return (r - add) ^ xor
def av2bv(x):
x = (x ^ xor) + add
r = list('BV ')
for i in range(10):
r[s[i]] = table[x // 58 ** i % 58]
return ''. join(r)
print(av2bv(170001))
print(bv2av('BV17x411w7KC'))
```
输出为:
```
BV17x411w7KC
170001
```
### C语言
```c
#include <stdio.h>
#include <math.h>
#include <string.h>
const char table[] = "fZodR9XQDSUm21yCkr6zBqiveYah8bt4xsWpHnJE7jL5VG3guMTKNPAwcF"; //码表
char tr[124]; //反查码表
const unsigned long long Xor = 177451812; //固定异或值
const unsigned long long add = 100618342136696320; //固定加法值
const int s[] = {11, 10, 3, 8, 4, 6, 2, 9, 5, 7}; //位置编码表
char result[13]; //编码结果
void tr_init()
{
for (int i = 0; i < 58; i++)
tr[table[i]] = i;
}
unsigned long long bv2av(char bv[])
{
unsigned long long r = 0;
unsigned long long av;
for (int i = 0; i < 10; i++)
r += tr[bv[s[i]]] * (unsigned long long)pow(58, i);
av = (r - add) ^ Xor;
return av;
}
char* av2bv(unsigned long long av)
{
strcpy(result,"BV ");
av = (av ^ Xor) + add;
for (int i = 0; i < 10; i++)
result[s[i]] = table[(unsigned long long)(av / (unsigned long long)pow(58, i)) % 58];
result[10] = '\0';//添加休止符
char *bv=result;
return bv;
}
int main()
{
tr_init();
printf("%s\n",av2bv(170001));
printf("%u\n",bv2av("BV17x411w7KC"));
return 0;
}
```
输出为:
```
BV17x411w7KC
170001
```

View File

@ -29,7 +29,7 @@
| show_name | str | 显示文字 | |
| name | str | 空 | |
| goto_type | num | 跳转类型 | 1视频 |
| goto_value | str | 搜索目标ID | 视频:视频avID |
| goto_value | str | 搜索目标ID | 视频:稿件avID |
| url | str | 搜索目标跳转url | |
**示例:**

View File

@ -7,14 +7,14 @@
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ----- | -------------- | ----------------------------------------- |
| type | str | 结果类型 | 固定为video |
| id | num | 结果ID | 为视频avID |
| id | num | 结果ID | 为稿件avID |
| author | str | UP主昵称 | |
| mid | num | UP主UID | |
| typeid | str | 视频分区tID | |
| typename | str | 视频子分区名 | |
| arcurl | str | 视频重定向url | |
| aid | num | 视频avID | |
| bvid | str | 视频bvID | |
| aid | num | 稿件avID | |
| bvid | str | 稿件bvID | |
| title | str | 视频标题 | 关键字用xml标签`<em class="keyword">`标注 |
| description | str | 视频简介 | |
| arcrank | str | 0 | **作用尚不明确** |
@ -599,8 +599,8 @@
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ----------------- | ---------------- |
| aid | num | 视频avID | |
| bvid | str | 视频bvID | |
| aid | num | 稿件avID | |
| bvid | str | 稿件bvID | |
| title | str | 视频标题 | |
| pubdate | num | 视频投稿时间 | 时间戳 |
| arcurl | str | 视频页面重定向url | |

View File

@ -35,7 +35,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------------------ | ----------------------- |
| aid | num | 视频avID | |
| aid | num | 稿件avID | |
| videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区ID | |
| tname | str | 子分区名称 | |
@ -54,7 +54,7 @@
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| cid | num | 视频1P CID | |
| dimension | obj | 视频1P分辨率 | |
| bvid | str | 视频bvID | |
| bvid | str | 稿件bvID | |
| reason | str | 置顶视频备注 | |
| inter_video | bool | 是否为合作视频 | false<br />true是 |
@ -87,7 +87,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------------------------ | ------------ |
| aid | num | 视频avID | |
| aid | num | 稿件avID | |
| view | num | 普通:观看次数<br />屏蔽时:-1 | |
| danmaku | num | 弹幕条数 | |
| reply | num | 评论条数 | |
@ -199,8 +199,8 @@ curl -G 'http://api.bilibili.com/x/space/top/arc'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | -------------------------------- |
| aid | num | 置顶目标视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 置顶目标视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 置顶目标稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 置顶目标稿件bvID | 必要(可选) | avID与bvID任选一个 |
| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符<br />默认为空 |
| csrf | str | CSRF Token位于cookie | 必要 | |
@ -539,8 +539,8 @@ curl -G 'http://api.bilibili.com/x/space/masterpiece'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | -------------------------------- |
| aid | num | 置顶目标视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 置顶目标视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 置顶目标稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 置顶目标稿件bvID | 必要(可选) | avID与bvID任选一个 |
| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符<br />默认为空 |
| csrf | str | CSRF Token位于cookie | 必要 | |
@ -601,8 +601,8 @@ curl 'http://api.bilibili.com/x/space/masterpiece/add'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ------------------ |
| aid | num | 要删除的目标视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 要删除的目标视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 要删除的目标稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 要删除的目标稿件bvID | 必要(可选) | avID与bvID任选一个 |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**
@ -2281,7 +2281,7 @@ curl 'http://api.bilibili.com/x/space/channel/del'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---------------------- |
| cid | num | 频道ID | 必要 | |
| aids | nums | 要添加的目标视频avID | 必要 | 多个使用","%2C分隔 |
| aids | nums | 要添加的目标稿件avID | 必要 | 多个使用","%2C分隔 |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**
@ -2293,14 +2293,14 @@ curl 'http://api.bilibili.com/x/space/channel/del'\
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />-404无此项<br />53003本频道里的视频已满<br />53006提交视频已失效或频道里有非该视频UP主 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | array | 出错视频avID列表 | |
| data | array | 出错稿件avID列表 | |
`data`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------- | ---- |
| 0 | num | 出错视频avID1 | |
| n | num | 出错视频avIDn+1 | |
| 0 | num | 出错稿件avID1 | |
| n | num | 出错稿件avIDn+1 | |
| …… | num | …… | …… |
**示例:**
@ -2344,7 +2344,7 @@ curl 'http://api.bilibili.com/x/space/channel/video/add'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 频道ID | 必要 | |
| aid | num | 要删除的目标视频avID | 必要 | |
| aid | num | 要删除的目标稿件avID | 必要 | |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**
@ -2395,7 +2395,7 @@ curl 'http://api.bilibili.com/x/space/channel/video/del'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| cid | num | 频道ID | 必要 | |
| aid | num | 要移动的目标视频avID | 必要 | |
| aid | num | 要移动的目标稿件avID | 必要 | |
| to | num | 视频排序倒数位置 | 非必要 | 默认为1<br />1为列表底部视频总数为首端<br />与显示顺序恰好相反 |
| csrf | str | CSRF Token位于cookie | 必要 | |
@ -2530,21 +2530,23 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check
`data`中的`list`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ----------------------------------------- |
| id | num | 收藏夹mlID | |
| fid | num | 原始收藏夹ID | 去除两位UID尾号 |
| mid | num | 创建用户UID | |
| attr | num | 收藏夹属性 | 转换成8-bit二进制处理<br />详细说明见下表 |
| title | str | 收藏夹标题 | |
| fav_state | num | 0 | 作用尚不明确 |
| media_count | num | 收藏夹总计视频数 | |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | --------------- |
| id | num | 收藏夹mlID | |
| fid | num | 原始收藏夹ID | 去除两位UID尾号 |
| mid | num | 创建用户UID | |
| attr | num | 收藏夹属性位配置 | |
| title | str | 收藏夹标题 | |
| fav_state | num | 0 | 作用尚不明确 |
| media_count | num | 收藏夹总计视频数 | |
`attr`属性二进制值表:
`attr`属性二进制值表:
| 其他有待补充... | 1默认收藏夹 | 0公开性 |
| --------------- | -------------------------------- | -------------------- |
| | 0默认收藏夹<br />1其他收藏夹 | 0公开<br />1私有 |
| 位 | 内容 | 备注 |
| --------------- | ---------------- | -------------------------------- |
| 0 | 是否为默认收藏夹 | 0默认收藏夹<br />1其他收藏夹 |
| 1 | 私有收藏夹 | 0公开<br />1私有 |
| 其他有待补充... | | |
**示例:**

View File

@ -2,7 +2,7 @@
<img src="/imgs/ploading.gif" width="100" height="100"/>
## 获取视频详细信息(avID/bvID互转及转epID
## 获取视频详细信息(web端
> http://api.bilibili.com/x/web-interface/view
@ -12,8 +12,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**
@ -28,51 +28,80 @@
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | ------------------------------ | --------------------- |
| bvid | str | 视频bvID | |
| aid | num | 视频avID | |
| videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区ID | |
| tname | str | 子分区名称 | |
| copyright | num | 版权标志 | 1自制<br />2转载 |
| pic | str | 视频封面图片url | |
| title | str | 视频标题 | |
| pubdate | num | 视频上传时间 | 时间戳 |
| ctime | num | 视频审核通过时间 | 时间戳 |
| desc | str | 视频简介 | |
| state | num | 0 | 作用尚不明确 |
| attribute | num | | 作用尚不明确 |
| duration | num | 视频总计持续时长所有分P | 单位为秒 |
| mission_id | num | 视频参与的活动ID | 无为0 |
| redirect_url | str | 重定向url | 用于番剧&影视的av->ep |
| rights | obj | 视频属性标志 | |
| owner | obj | 视频UP主信息 | |
| stat | obj | 视频状态数 | |
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| cid | num | 视频1P CID | |
| dimension | obj | 视频1P分辨率 | |
| no_cache | bool | true | 作用尚不明确 |
| pages | array | 视频分P列表 | |
| subtitle | obj | 视频CC字幕 | |
| staff | array | 合作成员列表 | 可不存在 |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | ------------------------------ | ------------------------------------------------------------ |
| bvid | str | 稿件bvID | |
| aid | num | 稿件avID | |
| videos | num | 稿件分P总数 | 默认为1 |
| tid | num | 分区tID | |
| tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1原创<br />2转载 |
| pic | str | 稿件封面图片url | |
| title | str | 稿件标题 | |
| pubdate | num | 稿件发布时间 | 时间戳 |
| ctime | num | 用户提交稿件的时间 | 时间戳 |
| desc | str | 视频简介 | |
| state | num | 视频状态 | 0开放浏览<br />1橙色通过<br />-1待审<br />-2被打回<br />-3网警锁定<br />-4被锁定<br />-5管理员锁定可浏览<br />-6修复待审<br />-7暂缓审核<br />-8补档待审<br />-9等待转码<br />-10延迟审核<br />-11视频源待修<br />-12转储失败<br />-13允许评论待审<br />-14临时回收站<br />-15分发中<br />-16转码失败<br />-20创建未提交<br />-30创建已提交<br />-40定时发布<br />-100用户删除 |
| attribute | num | 稿件属性位配置 | |
| duration | num | 稿件总时长所有分P | 单位为秒 |
| mission_id | num | 稿件参与的活动ID | 无为0 |
| redirect_url | str | 重定向url | 用于番剧及影视的av/bv->ep |
| rights | obj | 视频属性标志 | |
| owner | obj | 视频UP主信息 | |
| stat | obj | 视频状态数 | |
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| cid | num | 视频1P CID | |
| dimension | obj | 视频1P分辨率 | |
| no_cache | bool | true | 作用尚不明确 |
| pages | array | 视频分P列表 | |
| subtitle | obj | 视频CC字幕 | |
| staff | array | 合作成员列表 | 非合作视频无此项 |
`attribute`属性位二进制值表:
| 位 | 内容 | 备注 |
| ---- | ----------------- | ----------------------- |
| 0 | 禁止排行 | |
| 1 | 动态禁止 | |
| 2 | 禁止网页输出 | |
| 3 | 禁止客户端列表 | |
| 4 | 搜索禁止 | |
| 5 | 海外禁止 | |
| 6 | 禁止推荐 | |
| 7 | 禁止转载 | |
| 8 | 是否高清 | 视频清晰度>=1080P |
| 9 | 是否PGC稿件 | 番剧及影视 |
| 10 | 允许承包 | |
| 11 | 是否番剧 | |
| 12 | 是否私单 | |
| 13 | 是否限制地区 | 大多数番剧 |
| 14 | 允许其他人添加tag | |
| 15 | | |
| 16 | 跳转 | 番剧及影视av/bv->ep跳转 |
| 17 | 是否影视 | |
| 18 | 付费 | |
| 19 | 推送动态 | |
| 20 | 家长模式 | |
| 21 | UGC付费 | |
| 22 | | |
| 23 | 是否失效 | |
`data`中的`rights`对象:
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ---------------- | ---------------------------------------- |
| bp | num | 0 | 作用尚不明确 |
| elec | num | 0 | 作用尚不明确 |
| download | num | 允许下载标志 | 0不允许<br />1允许 |
| movie | num | 视频时电影标志 | 0<br />1是 |
| pay | num | 仅会员可观看标志 | 0<br />1有 |
| hd5 | num | 有高码率标志 | 0<br />1有 |
| no_reprint | num | 禁止转载标志 | 0<br />1禁止 |
| autoplay | num | 可自动播放标志 | 0<br />1有 区别影视番剧与普通视频 |
| ugc_pay | num | 0 | 作用尚不明确 |
| is_cooperation | num | 视频合作标志 | 0<br />1是 |
| ugc_pay_preview | num | 0 | 作用尚不明确 |
| no_background | num | 0 | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ---------------- | ------------ |
| bp | num | 0 | 作用尚不明确 |
| elec | num | 是否支持充电 | |
| download | num | 是否允许下载 | |
| movie | num | 是否电影 | |
| pay | num | 是否PGC付费 | |
| hd5 | num | 是否有高码率 | |
| no_reprint | num | 是否禁止转载 | |
| autoplay | num | 是否可以自动播放 | |
| ugc_pay | num | 是否UGC付费 | |
| is_cooperation | num | 是否联合投稿 | |
| ugc_pay_preview | num | 0 | 作用尚不明确 |
| no_background | num | 0 | 作用尚不明确 |
`data`中的`owner`对象:
@ -84,20 +113,20 @@
`data`中的`stat`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------------------------ | ------------ |
| aid | num | 视频avID | |
| view | num | 普通:观看次数<br />屏蔽时:-1 | |
| danmaku | num | 弹幕 | |
| reply | num | 评论 | |
| favorite | num | 收藏 | |
| coin | num | 投币 | |
| share | num | 分享 | |
| now_rank | num | 0 | 作用尚不明确 |
| his_rank | num | 历史最高排行 | |
| like | num | 获赞 | |
| dislike | num | 0 | 作用尚不明确 |
| evaluation | str | 视频评分 | 默认为空 |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | ------- |
| aid | num | 稿件avID | |
| view | num | 播放数 | |
| danmaku | num | 弹幕数 | |
| reply | num | 评论数 | |
| favorite | num | 收藏数 | |
| coin | num | 投币数 | |
| share | num | 分享数 | |
| now_rank | num | 当前排名 | |
| his_rank | num | 历史最高排行 | |
| like | num | 获赞数 | |
| dislike | num | 点踩数 | 恒为`0` |
| evaluation | str | 视频评分 | |
`data`中的`pages`数组:
@ -109,16 +138,16 @@
`pages`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | --------------- | ------------------------------------ |
| cid | num | 当前分P CID | |
| page | num | 当前分P | |
| from | str | 视频来源 | vupload普通上传<br />hunan芒果TV |
| part | str | 当前分P标题 | |
| duration | num | 当前分P持续时间 | 单位为秒 |
| vid | str | 空 | 作用尚不明确 |
| weblink | str | 空 | 作用尚不明确 |
| dimension | obj | 当前分P分辨率 | 有部分视频无法获取分辨率 |
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | --------------- | --------------------------------------------------------- |
| cid | num | 当前分P CID | |
| page | num | 当前分P | |
| from | str | 视频来源 | vupload普通上传B站<br />hunan芒果TV<br />qq腾讯 |
| part | str | 当前分P标题 | |
| duration | num | 当前分P持续时间 | 单位为秒 |
| vid | str | 站外视频vid | |
| weblink | str | 站外视频跳转url | |
| dimension | obj | 当前分P分辨率 | 有部分视频无法获取分辨率 |
`pages`数组中的对象中的`dimension`对象(同`data`中的`dimension`对象)
@ -208,6 +237,8 @@
**示例:**
获取视频`av85440373`/`BV117411r7R1`的基本信息
avID方式
```shell
@ -350,18 +381,34 @@ curl -G 'http://api.bilibili.com/x/web-interface/view'\
</details>
可得出视频封面为:**(可用于封面提取)**
视频标题为:`当我给拜年祭的快板加了电音配乐…`
视频分区为:`tid=28音乐->原创音乐)`
视频时长:`486s`
视频发布时间:`2020/1/30 17:40:55`
视频投稿时间:`2020/1/28 19:51:3`
视频分P为`1`
视频类型为:`1原创`
视频UP主为`66606350Crazy_Bucket`
视频简介为:
`【CB想说的】看完拜年祭之后最爱的一个节目给有快板的部分简单加了一些不同风格的配乐hhh感谢沃玛画的我太可爱了哈哈哈哈哈哈哈\n【Warma想说的】我画了打碟的CB画风为了还原原版视频所以参考了四迹老师的画风四迹老师的画真的太可爱啦不过其实在画的过程中我遇到了一个问题CB的耳机……到底是戴在哪个耳朵上呢\n\n原版av78977080\n编曲配乐Crazy Bucket\n人声配音Warma/谢拉\n曲绘四迹/Warma\n动画四迹/Crazy Bucket\n剧本Mokurei-木灵君\n音频后期DMYoung/纳兰寻风/Crazy Bucket\n包装破晓天`
视频状态为:`0开放浏览`
视频封面为:
http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg
![](http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg)
UP主头像为
http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
<img src="http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg" width="100" height="100" />
## 获取视频简介
@ -374,8 +421,8 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**
@ -430,8 +477,8 @@ curl -G 'http://api.bilibili.com/x/archive/desc'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**
@ -454,16 +501,16 @@ curl -G 'http://api.bilibili.com/x/archive/desc'\
数组`data`中的对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | --------------- | ------------------------------------ |
| cid | num | 当前分P CID | |
| page | num | 当前分P | |
| from | str | 视频来源 | vupload普通上传<br />hunan芒果TV |
| part | str | 当前分P标题 | |
| duration | num | 当前分P持续时间 | 单位为秒 |
| vid | str | 空 | 作用尚不明确 |
| weblink | str | 空 | 作用尚不明确 |
| dimension | obj | 当前分P分辨率 | 有部分视频无法获取分辨率 |
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | --------------- | --------------------------------------------------------- |
| cid | num | 当前分P CID | |
| page | num | 当前分P | |
| from | str | 视频来源 | vupload普通上传B站<br />hunan芒果TV<br />qq腾讯 |
| part | str | 当前分P标题 | |
| duration | num | 当前分P持续时间 | 单位为秒 |
| vid | str | 站外视频vid | |
| weblink | str | 站外视频跳转url | |
| dimension | obj | 当前分P分辨率 | 有部分视频无法获取分辨率 |
数组`data`中的对象中的`dimension`对象:

View File

@ -14,8 +14,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
| graph_version | num | 剧情图ID | 必要 | 位于`player.so`中 |
| edge_id | num | 模块编号 | 非必要 | 0或留空为起始模块 |
@ -160,7 +160,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| aid | num | 视频avID | |
| aid | num | 稿件avID | |
| cid | num | 分P CID | |
`data`中的`hidden_vars`数组:

View File

@ -18,8 +18,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ---------------------- |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
| like | num | 操作方式 | 必要 | 1点赞<br />2取消赞 |
| csrf | str | CSRF Token位于cookie | 必要 | |
@ -83,7 +83,7 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
| like | num | 操作方式 | 必要 | 0点赞<br />1取消赞 |
**json回复**
@ -143,8 +143,8 @@ curl 'http://app.bilibili.com/x/v2/view/like'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ------------ | ------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**
@ -208,8 +208,8 @@ curl -G 'api.bilibili.com/x/web-interface/archive/has/like'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------------ | ------------ | --------------------------------------- |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| select_like | num | 是否附加点赞 | 非必要 | 0不点赞<br />1同时点赞<br />默认为0 |
| csrf | str | CSRF Token位于cookie | 必要 | |
@ -286,7 +286,7 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------ | ----------- | --------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| select_like | num | 附加点赞 | 非必要 | 0不点赞<br />1同时点赞<br />默认为0 |
@ -346,8 +346,8 @@ curl 'http://app.bilibili.com/x/v2/view/coin/add'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ------------ | ------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**
@ -423,7 +423,7 @@ curl -G 'api.bilibili.com/x/web-interface/archive/coins'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | ------------------------ | -------------- | ------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| rid | num | 视频avID | 必要 | |
| rid | num | 稿件avID | 必要 | |
| type | num | 必须为2 | 必要 | |
| add_media_ids | nums | 需要加入的收藏夹ID | 非必要 | 同时添加多个,用`,`%2C分隔 |
| del_media_ids | nums | 需要取消的收藏夹ID | 非必要 | 同时取消多个,用`,`%2C分隔 |
@ -501,7 +501,7 @@ curl 'http://api.bilibili.com/medialist/gateway/coll/resource/deal'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | -------- | ------------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num或str | 视频avID或视频bvID | 必要 | |
| aid | num或str | 稿件avID或稿件bvID | 必要 | |
**json回复**
@ -576,8 +576,8 @@ curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**
@ -656,7 +656,7 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like/triple'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
**json回复**

View File

@ -12,8 +12,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**

View File

@ -15,7 +15,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | --------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
| cid | num | 视频CID | 必要 | 用于识别分P |
| progress | num | 观看进度 | 非必要 | 单位为秒<br />默认为0 |
| platform | str | 平台标识 | 非必要 | 可为android |
@ -88,8 +88,8 @@ curl 'http://api.bilibili.com/x/v2/history/report'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------------ | ------------ | ------------------------------------------------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
| cid | num | 视频CID | 非必要 | 用于识别分P |
| epid | num | 番剧epID | 非必要 | |
| sid | num | 番剧ssID | 非必要 | |

View File

@ -15,8 +15,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------ | ------------ | ----------------------------------- |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
| cid | num | 分P CID | 非必要 | 默认为1P |
| index | num | json数组截取时间表 | 非必要 | 1需要<br />0不需要<br />默认为0 |
@ -115,7 +115,7 @@ curl -G 'http://api.bilibili.com/x/player/videoshot'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ----------- | ---- |
| appkey | str | APP密钥 | APP方式必要 | |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
| cid | num | 分P CID | 必要 | |
| ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | APP方式必要 | |
@ -199,7 +199,7 @@ curl -G 'http://app.bilibili.com/x/v2/view/video/shot'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
**json回复**

View File

@ -9,7 +9,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
**json回复**
@ -26,7 +26,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ------------------------ | ------------------------------ | -------------------- |
| aid | num | 视频avID | |
| aid | num | 稿件avID | |
| view | 正常num<br />屏蔽str | 正常:播放次数<br />屏蔽:"--" | |
| danmaku | num | 弹幕条数 | |
| reply | num | 评论条数 | |
@ -91,8 +91,8 @@ curl -G 'http://api.bilibili.com/archive_stat/stat'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**
@ -109,8 +109,8 @@ curl -G 'http://api.bilibili.com/archive_stat/stat'\
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ------------------------ | ------------------------------ | -------------------- |
| aid | num | 视频avID | |
| bvid | str | 视频bvID | |
| aid | num | 稿件avID | |
| bvid | str | 稿件bvID | |
| view | 正常num<br />屏蔽str | 正常:播放次数<br />屏蔽:"--" | |
| danmaku | num | 弹幕条数 | |
| reply | num | 评论条数 | |

View File

@ -12,8 +12,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| aid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
**json回复**
@ -216,7 +216,7 @@ curl -G 'http://api.bilibili.com/x/tag/archive/tags'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
| tag_id | num | TAGID | 必要 | |
| csrf | str | CSRF Token位于cookie | 必要 | |
@ -269,7 +269,7 @@ curl 'http://api.bilibili.com/x/tag/archive/like2'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| aid | num | 视频avID | 必要 | |
| aid | num | 稿件avID | 必要 | |
| tag_id | num | TAGID | 必要 | |
| csrf | str | CSRF Token位于cookie | 必要 | |

View File

@ -1,6 +1,6 @@
# 视频分区一览
用于通过视频avID判断所在的分区或推荐分区视频等.......
用于通过稿件avID判断所在的分区或推荐分区视频等.......
亦可用于更深♂入了解B站的分区

View File

@ -85,8 +85,8 @@ dash方式fnval=16
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------------- | ------------ | ------------------------------------------------------------ |
| avid | num | 视频avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 视频bvID | 必要(可选) | avID与bvID任选一个 |
| avid | num | 稿件avID | 必要(可选) | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要(可选) | avID与bvID任选一个 |
| cid | num | 视频CID | 必要 | |
| qn | num | 视频清晰度选择 | 非必要 | 未登录默认32480P<br />登录默认64720P<br />**值含义见上表**<br />dash方式无效 |
| fnval | num | 视频获取方式选择 | 非必要 | 默认为0<br />0 2flv方式可能会有分段<br />1低清mp4方式仅240P与360P且限速65K/s<br />16dash方式音视频分流支持H.265 |