github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-26 20:40:13 +08:00
Code Issues Packages Projects Releases Wiki Activity

统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档

Browse Source
This commit is contained in:
社会易姐QwQ 2021-07-12 21:31:27 +08:00
parent 3512adf59d
commit a7a743dffd
87 changed files with 1027 additions and 978 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
APP_widget/splash.md
View File

@ -53,7 +53,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | --------------------- | ---- |
| id | num | 开屏图片ID | |
| id | num | 开屏图片id | |
| thumb | str | 开屏图片url | |
| logo_url | str | “bilibili”logo图片url | |
@ -67,7 +67,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------- | ------------ |
| id | num | 开屏图片ID | |
| id | num | 开屏图片id | |
| begin_time | num | 起始时间？ | 时间戳 |
| end_time | num | 结束时间？ | 时间戳 |
| probability | num | 0 | 作用尚不明确 |
@ -136,7 +136,7 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
</details>
如ID=11的图片为：
如id=11的图片为：
![]( http://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png )

3
README.md
View File

@ -45,7 +45,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http`
- [API认证与鉴权（APP与Cookie方式）](other/API_auth.md)×
- [公共错误码](other/errcode.md)√
- [图片格式化](other/picture.md)√
- [bvID说明](other/bvID.md)√
- [bvid说明](other/bvid_desc.md)√
- [grpc接口](grpc_api)×
- [登录](login)
- [登录操作（人机认证）](login/login_action)√
@ -79,6 +79,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http`
- [互动视频](video/interact_video.md)×
- [高能进度条](video/pbp.md)√
- [信息上报（心跳及记录历史）](video/report.md)×
- [视频属性数据](video/attribute_data.md)√
- [剧集（番剧、影视）](bangumi)
- [基本信息](bangumi/info.md)×
- 状态数

12
album/action.md
View File

@ -18,7 +18,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | ---------------------- |
| doc_id | num | 相簿ID | 必要 | |
| doc_id | num | 相簿id | 必要 | |
| type | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 |
| csrf_token | str | CSRF Token（位于cookie） | 非必要 | |
@ -41,7 +41,7 @@
**示例：**
点赞相簿`ID=99184721`
点赞相簿`id=99184721`
```shell
curl 'http://api.vc.bilibili.com/link_draw/v2/Vote/operate' \
@ -79,7 +79,7 @@ curl 'http://api.vc.bilibili.com/link_draw/v2/Vote/operate' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | ------------ |
| fav_id | num | 相簿ID | 必要 | |
| fav_id | num | 相簿id | 必要 | |
| biz_type | num | 2 | 必要 | 作用尚不明确 |
| csrf_token | str | CSRF Token（位于cookie） | 非必要 | |
@ -96,7 +96,7 @@ curl 'http://api.vc.bilibili.com/link_draw/v2/Vote/operate' \
**示例：**
收藏相簿`ID=99184721`
收藏相簿`id=99184721`
```shell
curl 'http:///api.vc.bilibili.com/user_plus/v1/Fav/add' \
@ -133,7 +133,7 @@ curl 'http:///api.vc.bilibili.com/user_plus/v1/Fav/add' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | ------------ |
| fav_id | num | 相簿ID | 必要 | |
| fav_id | num | 相簿id | 必要 | |
| biz_type | num | 2 | 必要 | 作用尚不明确 |
| csrf_token | str | CSRF Token（位于cookie） | 非必要 | |
@ -150,7 +150,7 @@ curl 'http:///api.vc.bilibili.com/user_plus/v1/Fav/add' \
**示例：**
取消收藏相簿`ID=99184721`
取消收藏相簿`id=99184721`
```shell
curl 'http://api.vc.bilibili.com/user_plus/v1/Fav/delete' \

10
album/info.md
View File

@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ---- |
| doc_id | num | 目标相簿ID | 必要 | |
| doc_id | num | 目标相簿id | 必要 | |
**json回复：**
@ -40,7 +40,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---------- | ---- |
| uid | num | 作者UID | |
| uid | num | 作者mid | |
| head_url | str | 头像url | |
| name | str | 昵称 | |
| vip | obj | 会员信息 | |
@ -70,8 +70,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----- | ------------------ | ------------------------------------------------------------ |
| biz | num | 相簿分区 | 1：画友<br />2：摄影<br />3：日常 |
| doc_id | num | 相簿ID | |
| poster_uid | num | 作者UID | |
| doc_id | num | 相簿id | |
| poster_uid | num | 作者mid | |
| category | str | 子分区标识 | cos：cosplay<br />daily：日常<br />illustration：插画<br />comic：漫画<br />draw：其他<br />sifu：私服 |
| type | num | 相簿类型 | 0：原创<br />1：同人 |
| title | str | 标题 | |
@ -140,7 +140,7 @@
**示例：**
查询相簿`ID=99184721`的详细信息
查询相簿`id=99184721`的详细信息
```shell
curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/detail' \

10
album/list.md
View File

@ -61,7 +61,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------- | ---- |
| uid | num | 作者UID | |
| uid | num | 作者mid | |
| head_url | str | 头像url | |
| name | str | 昵称 | |
@ -69,8 +69,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ----- | ---------- | --------------------------------- |
| doc_id | num | 相簿ID | |
| poster_uid | num | 作者UID | |
| doc_id | num | 相簿id | |
| poster_uid | num | 作者mid | |
| pictures | array | 相簿图片 | |
| title | str | 标题 | |
| category | str | 子分区名 | |
@ -1340,7 +1340,7 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v2/Photo/list' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------- | ------ | --------------------------------------------- |
| biz | num | 分区 | 非必要 | 0：全部<br />1：画友<br/>2：摄影<br />默认为0 |
| poster_uid | num | 作者UID | 必要 | 默认为20 |
| poster_uid | num | 作者mid | 必要 | 默认为20 |
| page_num | num | 页码 | 非必要 | 默认为1 |
| page_size | num | 每页项数 | 非必要 | 默认为45 |
@ -1367,7 +1367,7 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v2/Photo/list' \
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------- | ---- |
| uid | str | 作者UID | |
| uid | str | 作者mid | |
| head_url | str | 头像url | |
| name | str | 昵称 | |

2
album/recommend_author.md
View File

@ -40,7 +40,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------- | ------------ |
| uid | num | 作者UID | |
| uid | num | 作者mid | |
| head_url | str | 头像url | |
| name | str | 昵称 | |
| is_followed | num | 0 | 作用尚不明确 |

10
article/articles.md
View File

@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| id | num | 文集rlID | 必要 | |
| id | num | 文集rlid | 必要 | |
**json回复：**
@ -43,8 +43,8 @@
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | --------------- | ------------ |
| id | num | 文集rlID | |
| mid | num | 文集作者UID | |
| id | num | 文集rlid | |
| mid | num | 文集作者mid | |
| name | str | 文集名称 | |
| image_url | str | 文集封面图片url | |
| update_time | num | 文集更新时间 | 时间戳 |
@ -70,7 +70,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | -------------- | ------------------------------------------------------------ |
| id | num | 专栏cvID | |
| id | num | 专栏cvid | |
| title | str | 文章标题 | |
| state | num | 0 | 作用尚不明确 |
| publish_time | num | 发布时间 | 秒时间戳 |
@ -99,7 +99,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | -------------- | ---- |
| mid | num | 作者UID | |
| mid | num | 作者mid | |
| name | str | 作者昵称 | |
| face | str | 作者头像url | |
| official_verify | obj | 作者认证信息 | |

8
article/info.md
View File

@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| id | num | 专栏cvID | 必要 | |
| id | num | 专栏cvid | 必要 | |
**json回复：**
@ -40,7 +40,7 @@
| stats | obj | 状态数信息 | |
| title | str | 文章标题 | |
| banner_url | str | 文章头图url | |
| mid | num | 文章作者UID | |
| mid | num | 文章作者mid | |
| author_name | str | 文章作者昵称 | |
| is_author | bool | true | 作用尚不明确 |
| image_urls | array | 动态封面 | |
@ -49,8 +49,8 @@
| show_later_watch | bool | true | 作用尚不明确 |
| show_small_window | bool | true | 作用尚不明确 |
| in_list | bool | 是否收于文集 | false：否<br />true：是 |
| pre | num | 上一篇文章cvID | 无为0 |
| next | num | 下一篇文章cvID | 无为0 |
| pre | num | 上一篇文章cvid | 无为0 |
| next | num | 下一篇文章cvid | 无为0 |
| share_channels | array | 分享方式列表 | |
`stats`对象：

6
article/like_coin_fav.md
View File

@ -20,7 +20,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---------------------- |
| id | num | 文章cvID | 必要 | |
| id | num | 文章cvid | 必要 | |
| type | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
@ -73,7 +73,7 @@ curl 'http://api.bilibili.com/x/article/like' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------- | ------ | ------- |
| aid | num | 文章cvID | 必要 | |
| aid | num | 文章cvid | 必要 | |
| multiply | num | 投币数量 | 必要 | 上限为2 |
| avtype | num | 2 | 必要 | 必须为2 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
@ -138,7 +138,7 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---- |
| id | num | 文章cvID | 必要 | |
| id | num | 文章cvid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**

4
audio/coin&fav.md
View File

@ -19,7 +19,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | |
| sid | num | 音频auid | 必要 | |
**json回复：**
@ -68,7 +68,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/songs-col
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | |
| sid | num | 音频auid | 必要 | |
**json回复：**

30
audio/info.md
View File

@ -19,7 +19,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | |
| sid | num | 音频auid | 必要 | |
**json回复：**
@ -35,8 +35,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ------ | ------------------ | ------------------ |
| id | num | 音频auID | |
| uid | num | UP主UID | |
| id | num | 音频auid | |
| uid | num | UP主mid | |
| uname | str | UP主昵称 | |
| author | str | 作者名 | |
| title | str | 歌曲标题 | |
@ -47,9 +47,9 @@
| duration | num | 歌曲时间长度 | 单位为秒 |
| passtime | num | 歌曲发布时间 | 时间戳 |
| curtime | num | 当前请求时间 | 时间戳 |
| aid | num | 关联稿件avID | 无为0 |
| bvid | str | 关联稿件bvID | 无为空 |
| cid | num | 关联视频CID | 无为0 |
| aid | num | 关联稿件avid | 无为0 |
| bvid | str | 关联稿件bvid | 无为空 |
| cid | num | 关联视频cid | 无为0 |
| msid | num | 0 | **作用尚不明确** |
| attr | num | 0 | **作用尚不明确** |
| limit | num | 0 | **作用尚不明确** |
@ -58,14 +58,14 @@
| ctime | null | - | **作用尚不明确** |
| statistic | obj | 状态数 | |
| vipInfo | obj | UP主会员状态 | |
| collectIds | array | 歌曲所在的收藏夹ID | 需要登录(SESSDATA) |
| collectIds | array | 歌曲所在的收藏夹mlid | 需要登录(SESSDATA) |
| coin_num | num | 投币数 | |
`data`中的`statistic`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---- |
| sid | num | 音频auID | |
| sid | num | 音频auid | |
| play | num | 播放次数 | |
| collect | num | 收藏数 | |
| comment | num | 评论数 | |
@ -84,8 +84,8 @@
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------------- | ---- |
| 0 | num | 第1个所在的收藏夹ID | |
| n | num | 第（n+1）个所在的收藏夹ID | |
| 0 | num | 第1个所在的收藏夹mlid | |
| n | num | 第（n+1）个所在的收藏夹mlid | |
| …… | num | …… | …… |
**示例：**
@ -160,7 +160,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/song/info' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | |
| sid | num | 音频auid | 必要 | |
**json回复：**
@ -186,7 +186,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/song/info' \
| ------- | ---- | ---------- | ---------------- |
| type | str | song | **作用尚不明确** |
| subtype | num | ？？？ | **作用尚不明确** |
| key | num | TAG ID？？ | **作用尚不明确** |
| key | num | TAG id？？ | **作用尚不明确** |
| info | str | TAG名 | |
**示例：**
@ -258,7 +258,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/tag/song' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | |
| sid | num | 音频auid | 必要 | |
**json回复：**
@ -299,7 +299,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/tag/song' \
| --------- | ---- | ---------- | ---------------- |
| mid | num | 0 | **作用尚不明确** |
| name | str | 成员名 | |
| member_id | num | 成员ID？？ | **作用尚不明确** |
| member_id | num | 成员id？？ | **作用尚不明确** |
**示例：**
@ -396,7 +396,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/member/song' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | |
| sid | num | 音频auid | 必要 | |
**json回复：**

32
audio/music_list.md
View File

@ -47,16 +47,16 @@
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | ---- |
| 0 | obj | 音频收藏夹ID1 | |
| n | obj | 音频收藏夹ID(n+1) | |
| 0 | obj | 音频收藏夹mlid1 | |
| n | obj | 音频收藏夹mlid(n+1) | |
| …… | obj | …… | …… |
`data`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | ------------------------ | -------------------------------- |
| id | num | 音频收藏夹ID | |
| uid | num | 创建用户UID | |
| id | num | 音频收藏夹mlid | |
| uid | num | 创建用户mid | |
| uname | str | 创建用户昵称 | |
| title | str | 歌单标题 | |
| type | num | 收藏夹属性 | 0：普通收藏夹<br />1：默认收藏夹 |
@ -66,22 +66,22 @@
| song | num | 歌单中的音乐数量 | |
| desc | str | 歌单备注信息 | |
| sids | array | 歌单中的音乐 | |
| menuId | num | 音频收藏夹对应的歌单amID | |
| menuId | num | 音频收藏夹对应的歌单amid | |
| statistic | obj | 歌单状态数信息 | |
`data`中的`sids`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------- | ---------------- |
| 0 | num | 收藏的音频auID1 | |
| n | num | 收藏的音频auID(n+1) | 按照歌单顺序排列 |
| 0 | num | 收藏的音频auid1 | |
| n | num | 收藏的音频auid(n+1) | 按照歌单顺序排列 |
| …… | num | …… | …… |
`data`中的`statistic`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------------------ | ---- |
| sid | num | 音频收藏夹对应的歌单amID | |
| sid | num | 音频收藏夹对应的歌单amid | |
| play | num | 播放次数 | |
| collect | num | 点赞次数 | |
| comment | null | - | |
@ -188,7 +188,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ------------------ |
| sid | num | 音频收藏夹ID | 必要 | 必须为默认收藏夹ID |
| sid | num | 音频收藏夹mlid | 必要 | 必须为默认收藏夹mlid |
**json回复：**
@ -204,8 +204,8 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | ------------------------ | ---------------------- |
| id | num | 音频收藏夹ID | |
| uid | num | 创建用户UID | |
| id | num | 音频收藏夹mlid | |
| uid | num | 创建用户mid | |
| uname | str | 创建用户昵称 | |
| title | str | 默认歌单 | 恒为`默认歌单` |
| type | num | 1 | 恒为`1` |
@ -215,22 +215,22 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \
| song | num | 歌单中的音乐数量 | |
| desc | str | 空 | 恒为空 |
| sids | array | 歌单中的音乐 | |
| menuId | num | 音频收藏夹对应的歌单amID | 与普通歌单不同通用 |
| menuId | num | 音频收藏夹对应的歌单amid | 与普通歌单不同通用 |
| statistic | obj | 歌单状态数信息 | |
`data`中的`sids`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------- | ---------------- |
| 0 | num | 收藏的音频auID1 | |
| n | num | 收藏的音频auID(n+1) | 按照歌单顺序排列 |
| 0 | num | 收藏的音频auid1 | |
| n | num | 收藏的音频auid(n+1) | 按照歌单顺序排列 |
| …… | num | …… | …… |
`data`中的`statistic`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------------------ | ---- |
| sid | num | 音频收藏夹对应的歌单amID | |
| sid | num | 音频收藏夹对应的歌单amid | |
| play | num | 0 | |
| collect | num | 0 | |
| comment | null | - | |
@ -238,7 +238,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \
**示例：**
查询我的默认歌单，ID为` 15967839 `
查询我的默认歌单，id为` 15967839 `
```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/info' \

10
audio/musicstream_url.md
View File

@ -31,7 +31,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | |
| sid | num | 音频auid | 必要 | |
**json回复：**
@ -47,7 +47,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | --------- | --------------------------------------- |
| sid | num | 音频auID | |
| sid | num | 音频auid | |
| type | num | 音质标识 | -1：试听片段（192K）<br />1：192K |
| info | str | 空 | **作用尚不明确** |
| timeout | num | 有效时长 | 单位为秒<br />一般为3h |
@ -115,10 +115,10 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/url' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| songid | num | 音频auID | 必要 | |
| songid | num | 音频auid | 必要 | |
| quality | num | 音质代码 | 必要 | **详情见上表** |
| privilege | num | 必须为`2` | 必要 | |
| mid | num | 当前用户UID | 必要 | 可为任意值 |
| mid | num | 当前用户mid | 必要 | 可为任意值 |
| platform | str | 平台标识 | 必要 | 可为任意值 |
**json回复：**
@ -135,7 +135,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/url' \
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | ----------- | ------------------------------------------------------------ |
| sid | num | 音频auID | |
| sid | num | 音频auid | |
| type | num | 音质标识 | -1：试听片段（192K）<br />0：128K<br />1：192K<br />2：320K<br />3：FLAC |
| info | str | 空 | **作用尚不明确** |
| timeout | num | 有效时长 | 单位为秒<br />一般为3h |

4
audio/status_number.md
View File

@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | |
| sid | num | 音频auid | 必要 | |
**json回复：**
@ -32,7 +32,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---- |
| sid | num | 音频auID | |
| sid | num | 音频auid | |
| play | num | 播放次数 | |
| collect | num | 收藏数 | |
| comment | num | 评论数 | |

42
bangumi/info.md
View File

@ -1,11 +1,11 @@
# 剧集基本信息
- [剧集基本信息（mdID方式）](#剧集基本信息（mdID方式）)
- [获取剧集明细（web端）（ssID/epID方式）](#获取剧集明细（web端）（ssID/epID方式）)
- [剧集基本信息（mdid方式）](#剧集基本信息（mdid方式）)
- [获取剧集明细（web端）（ssid/epid方式）](#获取剧集明细（web端）（ssid/epid方式）)
---
## 剧集基本信息（mdID方式）
## 剧集基本信息（mdid方式）
> http://api.bilibili.com/pgc/review/user
@ -18,7 +18,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | -------- | ------ | ---- |
| media_id | str | 剧集mdID | 必要 | |
| media_id | str | 剧集mdid | 必要 | |
**json回复：**
@ -43,10 +43,10 @@
| --------- | ----- | -------------- | -------------------------- |
| areas | array | 地区 | |
| cover | str | 封面图片url | |
| media_id | num | 剧集mdID | |
| media_id | num | 剧集mdid | |
| new_ep | obj | 最新一话信息 | |
| rating | obj | 评分信息 | |
| season_id | int | 剧集ssID | |
| season_id | int | 剧集ssid | |
| share_url | url | 剧集详情页连接 | |
| title | str | 标题 | |
| type_name | str | 剧集类型 | `番剧`、`国创`、`电影`等等 |
@ -70,7 +70,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------- | -------------------------- |
| id | int | 最新一话的epID | |
| id | int | 最新一话的epid | |
| index | str | 最新一话名称 | |
| index_show | str | 最新一话显示名称 | eg. `第1话`、`更新至第4话` |
@ -139,7 +139,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
</details>
## 获取剧集明细（web端）（ssID/epID方式）
## 获取剧集明细（web端）（ssid/epid方式）
> http://api.bilibili.com/pgc/view/web/season
@ -149,8 +149,8 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------- | ------------ | ------------------------ |
| season_id | num | 番剧ssID | 必要（可选） | season_id与ep_id任选其一 |
| ep_id | num | 剧集epID | 必要（可选） | season_id与ep_id任选其一 |
| season_id | num | 番剧ssid | 必要（可选） | season_id与ep_id任选其一 |
| ep_id | num | 剧集epid | 必要（可选） | season_id与ep_id任选其一 |
**json回复：**
@ -175,7 +175,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| evaluate | str | 简介 | |
| jp_title | str | 空 | 作用尚不明确 |
| link | str | 简介页面url | |
| media_id | num | 剧集mdID | |
| media_id | num | 剧集mdid | |
| mode | num | 2 | 作用尚不明确 |
| new_ep | obj | 更新信息 | |
| payment | obj | 会员&付费信息 | 若无相关内容则无此项 |
@ -184,7 +184,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| rating | obj | 评分信息 | 若无相关内容则无此项 |
| record | str | 备案号 | 无则为空 |
| rights | obj | 属性标志信息 | |
| season_id | num | 番剧ssID | |
| season_id | num | 番剧ssid | |
| season_title | str | 剧集标题 | |
| seasons | array | 同系列所以季信息 | |
| section | array | 花絮、PV、番外等非正片内容 | 若无相关内容则无此项 |
@ -222,16 +222,16 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | --------------------------------- | -------------------- |
| aid | num | 单集稿件avID | |
| aid | num | 单集稿件avid | |
| badge | str | 标签文字 | 例如`会员`、`限免`等 |
| badge_info | obj | | |
| badge_type | num | | |
| bvid | str | 单集稿件bvID | |
| cid | num | 视频CID | |
| bvid | str | 单集稿件bvid | |
| cid | num | 视频cid | |
| cover | str | 单集封面url | |
| dimension | obj | 分辨率信息 | |
| from | str | | |
| id | num | 单集epID | |
| id | num | 单集epid | |
| link | str | 单集网页url | |
| long_title | str | 单集完整标题 | |
| pub_time | num | 发布时间 | 时间戳 |
@ -244,7 +244,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| status | num | | |
| subtitle | str | 单集副标题 | 观看次数文字 |
| title | str | 单集标题 | |
| vid | str | 单集vID | vupload_+{CID} |
| vid | str | 单集vid | vupload_+{cid} |
@ -257,7 +257,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | ---------------- |
| desc | str | 更新备注 | |
| id | num | 最新一话epID | |
| id | num | 最新一话epid | |
| is_new | num | 是否最新发布 | 0：否<br />1：是 |
| title | str | 最新一话标题 | |
@ -365,7 +365,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| ---------- | ----- | -------- | ---- |
| episode_id | num | 0 | |
| episodes | array | 板块内容 | |
| id | num | 板块ID？ | |
| id | num | 板块id？ | |
| title | str | 板块标题 | |
| type | num | ？ | |
@ -383,7 +383,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------ | ---- |
| series_id | num | 系列ID | |
| series_id | num | 系列id | |
| series_title | str | 系列名 | |
`result`中的`show`对象：
@ -411,7 +411,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| avatar | str | 头像图片url | |
| follower | num | 粉丝数 | |
| is_follow | num | 0 | |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
| pendant | obj | | |
| theme_type | num | 0 | |
| uname | str | UP主昵称 | |

14
blackroom/banlist.md
View File

@ -95,10 +95,10 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | --------------- | ---------------------------- |
| id | num | 封禁公示ID | |
| id | num | 封禁公示id | |
| uname | str | 对象用户名 | |
| face | str | 对象用户头像url | |
| uid | num | 对象用户UID | |
| uid | num | 对象用户mid | |
| originTitle | str | 来源标题 | |
| blockedRemark | str | | |
| originUrl | str | 来源url | |
@ -117,7 +117,7 @@
| reasonType | num | 违规类型 | **见上表** |
| reasonTypeName | str | 违规类型名称 | |
| operatorName | str | 空 | 作用尚不明确 |
| caseId | num | 仲裁信息ID | 系统封禁时固定为0 |
| caseId | num | 仲裁信息id | 系统封禁时固定为0 |
| ctime | num | 创建时间 | 时间戳 |
| commentSum | num | 该条目评论数 | |
@ -210,7 +210,7 @@ curl -G 'http://api.bilibili.com/x/credit/blocked/list' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ---- |
| id | num | 封禁公示ID | 必要 | |
| id | num | 封禁公示id | 必要 | |
**json回复：**
@ -227,10 +227,10 @@ curl -G 'http://api.bilibili.com/x/credit/blocked/list' \
| 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | --------------- | ---------------------------- |
| id | num | 封禁公示ID | |
| id | num | 封禁公示id | |
| uname | str | 对象用户名 | |
| face | str | 对象用户头像url | |
| uid | num | 对象用户UID | |
| uid | num | 对象用户mid | |
| originTitle | str | 来源标题 | |
| blockedRemark | str | | |
| originUrl | str | 来源url | |
@ -255,7 +255,7 @@ curl -G 'http://api.bilibili.com/x/credit/blocked/list' \
**示例：**
查询公示ID为`1091621`的公示详情
查询公示id为`1091621`的公示详情
```shell
curl -G 'http://api.bilibili.com/x/credit/blocked/info' \

4
blackroom/jury/action.md
View File

@ -96,7 +96,7 @@ curl 'http://api.bilibili.com/x/credit/jury/apply' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---------- | ---- |
| id | num | 仲裁案件ID | |
| id | num | 仲裁案件id | |
**示例：**
@ -143,7 +143,7 @@ curl 'http://api.bilibili.com/x/credit/jury/caseObtain' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | ------------------------ | -------------- | --------------------------------------- |
| cid | num | 案件ID | 必要 | |
| cid | num | 案件id | 必要 | |
| vote | num | 投票类型 | 必要 | 见「[众裁信息](judgement_info.md)」中表 |
| content | str | 理由 | 非必要 | 见「[众裁信息](judgement_info.md)」中表 |
| likes | nums | 支持的观点 | 非必要 | |

26
blackroom/jury/judgement_info.md
View File

@ -32,7 +32,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ------------ | ------ | ------------- | ------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| cid | num | 案件ID | 必要 | |
| cid | num | 案件id | 必要 | |
**json回复：**
@ -49,8 +49,8 @@
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | -------- | ------------ |
| id | num | 案件ID | |
| mid | num | 被举报用户UID | |
| id | num | 案件id | |
| mid | num | 被举报用户mid | |
| status | num | 裁决状态 | 1：投票中<br />2：停止发放<br />3：复核中（结案中）<br />4：已裁决<br />5：待重启<br />6：未裁决<br />7：冻结中<br />8：队列中 |
| statusTitle | str | 封禁时间文字 | `judgeType`=1时有效 |
| originType | num | 来源类型 | 见「封禁公示」中表 |
@ -70,7 +70,7 @@
| ctime | num | 举报创建时间 | 时间戳 |
| mtime | num | 开始拉取时间 | 时间戳 |
| originTitle | str | 来源标题 | |
| relationId | str | 违规关系标识字 | ｛评论rpID｝-｛违规类型ID｝-｛来源对象ID｝ |
| relationId | str | 违规关系标识字 | {评论rpid}-{违规类型id}-{来源对象id} |
| face | str | 被举报用户头像url | |
| uname | str | 被举报用户昵称 | |
| vote | num | 我的投票 | **见上表** |
@ -149,7 +149,7 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------ | ------ | ---- |
| cid | num | 案件ID | 必要 | |
| cid | num | 案件id | 必要 | |
**json回复：**
@ -166,8 +166,8 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ----------------- | ------------------------------------------------------------ |
| id | num | 案件ID | |
| mid | num | 被举报用户UID | |
| id | num | 案件id | |
| mid | num | 被举报用户mid | |
| status | num | 裁决状态 | 1：投票中<br />2：停止发放<br />3：复核中（结案中）<br />4：已裁决<br />5：待重启<br />6：未裁决<br />7：冻结中<br />8：队列中 |
| originType | num | 来源类型 | 见「封禁公示」中表 |
| reasonType | num | 原因类型 | 见「封禁公示」中表 |
@ -185,7 +185,7 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
| ctime | num | 举报创建时间 | 时间戳 |
| mtime | num | 开始拉取时间 | 时间戳 |
| originTitle | str | 来源标题 | |
| relationId | str | 违规关系标识字 | ｛评论rpID｝-｛违规类型ID｝-｛来源对象ID｝ |
| relationId | str | 违规关系标识字 | {评论rpid}-{违规类型id}-{来源对象id} |
| face | str | 被举报用户头像url | |
| uname | str | 被举报用户昵称 | |
| vote | num | 0 | 固定为0 |
@ -278,8 +278,8 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ----------------- | ------------------------------------------------------------ |
| id | num | 案件ID | |
| mid | num | 被举报用户UID | |
| id | num | 案件id | |
| mid | num | 被举报用户mid | |
| status | num | 裁决状态 | 1：投票中<br />2：停止发放<br />3：复核中（结案中）<br />4：已裁决<br />5：待重启<br />6：未裁决<br />7：冻结中<br />8：队列中 |
| originType | num | 来源类型 | 见「封禁公示」中表 |
| reasonType | num | 原因类型 | 见「封禁公示」中表 |
@ -298,7 +298,7 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
| ctime | num | 举报创建时间 | 时间戳 |
| mtime | num | 开始拉取时间 | 时间戳 |
| originTitle | str | 来源标题 | |
| relationId | str | 违规关系标识字 | ｛评论rpID｝-｛违规类型ID｝-｛来源对象ID｝ |
| relationId | str | 违规关系标识字 | {评论rpid}-{违规类型id}-{来源对象id} |
| face | str | 被举报用户头像url | |
| uname | str | 被举报用户昵称 | |
| vote | num | 我的投票 | **见上表** |
@ -413,10 +413,10 @@ curl -G 'http://api.bilibili.com/x/credit/jury/caseList' \
| 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | -------- | ------------ |
| mid | num | 用户UID | 仅非匿名有此项 |
| mid | num | 用户mid | 仅非匿名有此项 |
| face | str | 用户头像 | 仅非匿名有此项 |
| name | str | 用户昵称 | 仅非匿名有此项 |
| opid | num | 观点ID | |
| opid | num | 观点id | |
| vote | num | 投票选择 | **见上表** |
| content | str | 观点内容 | |
| attr | num | 是否匿名 | 0：匿名<br />1：不匿名 |

6
broadcast/video_room.md
View File

@ -16,7 +16,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ------ | -------- | ------------------------------ |
| room_id | str | 目标视频 | `video://{稿件avID}/{视频CID}` |
| room_id | str | 目标视频 | `video://{稿件avid}/{视频cid}` |
| platform | str | 平台标识 | 默认为`web` |
| accepts | array | 操作标识 | |
@ -29,7 +29,7 @@
**示例：**
发送视频`av706`（1P的CID为` 3724723 `）的认证包
发送视频`av706`（1P的cid为` 3724723 `）的认证包
```
00000000 00 00 00 55 00 12 00 01 00 00 00 07 00 00 00 01 |...U............|
@ -105,7 +105,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------ | ------------------------------ |
| online | num | 实时观看人数 | |
| room_id | str | 目标视频 | `video://{稿件avID}/{视频CID}` |
| room_id | str | 目标视频 | `video://{稿件avid}/{视频cid}` |
**示例：**

34
cheese/info.md
View File

@ -5,17 +5,17 @@
---
课程ssID与epID和番剧不互通
课程ssid与epid和番剧不互通
课程avID与普通视频绝大部分api接口不能互通，少部分互通接口如下：
课程avid与普通视频绝大部分api接口不能互通，少部分互通接口如下：
1. 获取视频简介
2. 查询视频状态数
3. 查询分P列表
4. 视频快照
5. 获取弹幕（使用CID）
5. 获取弹幕（使用cid）
6. 发送弹幕
7. 高能进度条（使用CID）
7. 高能进度条（使用cid）
## 获取课程基本信息
@ -31,8 +31,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------- | ------------ | -------------------------------------------------- |
| season_id | num | 课程ssID | 必要（可选） | season_id与ep_id任选其一<br />**与番剧ssID不互通** |
| ep_id | num | 课程epID | 必要（可选） | season_id与ep_id任选其一<br />**与番剧epID不互通** |
| season_id | num | 课程ssid | 必要（可选） | season_id与ep_id任选其一<br />**与番剧ssid不互通** |
| ep_id | num | 课程epid | 必要（可选） | season_id与ep_id任选其一<br />**与番剧epid不互通** |
**json回复：**
@ -63,7 +63,7 @@
| release_info | str | 更新状态文字+更新连载状态文字 | |
| release_info2 | str | 更新连载状态文字 | |
| release_status | str | 更新状态文字 | |
| season_id | num | 课程ssID | **与番剧ssID不互通** |
| season_id | num | 课程ssid | **与番剧ssid不互通** |
| share_url | str | 页面url | |
| short_link | str | bilibili uri链接 | |
| stat | obj | 播放数信息 | |
@ -129,11 +129,11 @@
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------------------------------------------ |
| aid | num | 课程分集avID | **与普通稿件avID部分不互通** |
| cid | num | 课程分集CID | **与普通视频CID部分不互通** |
| aid | num | 课程分集avid | **与普通稿件avid部分不互通** |
| cid | num | 课程分集cid | **与普通视频cid部分不互通** |
| duration | num | 课程分集时间长度 | 单位为秒 |
| from | str | pugv | |
| id | num | 课程分集epID | **与番剧epID不互通** |
| id | num | 课程分集epid | **与番剧epid不互通** |
| index | num | 课程分集数 | |
| page | num | 1 | |
| play | num | 课程分集播放量 | |
@ -240,7 +240,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------------ | -------- |
| last_ep_id | num | 最后观看的epID | |
| last_ep_id | num | 最后观看的epid | |
| last_ep_index | str | 最后观看的标题 | |
| last_time | num | 最后观看的时间进度 | 单位为秒 |
@ -248,7 +248,7 @@
查询课程`ss61`或分集`ep790`的信息
ssID方式：
ssid方式：
```shell
curl -G 'http://api.bilibili.com/pugv/view/web/season' \
@ -257,7 +257,7 @@ curl -G 'http://api.bilibili.com/pugv/view/web/season' \
-e 'https://www.bilibili.com'
```
epID方式：
epid方式：
```shell
curl -G 'http://api.bilibili.com/pugv/view/web/season' \
@ -478,7 +478,7 @@ curl -G 'http://api.bilibili.com/pugv/view/web/season' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------- | ------ | -------------------- |
| season_id | num | 课程ssID | 必要 | **与番剧ssID不互通** |
| season_id | num | 课程ssid | 必要 | **与番剧ssid不互通** |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 |
@ -511,11 +511,11 @@ curl -G 'http://api.bilibili.com/pugv/view/web/season' \
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------------------------------------------ |
| aid | num | 课程分集avID | **与普通稿件avID部分不互通** |
| cid | num | 课程分集CID | **与普通视频CID部分不互通** |
| aid | num | 课程分集avid | **与普通稿件avid部分不互通** |
| cid | num | 课程分集cid | **与普通视频cid部分不互通** |
| duration | num | 课程分集时间长度 | 单位为秒 |
| from | str | pugv | |
| id | num | 课程分集epID | **与番剧epID不互通** |
| id | num | 课程分集epid | **与番剧epid不互通** |
| index | num | 课程分集数 | |
| page | num | 1 | |
| play | num | 课程分集播放量 | |

8
cheese/videostream_url.md
View File

@ -23,9 +23,9 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | ------------------------------------------------------------ |
| avid | num | 课程avID | 必要 | |
| ep_id | num | 课程epID | 必要 | |
| cid | num | 视频CID | 必要 | |
| avid | num | 课程avid | 必要 | |
| ep_id | num | 课程epid | 必要 | |
| cid | num | 视频cid | 必要 | |
| qn | num | 视频清晰度选择 | 非必要 | 参考[qn定义](../video/videostream_url.md#qn视频清晰度标识) |
| fnver | num | 视频流版本 | 非必要 | 参考[fnver定义](../video/videostream_url.md#fnver视频流版本标识) |
| fnval | num | 视频流类型 | 非必要 | 参考[fnval定义](../video/videostream_url.md#fnval视频流格式标识) |
@ -120,7 +120,7 @@
**示例：**
获取课程`ep790`（CID=`132105993`，avID=`76973173`）的视频流url，清晰度为1080P60
获取课程`ep790`（cid=`132105993`，avid=`76973173`）的视频流url，清晰度为1080P60
```shell
curl -G 'http://api.bilibili.com/pugv/player/web/playurl' \

2
clientinfo/ip.md
View File

@ -32,7 +32,7 @@
| isp | str | 运营商名 | |
| latitude | num | 纬度 | |
| longitude | num | 经度 | |
| zone_id | num | ip数据库ID | |
| zone_id | num | ip数据库id | |
| country_code | num | 国家/地区代码 | |
**示例：**

52
comment/action.md
View File

@ -23,9 +23,9 @@
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根评论rpID | 非必要 | 二级评论以上使用 |
| parent | num | 父评论rpID | 非必要 | 二级评论同根评论ID<br />大于二级评论为要回复的评论ID |
| oid | num | 目标评论区id | 必要 | |
| root | num | 根评论rpid | 非必要 | 二级评论以上使用 |
| parent | num | 父评论rpid | 非必要 | 二级评论同根评论id<br />大于二级评论为要回复的评论id |
| message | str | 发送评论内容 | 必要 | 最大1000字符<br />表情使用表情转义符 |
| plat | num | 发送平台标识 | 非必要 | 1：web端<br />2：安卓客户端<br />3：ios客户端<br />4：wp客户端<br />默认为1 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -49,14 +49,14 @@
| success_toast | str | 状态文字 | |
| need_captcha | bool | false | 评论需要验证码(未证实) |
| url | str | 空 | **作用尚不明确** |
| rpid | num | 评论rpID | |
| rpid_str | str | 评论rpID | 字串格式 |
| dialog | num | 回复对方rpID | 若为一级评论则为0<br />若为二级评论则为该评论ID<br />大于二级评论为上一级评论ID |
| dialog_str | str | 回复对方rpID | 字串格式 |
| root | num | 根评论rpID | 若为一级评论则为0<br />大于一级评论则为根评论ID |
| root_str | str | 根评论rpID | 字串格式 |
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论ID<br />大于二级评论为上一级评论ID |
| parent_str | str | 回复父评论rpID | 字串格式 |
| rpid | num | 评论rpid | |
| rpid_str | str | 评论rpid | 字串格式 |
| dialog | num | 回复对方rpid | 若为一级评论则为0<br />若为二级评论则为该评论id<br />大于二级评论为上一级评论id |
| dialog_str | str | 回复对方rpid | 字串格式 |
| root | num | 根评论rpid | 若为一级评论则为0<br />大于一级评论则为根评论id |
| root_str | str | 根评论rpid | 字串格式 |
| parent | num | 回复父评论rpid | 若为一级评论则为0<br />若为二级评论则为根评论id<br />大于二级评论为上一级评论id |
| parent_str | str | 回复父评论rpid | 字串格式 |
| emote | obj | 表情转义符信息 | [对象定义见表](readme.md#评论条目对象) |
| reply | 有效时：obj<br />无效时：null | | [对象定义见表](readme.md#评论条目对象) |
@ -249,8 +249,8 @@ curl 'http://api.bilibili.com/x/v2/reply/add' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpid | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消赞<br />1：点赞 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -266,7 +266,7 @@ curl 'http://api.bilibili.com/x/v2/reply/add' \
**示例：**
点赞视频`av243322853`下评论`rpID=3039053308`
点赞视频`av243322853`下评论`rpid=3039053308`
```shell
curl 'http://api.bilibili.com/x/v2/reply/action' \
@ -307,8 +307,8 @@ curl 'http://api.bilibili.com/x/v2/reply/action' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpid | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消踩<br />1：点踩 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -324,7 +324,7 @@ curl 'http://api.bilibili.com/x/v2/reply/action' \
**示例：**
点踩视频`av243322853`下评论`rpID=3039053308`
点踩视频`av243322853`下评论`rpid=3039053308`
```shell
curl 'http://api.bilibili.com/x/v2/reply/hate' \
@ -365,8 +365,8 @@ curl 'http://api.bilibili.com/x/v2/reply/hate' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@ -381,7 +381,7 @@ curl 'http://api.bilibili.com/x/v2/reply/hate' \
**示例：**
删除`av243322853`下评论`rpID=3039053308`
删除`av243322853`下评论`rpid=3039053308`
```shell
curl 'http://api.bilibili.com/x/v2/reply/del' \
@ -421,8 +421,8 @@ curl 'http://api.bilibili.com/x/v2/reply/del' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpid | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消置顶<br />1：设为置顶 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -438,7 +438,7 @@ curl 'http://api.bilibili.com/x/v2/reply/del' \
**示例：**
置顶视频`av243322853`下评论`rpID=2940645593`
置顶视频`av243322853`下评论`rpid=2940645593`
```shell
curl 'http://api.bilibili.com/x/v2/reply/top' \
@ -477,8 +477,8 @@ curl 'http://api.bilibili.com/x/v2/reply/top' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| rpid | num | 目标评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpid | 必要 | |
| reason | num | 举报类型 | 必要 | **类型代码见下表** |
| content | str | 其他举报备注 | 非必要 | `reason=0`时有效 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -518,7 +518,7 @@ curl 'http://api.bilibili.com/x/v2/reply/top' \
**示例：**
举报视频` av752881391 `下评论`rpID=3062537442`，理由是`引战`
举报视频` av752881391 `下评论`rpid=3062537442`，理由是`引战`
```shell
curl 'http://api.bilibili.com/x/v2/reply/report' \

46
comment/list.md
View File

@ -23,7 +23,7 @@
| ---------- | ---- | -------------- | ----------- | -------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1：按点赞数<br />2：按回复数 |
| nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 |
| pn | num | 页码 | 非必要 | 默认为1 |
@ -102,7 +102,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | ---------- | -------------------------------------- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
| top | 有效时：obj<br />无效时：null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | 有效时：obj<br />无效时：null | 投票评论？ | |
@ -111,7 +111,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | --------------- | ---- |
| content | str | 公告正文 | |
| id | num | 公告ID | |
| id | num | 公告id | |
| link | str | 公告页面链接url | |
| title | str | 公告标题 | |
@ -2342,7 +2342,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \
| ---------- | ---- | -------------- | ----------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| mode | num | 排序方式 | 非必要 | 默认为0<br />0 3：仅按热度<br />1：按热度+按时间<br />2：仅按时间 |
| next | num | 评论页选择 | 非必要 | 按热度时：热度顺序页码（0为第一页）<br />按时间时：时间倒序楼层号<br />默认为0 |
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
@ -2442,14 +2442,14 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
`data`中的`notice`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | --------------- | ---- |
| content | str | 公告正文 | |
| id | num | 公告ID | |
| id | num | 公告id | |
| link | str | 公告页面链接url | |
| title | str | 公告标题 | |
@ -4724,8 +4724,8 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
| ---------- | ---- | ---------------- | ----------- | ---------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 目标一级评论rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| root | num | 目标一级评论rpid | 必要 | |
| pn | num | 二级评论页码 | 非必要 | 默认为1 |
| ps | num | 二级评论每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
@ -4750,7 +4750,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
| replies | array | 二级评论列表 | |
| root | obj | 根评论 | [对象定义见表](readme.md#评论条目对象) |
| show_bvid | bool | true | **作用尚不明确** |
| upper | obj | UP主UID | |
| upper | obj | UP主mid | |
`data`中的`page`对象：
@ -4785,11 +4785,11 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
**示例：**
获取视频`av2`下评论`rpID=476670`的二级评论，每页5项，查看第1页
获取视频`av2`下评论`rpid=476670`的二级评论，每页5项，查看第1页
```shell
curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
@ -5462,8 +5462,8 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
| ---------- | ---- | -------------- | ----------- | ---------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根回复rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| root | num | 根回复rpid | 必要 | |
| next | num | 评论页选择 | 非必要 | 第一页为0<br />默认为0<br />顺序楼层号 |
| ps | num | 每页项数 | 非必要 | 默认为0 |
@ -5488,7 +5488,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
| vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主UID | |
| upper | obj | UP主mid | |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
| root | obj | 根评论 | [对象定义见表](readme.md#评论条目对象) |
@ -5519,7 +5519,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
`data`中的`control`对象：
@ -5537,7 +5537,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
**示例：**
获取视频`av2`下评论`rpID=476670`的二级评论，每页5项，查看第1页
获取视频`av2`下评论`rpid=476670`的二级评论，每页5项，查看第1页
```shell
curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
@ -6219,9 +6219,9 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
| ---------- | ---- | -------------- | ----------- | ---------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | |
| root | num | 根回复rpID | 必要 | |
| dialog | num | 对话树根rpID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
| root | num | 根回复rpid | 必要 | |
| dialog | num | 对话树根rpid | 必要 | |
| size | num | 每页最大项数 | 必要 | |
**json回复：**
@ -6247,7 +6247,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
| vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主UID | |
| upper | obj | UP主mid | |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
@ -6290,7 +6290,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
`data`中的`control`对象：
@ -6308,7 +6308,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
**示例：**
获取视频`av201022189`下评论`rpID=3030790837`的对话`rpID=3030978856`，每页最大5项
获取视频`av201022189`下评论`rpid=3030790837`的对话`rpid=3030978856`，每页最大5项
```shell
curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor' \
@ -7087,7 +7087,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | -------------------------------------------- |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | |
| oid | num | 目标评论区id | 必要 | |
**json回复：**

58
comment/readme.md
View File

@ -17,40 +17,40 @@
| 代码 | 评论区类型 | oid的意义 |
| ---- | ----------------------- | ---------- |
| 1 | 视频稿件 | 稿件avID |
| 2 | 话题 | 话题ID |
| 4 | 活动 | 活动ID |
| 5 | 小视频 | 小视频ID |
| 6 | 小黑屋封禁信息 | 封禁公示ID |
| 7 | 公告信息 | 公告ID |
| 8 | 直播活动 | 直播间ID |
| 1 | 视频稿件 | 稿件avid |
| 2 | 话题 | 话题id |
| 4 | 活动 | 活动id |
| 5 | 小视频 | 小视频id |
| 6 | 小黑屋封禁信息 | 封禁公示id |
| 7 | 公告信息 | 公告id |
| 8 | 直播活动 | 直播间id |
| 9 | 活动稿件 | |
| 10 | 直播公告 | |
| 11 | 相簿（图片动态） | 相簿ID |
| 12 | 专栏 | 专栏cvID |
| 11 | 相簿（图片动态） | 相簿id |
| 12 | 专栏 | 专栏cvid |
| 13 | 票务 | |
| 14 | 音频 | 音频auID |
| 15 | 风纪委员会 | 众裁项目ID |
| 14 | 音频 | 音频auid |
| 15 | 风纪委员会 | 众裁项目id |
| 16 | 点评 | |
| 17 | 动态（纯文字动态&分享） | 动态ID |
| 17 | 动态（纯文字动态&分享） | 动态id |
| 18 | 播单 | |
| 19 | 音乐播单 | |
| 20 | 漫画 | |
| 21 | 漫画 | |
| 22 | 漫画 | 漫画mcID |
| 33 | 课程 | 课程epID |
| 22 | 漫画 | 漫画mcid |
| 33 | 课程 | 课程epid |
## 评论条目对象
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ |
| rpid | num | 评论rpID | |
| rpid | num | 评论rpid | |
| oid | num | 评论区对象id | |
| type | num | 评论区类型代码 | **类型代码见上表** |
| mid | num | 发送者UID | |
| root | num | 根评论rpID | 若为一级评论则为0<br />大于一级评论则为根评论ID |
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论rpID<br />大于二级评论为上一级评论rpID |
| dialog | num | 回复对方rpID | 若为一级评论则为0<br />若为二级评论则为该评论rpID<br />大于二级评论为上一级评论rpID |
| mid | num | 发送者mid | |
| root | num | 根评论rpid | 若为一级评论则为0<br />大于一级评论则为根评论id |
| parent | num | 回复父评论rpid | 若为一级评论则为0<br />若为二级评论则为根评论rpid<br />大于二级评论为上一级评论rpid |
| dialog | num | 回复对方rpid | 若为一级评论则为0<br />若为二级评论则为该评论rpid<br />大于二级评论为上一级评论rpid |
| count | num | 二级评论条数 | |
| rcount | num | 回复评论条数 | |
| floor | num | 评论楼层号 | **注：若不支持楼层则无此项** |
@ -58,9 +58,9 @@
| fansgrade | num | 是否具有粉丝标签 | 0：无<br />1：有 |
| attr | num | 某属性位？ | **作用尚不明确** |
| ctime | num | 评论发送时间 | 时间戳 |
| rpid_str | str | 评论rpID | 字串格式 |
| root_str | str | 根评论rpID | 字串格式 |
| parent_str | str | 回复父评论rpID | 字串格式 |
| rpid_str | str | 评论rpid | 字串格式 |
| root_str | str | 根评论rpid | 字串格式 |
| parent_str | str | 回复父评论rpid | 字串格式 |
| like | num | 评论获赞数 | |
| action | num | 当前用户操作状态 | 需要登录(Cookie或APP) <br />否则恒为0<br />0：无<br />1：已点赞<br />2：已点踩 |
| member | obj | 评论发送者信息 | |
@ -75,7 +75,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ----------------------------- | ---------------------- | ------------------------------------------------------------ |
| mid | str | 发送者UID | |
| mid | str | 发送者mid | |
| uname | str | 发送者昵称 | |
| sex | str | 发送者性别 | 男 女 保密 |
| sign | str | 发送者签名 | |
@ -155,8 +155,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | -------------------- |
| uid | num | 用户UID | |
| medal_id | num | 粉丝标签ID | **详细说明有待补充** |
| uid | num | 用户mid | |
| medal_id | num | 粉丝标签id | **详细说明有待补充** |
| medal_name | str | 粉丝标签名 | |
| score | num | 0 | **作用尚不明确** |
| level | num | 当前标签等级 | |
@ -176,7 +176,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------- | ------------------------------------- |
| id | num | 头像框ID | |
| id | num | 头像框id | |
| name | str | 头像框名称 | |
| image | str | 头像框图片url | |
| jump_url | str | 空 | |
@ -186,7 +186,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ----------------------- | ------------------------------------- |
| id | num | 评论条目装扮ID | |
| id | num | 评论条目装扮id | |
| name | str | 评论条目装扮名称 | |
| image | str | 评论条目装扮图片url | |
| jump_url | str | 评论条目装扮商城页面url | |
@ -234,8 +234,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | -------------------------------------------------------- |
| id | num | 表情ID | |
| package_id | num | 表情包ID | |
| id | num | 表情id | |
| package_id | num | 表情包id | |
| state | num | 0 | |
| type | num | 表情类型 | 1：免费<br />2：会员专属<br />3：购买所得<br />4：颜文字 |
| attr | num | 0 | **作用尚不明确** |

2
creativecenter/railgun.md
View File

@ -31,7 +31,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ----------- | ---------------- |
| mid | num | 当前用户UID | |
| mid | num | 当前用户mid | |
| state | num | 电磁力等级 | |
| reason | str | 空 | **作用尚不明确** |

4
creativecenter/statistics&data.md
View File

@ -503,8 +503,8 @@ curl -G 'http://member.bilibili.com/x/web/data/article/thirty' \
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------- | ------------ |
| aid | num | 稿件avID | |
| bvid | str | 稿件bvID | |
| aid | num | 稿件avid | |
| bvid | str | 稿件bvid | |
| daytime | num | 统计时间 | 时间戳 |
| incr | num | 稿件增长情况数 | |
| interactive | num | 0 | 作用尚不明确 |

90
danmaku/action.md
View File

@ -31,10 +31,10 @@
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 弹幕类选择 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | |
| 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 |
@ -59,13 +59,13 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ------------ |
| action | str | 空 | 作用尚不明确 |
| dmid | num | 弹幕dmID | |
| dmid_str | str | 弹幕dmID | 字串形式 |
| dmid | num | 弹幕dmid | |
| dmid_str | str | 弹幕dmid | 字串形式 |
| visible | bool | true | 作用尚不明确 |
**示例：**
为视频`av2`/`BV1xx411c7mD`（CID为`62131`）的5000ms位置发送一条弹幕`前来考古`（颜色为#FFFFFF，字号25，普通弹幕，游动弹幕）
为视频`av2`/`BV1xx411c7mD`（cid为`62131`）的5000ms位置发送一条弹幕`前来考古`（颜色为#FFFFFF，字号25，普通弹幕，游动弹幕）
```shell
curl 'http://api.bilibili.com/x/v2/dm/post' \
@ -124,12 +124,12 @@ 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 | 必要 | |
| cid | num | 视频CID | 必要 | |
| aid | num | 稿件avid | 必要 | |
| cid | num | 视频cid | 必要 | |
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
| plat | num | 平台标识 | 必要 | 1：web端<br />2：安卓端<br />8：视频管理页面 |
| data | str | json序列 | 必要 | |
| dmid | num | 修改互动弹幕的弹幕ID | 非必要 | 注：修改弹幕`plat`必须为8 |
| dmid | num | 修改互动弹幕的弹幕id | 非必要 | 注：修改弹幕`plat`必须为8 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
`data`参数json序列：
@ -145,7 +145,7 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | ---- |
| msg | str | 弹幕内容 | |
| bvid | str | 关联视频的bvID | |
| bvid | str | 关联视频的bvid | |
类型为【视频内嵌引导关注按钮】时：
@ -161,7 +161,7 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-500：服务器错误<br />36711：该视频禁止发送弹幕<br />79026：发送失败，请勿填写当前稿件BVID<br />79024：发送失败，请输入正确的BVID<br />79036：该指令弹幕超出限制<br />79037：关注弹幕坐标溢出 |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />-500：服务器错误<br />36711：该视频禁止发送弹幕<br />79026：发送失败，请勿填写当前稿件bvid<br />79024：发送失败，请输入正确的bvid<br />79036：该指令弹幕超出限制<br />79037：关注弹幕坐标溢出 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 信息本体 | |
@ -173,10 +173,10 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \
| command | str | 指令？ | UP主头像弹幕：#UP#<br />关联视频弹幕：#LINK#<br />视频内嵌引导关注按钮：#ATTENTION# |
| content | str | 弹幕内容 | |
| extra | str | 弹幕数据 | json序列 |
| id | num | 弹幕dmID | |
| idStr | str | 弹幕dmID | 字串形式 |
| mid | num | 用户UID | |
| oid | num | 视频CID | |
| id | num | 弹幕dmid | |
| idStr | str | 弹幕dmid | 字串形式 |
| mid | num | 用户mid | |
| oid | num | 视频cid | |
| progress | num | 弹幕出现在视频内的时间 | |
| type | num | 互动弹幕类型 | 1：UP主头像弹幕<br />2：关联视频弹幕<br />5：视频内嵌引导关注按钮 |
@ -192,9 +192,9 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------- | ---- |
| aid | num | 关联视频的avID | |
| aid | num | 关联视频的avid | |
| title | str | 关联视频的标题 | |
| bvid | str | 关联视频的bvID | |
| bvid | str | 关联视频的bvid | |
类型为【视频内嵌引导关注按钮】时：
@ -208,7 +208,7 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \
**示例：**
为视频`av201947622`（CID为`230709860`）的5000ms位置发送一条UP主头像弹幕`test`
为视频`av201947622`（cid为`230709860`）的5000ms位置发送一条UP主头像弹幕`test`
```shell
curl 'http://api.bilibili.com/x/v2/dm/command/post' \
@ -245,7 +245,7 @@ curl 'http://api.bilibili.com/x/v2/dm/command/post' \
</details>
为视频`av201947622`（CID为`230709860`）的5000ms位置发送一条发送关联视频弹幕`测试1234`关联视频为`BV1kz4y1X7XP`
为视频`av201947622`（cid为`230709860`）的5000ms位置发送一条发送关联视频弹幕`测试1234`关联视频为`BV1kz4y1X7XP`
```shell
curl 'http://api.bilibili.com/x/v2/dm/command/post' \
@ -284,7 +284,7 @@ curl 'http://api.bilibili.com/x/v2/dm/command/post' \
</details>
为视频`av201947622`（CID为`230709860`）的5000ms位置发送视频内嵌引导关注按钮，X坐标为118，Y坐标为82，持续时间为5000ms
为视频`av201947622`（cid为`230709860`）的5000ms位置发送视频内嵌引导关注按钮，X坐标为118，Y坐标为82，持续时间为5000ms
```shell
curl 'http://api.bilibili.com/x/v2/dm/command/post' \
@ -337,8 +337,8 @@ curl 'http://api.bilibili.com/x/v2/dm/command/post' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| dmid | num | 弹幕dmID | 必要 | |
| cid | num | 视频CID | 必要 | |
| dmid | num | 弹幕dmid | 必要 | |
| cid | num | 视频cid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@ -353,7 +353,7 @@ curl 'http://api.bilibili.com/x/v2/dm/command/post' \
**示例：**
撤回`CID=168901231`下的弹幕`32310301474947077`的弹幕
撤回`cid=168901231`下的弹幕`32310301474947077`的弹幕
```shell
curl 'http://api.bilibili.com/x/dm/recall' \
@ -391,7 +391,7 @@ curl 'http://api.bilibili.com/x/dm/recall' \
| ---------- | ---- | ------------------------ | -------------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| mode | str | sp | 必要 | |
| cid | num | 视频CID | 必要 | |
| cid | num | 视频cid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@ -406,7 +406,7 @@ curl 'http://api.bilibili.com/x/dm/recall' \
示例：
购买视频CID为`168901231`的高级弹幕发送权限
购买视频cid为`168901231`的高级弹幕发送权限
```shell
curl 'http://api.bilibili.com/x/dm/adv/buy' \
@ -442,7 +442,7 @@ curl 'http://api.bilibili.com/x/dm/adv/buy' \
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| mode | str | sp | 必要 | |
| cid | num | 视频CID | 必要 | |
| cid | num | 视频cid | 必要 | |
**json回复：**
@ -466,7 +466,7 @@ curl 'http://api.bilibili.com/x/dm/adv/buy' \
**示例：**
查询视频CID为`168901231`的视频高级弹幕权限购买状态
查询视频cid为`168901231`的视频高级弹幕权限购买状态
当前状态为已购买且同意
@ -508,8 +508,8 @@ curl -G 'http://api.bilibili.com/x/dm/adv/state' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| oid | num | 视频CID | 必要 | |
| ids | nums | 弹幕dmID列表 | 必要 | 多个ID之间用`,`分隔 |
| oid | num | 视频cid | 必要 | |
| ids | nums | 弹幕dmid列表 | 必要 | 多个id之间用`,`分隔 |
**json回复**
@ -526,20 +526,20 @@ curl -G 'http://api.bilibili.com/x/dm/adv/state' \
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ---------------- | --------------------------------- |
| {弹幕ID} | obj | 弹幕id对应的信息 | id分别对应请求参数中的`ids`，下同 |
| {弹幕id} | obj | 弹幕id对应的信息 | id分别对应请求参数中的`ids`，下同 |
| …… | obj | 弹幕id对应的信息 | |
`{弹幕ID}`对象：
`{弹幕id}`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | -------- | ------------------------------------------------------------ |
| likes | num | 点赞数 | |
| user_like | num | 是否点赞 | 0：未点赞<br />1：已点赞<br />需要登录(Cookie或APP) <br />未登录恒为0 |
| id_str | str | 弹幕dmID | |
| id_str | str | 弹幕dmid | |
**示例**
查询`CID=236871317`下的弹幕`35600074482384899`、`38880975220375559`、`39052528418553863`点赞数
查询`cid=236871317`下的弹幕`35600074482384899`、`38880975220375559`、`39052528418553863`点赞数
```shell
curl -G 'http://api.bilibili.com/x/v2/dm/thumbup/stats' \
@ -591,8 +591,8 @@ curl -G 'http://api.bilibili.com/x/v2/dm/thumbup/stats' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| dmid | num | 弹幕dmID | 必要 | |
| oid | num | 视频CID | 必要 | |
| dmid | num | 弹幕dmid | 必要 | |
| oid | num | 视频cid | 必要 | |
| op | num | 操作 | 必要 | 1：点赞<br />2：取消点赞 |
| platform | str | 平台 | 非必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -609,7 +609,7 @@ curl -G 'http://api.bilibili.com/x/v2/dm/thumbup/stats' \
**示例**
为`CID=145928946`下的弹幕`35600074482384899`点赞
为`cid=145928946`下的弹幕`35600074482384899`点赞
```shell
curl 'http://api.bilibili.com/x/v2/dm/thumbup/add' \
@ -647,8 +647,8 @@ curl 'http://api.bilibili.com/x/v2/dm/thumbup/add' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------ |
| access_key | str | APP登录Token | APP方式必要 | |
| cid | num | 视频CID | 必要 | |
| dmid | num | 弹幕dmID | 必要 | |
| cid | num | 视频cid | 必要 | |
| dmid | num | 弹幕dmid | 必要 | |
| reason | num | 举报类型 | 必要 | **类型代码见下表** |
| content | str | 其他举报备注 | 非必要 | `reason=11`时有效 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -682,7 +682,7 @@ curl 'http://api.bilibili.com/x/v2/dm/thumbup/add' \
**示例**
举报`CID=145928946`下的弹幕`35600074482384899`，理由是`引战`
举报`cid=145928946`下的弹幕`35600074482384899`，理由是`引战`
```shell
curl 'http://api.bilibili.com/x/dm/report/add' \
@ -721,8 +721,8 @@ curl 'http://api.bilibili.com/x/dm/report/add' \
| ---------- | ---- | ------------------------ | -------------- | --------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 弹幕类选择 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | |
| dmids | nums | 弹幕dmID | 必要 | 多个ID之间用`,`分隔 |
| oid | num | 视频cid | 必要 | |
| dmids | nums | 弹幕dmid | 必要 | 多个id之间用`,`分隔 |
| state | num | 操作代码 | 必要 | 1：删除弹幕<br />2：弹幕保护<br />3：取消保护 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -738,7 +738,7 @@ curl 'http://api.bilibili.com/x/dm/report/add' \
**示例**
删除`CID=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531`
删除`cid=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531`
```shell
curl 'http://api.bilibili.com/x/v2/dm/edit/state' \
@ -779,8 +779,8 @@ curl 'http://api.bilibili.com/x/v2/dm/edit/state' \
| ---------- | ---- | ------------------------ | -------------- | -------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| type | num | 弹幕类选择 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | |
| dmids | nums | 弹幕dmID | 必要 | 多个ID之间用`,`分隔 |
| oid | num | 视频cid | 必要 | |
| dmids | nums | 弹幕dmid | 必要 | 多个id之间用`,`分隔 |
| pool | num | 操作代码 | 必要 | 0：移出字幕池<br />1：移入字幕池 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -796,7 +796,7 @@ curl 'http://api.bilibili.com/x/v2/dm/edit/state' \
**示例**
将`CID=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531`移入字幕池
将`cid=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531`移入字幕池
```shell
curl 'http://api.bilibili.com/x/v2/dm/edit/state' \

12
danmaku/danmaku_proto.md
View File

@ -31,8 +31,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | -------- | ------ | ----------- |
| type | num | 弹幕类 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | |
| pid | num | 稿件avID | 非必要 | |
| oid | num | 视频cid | 必要 | |
| pid | num | 稿件avid | 非必要 | |
| segment_index | num | 分包 | 必要 | 6分钟一包 |
**proto回复：**
@ -49,22 +49,22 @@ porto定义见：[bilibili.community.service.dm.v1.DmSegMobileReply](../grpc_api
| 名称 | 类型 | 含义 | 备注 |
| -------- | ------ | ------------------ | ------------------------------------------------------------ |
| id | int64 | 弹幕dmID | 唯一 可用于操作参数 |
| id | int64 | 弹幕dmid | 唯一 可用于操作参数 |
| progress | int32 | 视频内弹幕出现时间 | 毫秒 |
| mode | int32 | 弹幕类型 | 1 2 3：普通弹幕<br />4：底部弹幕<br />5：顶部弹幕<br />6：逆向弹幕<br />7：高级弹幕<br />8：代码弹幕<br />9：BAS弹幕（仅限于特殊弹幕专包） |
| fontsize | int32 | 弹幕字号 | 18：小<br />25：标准<br />36：大 |
| color | uint32 | 弹幕颜色 | 十进制RGB888值 |
| midHash | string | 发送者UID的HASH | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户ID |
| midHash | string | 发送者mid的HASH | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户id |
| content | string | 弹幕内容 | utf-8编码 |
| ctime | int64 | 弹幕发送时间 | 时间戳 |
| weight | int32 | 权重 | 用于智能屏蔽，根据弹幕语义及长度通过AI识别得出<br />范围：[0-10]<br />值越大权重越高 |
| action | string | 动作？ | 作用尚不明确 |
| pool | int32 | 弹幕池 | 0：普通池<br />1：字幕池<br />2：特殊池（代码/BAS弹幕） |
| idStr | string | 弹幕dmID | 字串形式<br />唯一 可用于操作参数 |
| idStr | string | 弹幕dmid | 字串形式<br />唯一 可用于操作参数 |
**示例：**
获取视频`av810872(CID=1176840)`（炮姐）的实时弹幕分包1
获取视频`av810872(cid=1176840)`（炮姐）的实时弹幕分包1
**注：[proto定义](../grpc_api/bilibili/community/service/dm/v1/dm.proto)需要编译，`bilibili.community.service.dm.v1.dm_pb2`并非通过pypi安装**

38
danmaku/danmaku_view_proto.md
View File

@ -30,8 +30,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ----------- |
| type | num | 弹幕类 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | |
| pid | num | 稿件avID | 非必要 | |
| oid | num | 视频cid | 必要 | |
| pid | num | 稿件avid | 非必要 | |
**proto回复：**
@ -69,16 +69,16 @@
| 名称 | 类型 | 含义 | 备注 |
| -------- | ------ | ------------ | ------------------------------------------------------------ |
| id | int64 | 弹幕dmID | |
| oid | int64 | 视频CID | |
| mid | int64 | 发送者UID | |
| id | int64 | 弹幕dmid | |
| oid | int64 | 视频cid | |
| mid | int64 | 发送者mid | |
| command | string | 弹幕指令 | `#UP#`：UP主头像弹幕<br />`#LINK#`：关联视频弹幕<br />`#ATTENTION#`：视频内嵌引导关注按钮 |
| content | string | 弹幕文字 | |
| progress | int32 | 弹幕出现时间 | 单位为毫秒 |
| ctime | string | 创建时间？ | 此项为空 |
| mtime | string | 修改时间？ | 此项为空 |
| extra | string | 弹幕负载数据 | json序列字串 |
| idStr | string | 弹幕dmID | 字串形式 |
| idStr | string | 弹幕dmid | 字串形式 |
`extra`json序列：
@ -92,10 +92,10 @@
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------------- | ---- |
| aid | num | 关联视频的avID | |
| aid | num | 关联视频的avid | |
| title | str | 关联视频的标题 | |
| icon | str | 关联视频按钮图片url | |
| bvid | str | 关联视频的bvID | |
| bvid | str | 关联视频的bvid | |
类型为【视频内嵌引导关注按钮】时：
@ -154,16 +154,16 @@ message DanmakuFlagConfig {
// 互动弹幕条目
message CommandDm {
int64 id = 1; //弹幕dmID
int64 oid = 2; //视频CID
int64 mid = 3; //发送者UID
int64 id = 1; //弹幕dmid
int64 oid = 2; //视频cid
int64 mid = 3; //发送者mid
string command = 4; //弹幕指令
string content = 5; //弹幕文字
int32 progress = 6; //弹幕出现时间
string ctime = 7; //
string mtime = 8; //
string extra = 9; //弹幕负载数据
string idStr = 10; //弹幕dmID（字串形式）
string idStr = 10; //弹幕dmid（字串形式）
}
//弹幕个人配置
@ -206,7 +206,7 @@ message DmWebViewReply {
**示例：**
获取视频`av797164471(CID=236871317)`的弹幕元数据
获取视频`av797164471(cid=236871317)`的弹幕元数据
```shell
curl -G 'http://api.bilibili.com/x/v2/dm/web/view' \
@ -223,7 +223,7 @@ curl -G 'http://api.bilibili.com/x/v2/dm/web/view' \
### 获取互动弹幕
获取并显示视频`av797164471(CID=236871317)`的所有互动弹幕
获取并显示视频`av797164471(cid=236871317)`的所有互动弹幕
```python
import web_dmview_pb2
@ -241,8 +241,8 @@ print(f'互动弹幕数={len(target.commandDms)}')
for i in target.commandDms:
print(f'''\
---弹幕ID={i.id}
---视频CID={i.oid}
---发送者UID={i.mid}
---视频cid={i.oid}
---发送者mid={i.mid}
---弹幕指令={i.command}
---弹幕文字={i.content}
---弹幕出现时间={i.progress}
@ -256,8 +256,8 @@ for i in target.commandDms:
```
互动弹幕数=1
---弹幕ID=38469676112019463
---视频CID=236871317
---发送者UID=501183549
---视频cid=236871317
---发送者mid=501183549
---弹幕指令=#UP#
---弹幕文字=这个视频没有恰饭！别紧张！
---弹幕出现时间=157818
@ -269,7 +269,7 @@ for i in target.commandDms:
BAS弹幕（`pool=2` `mode=9`）只能从此包获取，代码弹幕（`pool=2` `mode=8`）也能从此包获取
获取并显示视频`av2(CID=62131)`的所有BAS（代码）弹幕专包
获取并显示视频`av2(cid=62131)`的所有BAS（代码）弹幕专包
```python
import web_dmview_pb2

10
danmaku/danmaku_xml.md
View File

@ -22,7 +22,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------- | ------ | ---- |
| oid | num | 视频CID | 必要 | |
| oid | num | 视频cid | 必要 | |
**示例：**
@ -46,7 +46,7 @@ curl -G 'http://api.bilibili.com/x/v1/dm/list.so' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------- | ------ | ---- |
| cid | num | 视频CID | 必要 | |
| cid | num | 视频cid | 必要 | |
**示例：**
@ -98,7 +98,7 @@ curl 'http://comment.bilibili.com/144541892.xml'
- 标签 i
- 标签 chatserver：chat.bilibili.com
- 标签 chatid：视频CID
- 标签 chatid：视频cid
- 标签 mission：0
- 标签 maxlimit：实时弹幕池最大容量
- 标签 state：弹幕状态（0：正常 1：弹幕已关闭）
@ -119,8 +119,8 @@ curl 'http://comment.bilibili.com/144541892.xml'
| 3 | 弹幕颜色 | int32 | 十进制RGB888值 |
| 4 | 弹幕发送时间 | int32 | 时间戳 |
| 5 | 弹幕池类型 | int32 | 0：普通池<br />1：字幕池<br />2：特殊池（代码/BAS弹幕） |
| 6 | 发送者UID的HASH | string | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户ID |
| 7 | 弹幕dmID | int64 | 唯一 可用于操作参数 |
| 6 | 发送者mid的HASH | string | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户id |
| 7 | 弹幕dmid | int64 | 唯一 可用于操作参数 |
```xml
<d p="490.19100,1,25,16777215,1584268892,0,a16fe0dd,29950852386521095">从结尾回来看这里，更感动了！</d>

10
danmaku/history.md
View File

@ -23,7 +23,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ------- |
| type | num | 1 | 必要 | |
| oid | num | 视频CID | 必要 | |
| oid | num | 视频cid | 必要 | |
| month | str | 查询目标年月 | 必要 | YYYY-MM |
**json回复：**
@ -120,7 +120,7 @@ curl -G 'http://api.bilibili.com/x/v2/dm/history/index' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ----------- |
| type | num | 弹幕类 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | |
| oid | num | 视频cid | 必要 | |
| date | str | 弹幕日期 | 必要 | YYYY-MM-DD |
**proto回复：**
@ -129,7 +129,7 @@ porto定义见：[bilibili.community.service.dm.v1.DmSegMobileReply](../grpc_api
详细说明见[protobuf弹幕](danmaku_proto.md)
获取视频`av84271171(CID=144541892)`2020-01-21的历史弹幕
获取视频`av84271171(cid=144541892)`2020-01-21的历史弹幕
**注：proto定义需要编译**
@ -192,12 +192,12 @@ idStr: "27532611677585408"
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---------- |
| type | num | 1 | 必要 | |
| oid | num | 视频CID | 必要 | |
| oid | num | 视频cid | 必要 | |
| date | str | 弹幕日期 | 必要 | YYYY-MM-DD |
**示例：**
获取视频`av84271171(CID=144541892)`2020-01-21的历史弹幕
获取视频`av84271171(cid=144541892)`2020-01-21的历史弹幕
```shell
curl -G 'http://api.bilibili.com/x/v2/dm/history' \

6
danmaku/snapshot.md
View File

@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | -------- | ------------------ | ------ | ---- |
| aid | num或str | 稿件avID或稿件bvID | 必要 | |
| aid | num或str | 稿件avid或稿件bvid | 必要 | |
**json回复：**
@ -42,14 +42,14 @@
获取视频`av43337021`/`BV1rb411m7gE`的弹幕快照，总计20条
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/v2/dm/ajax' \
--data-urlencode 'aid=43337021'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/v2/dm/ajax' \

2
dynamic/content.md
View File

@ -54,7 +54,7 @@
| face | str | 直播者头像 | |
| link | str | 直播链接 | |
| title | str | 直播标题 | |
| uid | num | 直播者ID | |
| uid | num | 直播者id | |
| uname | str | 直播者昵称 | |
**示例：**

4
dynamic/get_dynamic_detail.md
View File

@ -8,7 +8,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ---------- | ------ | -------- |
| dynamic_id | id | 动态ID | 必要 | |
| dynamic_id | id | 动态id | 必要 | |
**json回复：**
@ -73,7 +73,7 @@
**示例：**
获取`哔哩哔哩弹幕网`的动态ID为`507420325550127049`动态
获取`哔哩哔哩弹幕网`的动态id为`507420325550127049`动态
```shell
curl -G 'http://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/get_dynamic_detail' \

8
dynamic/tag_dynamics.md
View File

@ -14,7 +14,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ---------- | ------ | -------- |
| topic_name | str | 话题名称 | 必要（可选） | topic_id与topic_name任选一个 |
| topic_id | num | 话题ID | 必要（可选） | topic_id与topic_name任选一个 |
| topic_id | num | 话题id | 必要（可选） | topic_id与topic_name任选一个 |
| sortby | num | 排序方式 | 非必要 | 一般情况下带上参数2，在部分话题中使用可以排除热门部分|
| offset | num | 偏移值 | 非必要| 可用于偏移显示的动态列表（为`0`时获取不包含置顶及热门的最新动态） |
@ -55,7 +55,7 @@
**示例：**
获取话题`哔哩哔哩漫画`（话题ID`7539944`）的当前动态列表（包含置顶&热门）
获取话题`哔哩哔哩漫画`（话题id`7539944`）的当前动态列表（包含置顶&热门）
topic_name方式：
```shell
@ -3354,7 +3354,7 @@ curl -G 'http://api.vc.bilibili.com/topic_svr/v1/topic_svr/fetch_dynamics' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ---------- | ------ | -------- |
| topic_name | str | 话题名称 | 必要（可选） | topic_id与topic_name任选一个 |
| topic_id | num | 话题ID | 必要（可选） | topic_id与topic_name任选一个 |
| topic_id | num | 话题id | 必要（可选） | topic_id与topic_name任选一个 |
| offset_dynamic_id | num | 偏移值 | 必要| 可用于偏移显示的动态列表（为`0`时获取最新动态） |
**json回复：**
@ -3392,7 +3392,7 @@ curl -G 'http://api.vc.bilibili.com/topic_svr/v1/topic_svr/fetch_dynamics' \
**示例：**
获取话题`哔哩哔哩漫画`（话题ID`7539944`）的当前动态列表
获取话题`哔哩哔哩漫画`（话题id`7539944`）的当前动态列表
topic_name方式：
```shell

20
electric/Bcoin.md
View File

@ -27,9 +27,9 @@
| -------- | ---- | ------------------------ | ------ | ------------------------------------------------- |
| bp_num | num | 贝壳数量 | 必要 | 必须在20-99990之间 |
| is_bp_remains_prior | bool | 是否优先扣除B币余额 | 必要 | [true,false]，B币充电请选择true |
| up_mid | num | 充电对象用户UID | 必要 | |
| up_mid | num | 充电对象用户mid | 必要 | |
| otype | str | 充电来源 | 必要 | up：空间充电<br />archive：视频充电 |
| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户UID<br />视频充电：稿件avID |
| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户mid<br />视频充电：稿件avid |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@ -47,8 +47,8 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ----------- | ------------------------------------------------ |
| mid | num | 本用户UID | |
| up_mid | num | 目标用户UID | |
| mid | num | 本用户mid | |
| up_mid | num | 目标用户mid | |
| order_no | str | 留言token | 用于添加充电留言 |
| bp_num | num | 充电贝壳数 | |
| exp | num | 获得经验数 | |
@ -57,7 +57,7 @@
**示例：**
以空间的方式向用户`UID=293793435`充了2贝壳，得到2经验，留言token为`BPRG5CEC3VUPOOANA540`
以空间的方式向用户`mid=293793435`充了2贝壳，得到2经验，留言token为`BPRG5CEC3VUPOOANA540`
此时`data`.`status`=`4`
@ -188,9 +188,9 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------------ | ------ | ------------------------------------------------- |
| elec_num | num | 充电电池数量 | 必要 | 必须在20-99990之间 |
| up_mid | num | 充电对象用户UID | 必要 | |
| up_mid | num | 充电对象用户mid | 必要 | |
| otype | str | 充电来源 | 必要 | up：空间充电<br />archive：视频充电 |
| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户UID<br />视频充电：稿件avID |
| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户mid<br />视频充电：稿件avid |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@ -208,8 +208,8 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ----------- | ------------------------------------------------ |
| mid | num | 本用户UID | |
| up_mid | num | 目标用户UID | |
| mid | num | 本用户mid | |
| up_mid | num | 目标用户mid | |
| order_no | str | 留言token | 用于添加充电留言 |
| elec_num | num | 充电电池数 | |
| exp | num | 获得经验数 | |
@ -218,7 +218,7 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \
**示例：**
以空间的方式向用户`UID=293793435`充了20电池，得到2经验，留言token为`BPRG5CEC3VUPOOANA540`
以空间的方式向用户`mid=293793435`充了20电池，得到2经验，留言token为`BPRG5CEC3VUPOOANA540`
此时`data`.`status`=`4`

6
electric/WeChat&Alipay.md
View File

@ -33,10 +33,10 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| elec_num | num | 充电电池数量 | 必要 | 必须在20-99990之间<br />1-19区间视为充值B币 |
| up_mid | num | 充电对象用户UID | 必要 | |
| up_mid | num | 充电对象用户mid | 必要 | |
| is_bp_remains_prior | bool | 是否优先扣除B币 | 必要 | true：是<br />false：否<br />在B币不足时剩余的部分利用支付平台支付 |
| otype | str | 充电来源 | 必要 | up：空间充电<br />archive：视频充电 |
| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户UID<br />视频充电：稿件avID |
| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户mid<br />视频充电：稿件avid |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@ -122,7 +122,7 @@ curl 'http://api.bilibili.com/x/ugcpay/trade/elec/pay/qr_code/create' \
| -------- | ---- | ----------- | ------------------------------------------------------------ |
| qr_token | str | 扫码秘钥 | |
| order_no | str | 留言token | 未成功则无此项<br />用于添加充电留言 |
| mid | num | 当前用户UID | |
| mid | num | 当前用户mid | |
| status | num | 状态值 | 若秘钥错误则无此项<br />1：已支付<br />2：未扫描<br />3：未确认 |
**示例：**

26
electric/charge_list.md
View File

@ -15,7 +15,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -23,7 +23,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功 <br />500011：UID错误 |
| code | num | 返回值 | 0：成功 <br />500011：mid错误 |
| msg | str | 错误信息 | 正确时无此项 |
| data | obj | 数据本体 | |
@ -50,8 +50,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ---------------- |
| mid | num | 充电对象UID | |
| pay_mid | num | 充电用户UID | |
| mid | num | 充电对象mid | |
| pay_mid | num | 充电用户mid | |
| rank | num | 充电用户排名 | 取决于充电的多少 |
| uname | str | 充电用户昵称 | |
| avatar | str | 充电用户头像url | |
@ -70,7 +70,7 @@
**示例：**
查询用户`UID=53456`的充电公示列表
查询用户`mid=53456`的充电公示列表
```shell
curl -G 'http://elec.bilibili.com/api/query.rank.do' \
@ -152,9 +152,9 @@ curl -G 'http://elec.bilibili.com/api/query.rank.do' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------------ | ------------------ |
| mid | num | 目标用户UID | 必要 | |
| aid | num | 目标稿件avID | 必要（可选） | avID与bvID任选一个 |
| bvid | str | 目标稿件bvID | 必要（可选） | avID与bvID任选一个 |
| mid | num | 目标用户mid | 必要 | |
| aid | num | 目标稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 目标稿件bvid | 必要（可选） | avid与bvid任选一个 |
**json回复：**
@ -200,8 +200,8 @@ curl -G 'http://elec.bilibili.com/api/query.rank.do' \
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ---------------- |
| mid | num | 充电对象UID | |
| pay_mid | num | 充电用户UID | |
| mid | num | 充电对象mid | |
| pay_mid | num | 充电用户mid | |
| rank | num | 充电用户排名 | 取决于充电的多少 |
| uname | str | 充电用户昵称 | |
| avatar | str | 充电用户头像url | |
@ -220,9 +220,9 @@ curl -G 'http://elec.bilibili.com/api/query.rank.do' \
**示例：**
获取视频`av967773538`/` BV1up4y1y77i `，用户`UID=53456`的视频充电鸣谢名单
获取视频`av967773538`/` BV1up4y1y77i `，用户`mid=53456`的视频充电鸣谢名单
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/web-interface/elec/show' \
@ -230,7 +230,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/elec/show' \
--data-urlencode 'aid=967773538'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/web-interface/elec/show' \

8
emoji/action.md
View File

@ -19,7 +19,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | -------------------------------- |
| package_id | num | 表情包ID | 必要 | |
| package_id | num | 表情包id | 必要 | |
| business | str | 使用场景 | 必要 | reply：评论区<br />dynamic：动态 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
@ -35,7 +35,7 @@
**示例：**
添加ID为`25`的表情包，使用场景为评论区
添加id为`25`的表情包，使用场景为评论区
```shell
curl 'http://api.bilibili.com/x/emote/package/add' \
@ -70,7 +70,7 @@ curl 'http://api.bilibili.com/x/emote/package/add' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | -------------------------------- |
| package_id | num | 表情包ID | 必要 | |
| package_id | num | 表情包id | 必要 | |
| business | str | 使用场景 | 必要 | reply：评论区<br />dynamic：动态 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
@ -86,7 +86,7 @@ curl 'http://api.bilibili.com/x/emote/package/add' \
**示例：**
移除ID为`25`的表情包，使用场景为评论区
移除id为`25`的表情包，使用场景为评论区
```shell
curl 'http://api.bilibili.com/x/emote/package/remove' \

12
emoji/list.md
View File

@ -234,7 +234,7 @@ curl -G 'http://api.bilibili.com/x/emote/user/panel/web' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | -------- | ------ | -------------------------------- |
| business | str | 使用场景 | 必要 | reply：评论区<br />dynamic：动态 |
| ids | nums | 表情包ID | 必要 | |
| ids | nums | 表情包id | 必要 | |
**json回复：**
@ -263,7 +263,7 @@ curl -G 'http://api.bilibili.com/x/emote/user/panel/web' \
**示例：**
获取表情包ID为`93`的表情包明细
获取表情包id为`93`的表情包明细
```shell
curl -G 'http://api.bilibili.com/x/emote/package' \
@ -586,7 +586,7 @@ curl -G 'http://api.bilibili.com/x/emote/setting/panel' \
| 字段 | 类型 | 内容 | 备注 |
| ----- | ----- | ----------------- | -------------------------------------------------------- |
| id | num | 表情包ID | |
| id | num | 表情包id | |
| text | str | 表情包名称 | |
| url | str | 表情包标志图片url | |
| mtime | num | 创建时间 | 时间戳 |
@ -607,7 +607,7 @@ curl -G 'http://api.bilibili.com/x/emote/setting/panel' \
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | --------------- | ---------------- |
| size | num | 表情尺寸信息 | 1：小<br />2：大 |
| item_id | num | 购买物品ID | |
| item_id | num | 购买物品id | |
| item_url | num | 购买物品页面url | 无则无此项 |
`表情包对象`中的`emote`数组：
@ -622,8 +622,8 @@ curl -G 'http://api.bilibili.com/x/emote/setting/panel' \
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ----------- | -------------------------------------------------------- |
| id | num | 表情ID | |
| package_id | num | 表情包ID | |
| id | num | 表情id | |
| package_id | num | 表情包id | |
| text | str | 表情转义符 | 颜文字时为该字串 |
| url | str | 表情图片url | 颜文字时为该字串 |
| mtime | num | 创建时间 | 时间戳 |

18
fav/info.md
View File

@ -36,9 +36,9 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------------- | -------------------------------------------------- |
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者UID尾号2位 |
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 |
| fid | num | 收藏夹原始id | |
| mid | num | 创建者UID | |
| mid | num | 创建者mid | |
| attr | num | 属性位（？） | |
| title | str | 收藏夹标题 | |
| cover | str | 收藏夹封面图片url | |
@ -59,7 +59,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------- | ----------------------------------------------- |
| mid | num | 创建者UID | |
| mid | num | 创建者mid | |
| name | str | 创建者昵称 | |
| face | str | 创建者头像url | |
| followed | bool | 是否已关注创建者 | |
@ -77,7 +77,7 @@
**示例：**
查询收藏夹`ID=1052622027`的元数据
查询收藏夹`id=1052622027`的元数据
```shell
curl -G 'http://api.bilibili.com/x/v3/fav/folder/info' \
@ -145,7 +145,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/info' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ---------------------------------------- |
| up_mid | num | 目标用户UID | 必要 | |
| up_mid | num | 目标用户mid | 必要 | |
| type | num | 目标内容属性 | 非必要 | 默认为全部<br />0：全部<br />2：视频稿件 |
| rid | num | 目标内容id | 非必要 | 视频稿件：视频稿件avid |
@ -179,9 +179,9 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/info' \
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------------ | ------------------------------------------ |
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者UID尾号2位 |
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 |
| fid | num | 收藏夹原始id | |
| mid | num | 创建者UID | |
| mid | num | 创建者mid | |
| attr | num | 属性位（？） | |
| title | str | 收藏夹标题 | |
| fav_state | num | 目标id是否存在于该收藏夹 | 存在于该收藏夹：1<br />不存在于该收藏夹：0 |
@ -189,7 +189,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/info' \
**示例：**
查询用户`UID=509372`的所有创建收藏夹列表
查询用户`mid=509372`的所有创建收藏夹列表
```shell
curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \
@ -291,7 +291,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
| name | str | UP主昵称 | |
| face | str | UP主头像url | |

12
fav/list.md
View File

@ -49,9 +49,9 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------------- | -------------------------------------------------- |
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者UID尾号2位 |
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 |
| fid | num | 收藏夹原始id | |
| mid | num | 创建者UID | |
| mid | num | 创建者mid | |
| attr | num | 属性 | 0：正常<br />1：失效 |
| title | str | 收藏夹标题 | |
| cover | str | 收藏夹封面图片url | |
@ -72,7 +72,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------- | ----------------------------------------------- |
| mid | num | 创建者UID | |
| mid | num | 创建者mid | |
| name | str | 创建者昵称 | |
| face | str | 创建者头像url | |
| followed | bool | 是否已关注创建者 | |
@ -122,7 +122,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
| name | str | UP主昵称 | |
| face | str | UP主头像url | |
@ -136,7 +136,7 @@
**示例：**
查询收藏夹`ID=1052622027`，每页5个视频，第`1`页的内容明细
查询收藏夹`id=1052622027`，每页5个视频，第`1`页的内容明细
```shell
curl -G 'http://api.bilibili.com/x/v3/fav/resource/list' \
@ -377,7 +377,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/resource/list' \
**示例：**
查询收藏夹`ID=1052622027`的全部内容id
查询收藏夹`id=1052622027`的全部内容id
```shell
curl -G 'http://api.bilibili.com/x/v3/fav/resource/ids' \

4
garb/color.md
View File

@ -46,7 +46,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | ------------------------------- |
| id | num | 颜色ID | |
| id | num | 颜色id | |
| name | str | 颜色名称 | |
| is_free | bool | 是否免费 | false：收费<br />true：免费 |
| price | num | 价格 | 单位为硬币 |
@ -184,7 +184,7 @@ curl -G 'http://club.bilibili.com/api/query.skin.list.do' \
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | ------------------------------- |
| id | num | 颜色ID | |
| id | num | 颜色id | |
| name | str | 颜色名称 | |
| is_free | bool | 是否免费 | false：收费<br />true：免费 |
| price | num | 价格 | 单位为硬币 |

6
garb/skin.md
View File

@ -47,7 +47,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | --------------- | ------ |
| id | num | 装扮ID | |
| id | num | 装扮id | |
| name | str | 装扮名称 | |
| preview | str | 装扮封面url | |
| ver | num | 装扮版本 | 时间戳 |
@ -80,7 +80,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | ------------------------------- |
| id | num | 颜色ID | |
| id | num | 颜色id | |
| name | str | 颜色名称 | |
| is_free | bool | 是否免费 | false：收费<br />true：免费 |
| price | num | 价格 | 单位为硬币 |
@ -95,7 +95,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | --------------- | ------ |
| id | num | 装扮ID | |
| id | num | 装扮id | |
| name | str | 装扮名称 | |
| ver | num | 装扮版本 | 时间戳 |
| loading_url | str | 加载动画图标url | |

40
history&toview/history.md
View File

@ -23,8 +23,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------------------- | ------ | ------------------------------------------------------------ |
| 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：文章 |
| 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 |
@ -51,9 +51,9 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------------ | ------------------ |
| max | num | 最后一项目标ID | **详细内容见参数** |
| max | num | 最后一项目标id | **详细内容见参数** |
| view_at | num | 最后一项时间节点 | 时间戳 |
| business | str | 最后一项目标ID类型 | **详细内容见参数** |
| business | str | 最后一项目标id类型 | **详细内容见参数** |
| ps | num | 每页项数 | |
`data`中的`tab`数组：
@ -92,7 +92,7 @@
| videos | num | 视频分P数目 | 仅用于稿件视频 |
| author_name | str | UP主昵称 | |
| author_face | str | UP主头像url | |
| author_mid | num | UP主UID | |
| author_mid | num | UP主mid | |
| view_at | num | 查看时间 | 时间戳 |
| progress | num | 视频观看进度 | 单位为秒<br />用于稿件视频或剧集 |
| badge | str | 条目备注标识 | 用于稿件视频或剧集 |
@ -103,7 +103,7 @@
| new_desc | str | 最新一话/最新一P标识 | 用于稿件视频或剧集 |
| is_finish | num | 是否已完结 | 仅用于剧集<br />0：未完结<br />1：已完结 |
| is_fav | num | 是否收藏 | 0：未收藏<br />1：已收藏 |
| kid | num | 条目目标ID | **详细内容见参数** |
| kid | num | 条目目标id | **详细内容见参数** |
| tag_name | str | 子分区名 | 用于稿件视频和直播 |
| live_status | num | 直播状态 | 仅用于直播<br />0：未开播<br />1：已开播 |
@ -119,11 +119,11 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------------- | ------------------------------------------------------------ |
| 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 | 仅用于稿件视频 |
| 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 | 仅用于稿件视频 |
| page | num | 观看到的视频分P数 | 仅用于稿件视频 |
| cid | num | 观看到的对象ID | 稿件视频&剧集（当`business=archive`或`business=pgc`时）：视频CID<br />文集（当`business=article-list`时）：文章cvID |
| cid | num | 观看到的对象id | 稿件视频&剧集（当`business=archive`或`business=pgc`时）：视频cid<br />文集（当`business=article-list`时）：文章cvid |
| part | str | 观看到的视频分P标题 | 仅用于稿件视频 |
| business | str | 条目类型 | **详细内容见参数** |
| dt | num | 查看平台代码 | 1 3 5 7：手机端<br />2：web端<br />4 6：pad端<br />33：TV端<br />0：其他 |
@ -387,9 +387,9 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \
| 字段 | 类型 | 内容 | 备注 |
| ------------------------------- | ------- | ------------------------------ | ------------------------------------------------------------ |
| aid | num | 稿件avID | |
| aid | num | 稿件avid | |
| videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区tID | |
| tid | num | 分区tid | |
| tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1：原创<br />2：转载 |
| pic | str | 视频封面图片url | |
@ -404,7 +404,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \
| owner | obj | 视频UP主信息 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`owner`对象 |
| stat | obj | 视频状态数 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`stat`对象 |
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| cid | num | 视频1P CID | |
| cid | num | 视频1P cid | |
| dimension | obj | 视频1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 |
| bangumi | obj | 番剧/影视信息 | 非番剧/影视无此项 |
| cheese | obj | 课程信息 | 非课程无此项 |
@ -416,17 +416,17 @@ 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`数组中的对象`bangumi`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | --------------- | ------------ |
| cover | str | 番剧封面图片url | |
| ep_id | num | 番剧epID | |
| ep_id | num | 番剧epid | |
| episode_status | num | ？？？ | |
| follow | num | 0 | 作用尚不明确 |
| long_title | str | 单集标题 | |
@ -438,9 +438,9 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | ---------------------- |
| is_finish | num | 是否完结 | 0：连载中<br />1：完结 |
| newest_ep_id | num | 最细一话epID | |
| newest_ep_id | num | 最细一话epid | |
| newest_ep_index | str | 最细一话集数 | |
| season_id | num | 番剧ssID | |
| season_id | num | 番剧ssid | |
| season_status | num | ？？？ | |
| season_type | num | ？？？ | |
| title | str | 番剧标题 | |
@ -453,7 +453,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \
| cover | str | 课程封面图片url | |
| long_title | str | 完整标题 | |
| number | str | 本集数 | |
| season_id | num | 课程ssID | |
| season_id | num | 课程ssid | |
| update_info | str | 总集数 | |
**示例：**
@ -671,7 +671,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回复：**

24
history&toview/toview.md
View File

@ -24,8 +24,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回复：**
@ -42,7 +42,7 @@
添加视频`av41687433`/`BV1ht41147kj`到稍后再看列表
avID方式：
avid方式：
```shell
curl 'http://api.bilibili.com/x/v2/history/toview/add' \
@ -51,7 +51,7 @@ curl 'http://api.bilibili.com/x/v2/history/toview/add' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl 'http://api.bilibili.com/x/v2/history/toview/add' \
@ -91,8 +91,8 @@ curl 'http://api.bilibili.com/x/v2/history/toview/add' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 目标频道ID | 必要 | |
| mid | num | 目标频道所属的用户UID | 必要 | |
| cid | num | 目标频道id | 必要 | |
| mid | num | 目标频道所属的用户mid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@ -106,7 +106,7 @@ curl 'http://api.bilibili.com/x/v2/history/toview/add' \
**示例：**
添加用户`UID=282994`下的频道`4693`中所有视频到稍后再看
添加用户`mid=282994`下的频道`4693`中所有视频到稍后再看
```shell
curl 'http://space.bilibili.com/ajax/channel/addAllToView' \
@ -168,9 +168,9 @@ curl 'http://space.bilibili.com/ajax/channel/addAllToView' \
| 字段 | 类型 | 内容 | 备注 |
| ------------------------------- | ------- | ------------------------------ | ------------------------------------------------------------ |
| aid | num | 稿件avID | |
| aid | num | 稿件avid | |
| videos | num | 稿件分P总数 | 默认为1 |
| tid | num | 分区tID | |
| tid | num | 分区tid | |
| tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1：原创<br />2：转载 |
| pic | str | 稿件封面图片url | |
@ -187,10 +187,10 @@ curl 'http://space.bilibili.com/ajax/channel/addAllToView' \
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| dimension | obj | 稿件1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 |
| count | num | 稿件分P数 | 非投稿视频无此项 |
| cid | num | 视频CID | |
| cid | num | 视频cid | |
| progress | num | 观看进度时间 | 单位为秒 |
| add_at | num | 添加时间 | 时间戳 |
| bvid | str | 稿件bvID | |
| bvid | str | 稿件bvid | |
**示例：**
@ -363,7 +363,7 @@ curl 'http://api.bilibili.com/x/v2/history/toview' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| viewed | bool | 是否删除所有已观看的视频 | 非必要 | true：删除已观看视频<br />false：不删除已观看视频<br />默认为false |
| aid | num | 删除的目标记录的avID | 非必要 | |
| aid | num | 删除的目标记录的avid | 非必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**

22
live/info.md
View File

@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -40,13 +40,13 @@
| title | str | 直播间标题 | |
| cover | str | 直播间封面url | |
| online | num | 直播间人气 | 值为上次直播时刷新 |
| roomid | num | 直播间ID（短号） | |
| roomid | num | 直播间id（短号） | |
| broadcast_type | num | 0 | |
| online_hidden | num | 0 | |
**示例：**
查询用户`UID=322892`的直播间信息
查询用户`mid=322892`的直播间信息
```shell
curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \
@ -105,9 +105,9 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ------------- | ------------------------ |
| room_id | num | 直播间真实ID | |
| short_id | num | 直播间ID（短号） | |
| uid | num | 主播用户UID | |
| room_id | num | 直播间真实id | |
| short_id | num | 直播间id（短号） | |
| uid | num | 主播用户mid | |
| need_p2p | num | 是否p2p | |
| is_hidden | bool | 是否隐藏 | |
| is_locked | bool | 是否锁定 | |
@ -124,7 +124,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \
**示例：**
查询直播间`ID=76`的直播间信息
查询直播间`id=76`的直播间信息
```shell
curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \
@ -172,7 +172,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| uid | num | 目标用户UID | 必要 | |
| uid | num | 目标用户mid | 必要 | |
**json回复：**
@ -192,7 +192,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \
| info | obj | 主播信息 | |
| exp | obj | 经验等级 | |
| follower_num | num | 主播粉丝数 | |
| room_id | num | 直播间ID（短号） | |
| room_id | num | 直播间id（短号） | |
| medal_name | str | 粉丝勋章名 | |
| glory_count | int | 主播荣誉数 | |
| pendant | str | 直播间头像框url | |
@ -203,7 +203,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------- | ------------------------------ |
| uid | num | 主播UID | |
| uid | num | 主播mid | |
| uname | str | 主播用户名 | |
| face | str | 主播头像url | |
| official_verify | obj | 认证信息 | |
@ -254,7 +254,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \
**示例：**
查询直播间`UID=76`的主播信息
查询直播间`mid=76`的主播信息
```shell
curl -G 'http://api.live.bilibili.com/live_user/v1/Master/info' \

10
live/live_area.md
View File

@ -35,7 +35,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---------- | ---- |
| id | num | 父分区ID | |
| id | num | 父分区id | |
| name | name | 父分区名 | |
| list | list | 子分区列表 | |
@ -51,9 +51,9 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ----------------- | ---------------- |
| id | str | 子分区ID | |
| parent_id | str | 父分区ID | |
| old_area_id | str | 旧分区ID | |
| id | str | 子分区id | |
| parent_id | str | 父分区id | |
| old_area_id | str | 旧分区id | |
| name | str | 子分区名 | |
| act_id | str | 0 | **作用尚不明确** |
| pk_status | str | ？？？ | **作用尚不明确** |
@ -65,7 +65,7 @@
**示例：**
如想在`网游`父分区下的`英雄联盟`分区开播，则查到子分区ID为`86`
如想在`网游`父分区下的`英雄联盟`分区开播，则查到子分区id为`86`
```shell
curl 'http://api.live.bilibili.com/room/v1/Area/getList'

2
live/live_stream.md
View File

@ -84,7 +84,7 @@
**示例：**
查询直播间`CID=14073662`的直播间信息
查询直播间`cid=14073662`的直播间信息
```shell
curl -G 'http://api.live.bilibili.com/room/v1/Room/playUrl' \

10
live/manage.md
View File

@ -20,7 +20,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | -------------------- |
| room_id | num | 直播间ID | 必要 | 必须为自己的直播间ID |
| room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
| title | str | 直播间标题 | 必要 | 最大20字符 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
@ -77,8 +77,8 @@ curl 'http://api.live.bilibili.com/room/v1/Room/update' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------------ | ------ | ----------------------------------- |
| room_id | num | 直播间ID | 必要 | 必须为自己的直播间ID |
| area_v2 | num | 直播分区ID（子分区ID） | 必要 | 详见[直播分区](live_area.md) |
| room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
| area_v2 | num | 直播分区id（子分区id） | 必要 | 详见[直播分区](live_area.md) |
| platform | str | 直播平台 | 必要 | web端：<br />bililink：android_link |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
@ -144,7 +144,7 @@ curl 'http://api.live.bilibili.com/room/v1/Room/update' \
**示例：**
以`27`作为分区ID开播直播间`10352053`
以`27`作为分区id开播直播间`10352053`
其中`"data"."rtmp"."addr"`为推流地址
@ -216,7 +216,7 @@ curl 'http://api.live.bilibili.com/room/v1/Room/startLive' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | -------------------- |
| room_id | num | 直播间ID | 必要 | 必须为自己的直播间ID |
| room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**

4
live/message_stream.md
View File

@ -40,8 +40,8 @@ json格式
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ------------ | -------------- |
| uid | num | 用户UID | 不可为0 |
| roomid | num | 加入房间的ID | |
| uid | num | 用户mid | 不可为0 |
| roomid | num | 加入房间的id | |
| protover | num | 协议版本 | 现在是2 |
| platform | str | 平台标识 | 可为"web" |
| clientver | str | 客户端版本 | 现在是"1.10.3" |

10
login/login_action/QR.md
View File

@ -207,9 +207,9 @@ X-Cache-Webcdn: BYPASS from ks-sxhz-dx-w-01
https://passport.biligame.com/crossDomain?
DedeUserID=(登录UID)&
DedeUserID=(登录mid)&
DedeUserID__ckMd5=(登录UID MD5值)&
DedeUserID__ckMd5=(登录mid MD5值)&
Expires=(过期时间 秒)&
@ -236,7 +236,7 @@ gourl=(跳转网址 默认为主页)
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------- | ----------- | ------------------------ |
| appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` |
| local_id | str | TV端ID | TV端必要 | 可为0 |
| local_id | str | TV端id | TV端必要 | 可为0 |
| ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | APP方式必要 | |
@ -303,7 +303,7 @@ curl 'http://passport.bilibili.com/x/passport-tv-login/qrcode/auth_code' \
| --------- | ---- | ---------- | ----------- | ------------------------ |
| appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` |
| auth_code | str | 扫码秘钥 | 必要 | |
| local_id | str | TV端ID | TV端必要 | 可为0 |
| local_id | str | TV端id | TV端必要 | 可为0 |
| ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | APP方式必要 | |
@ -322,7 +322,7 @@ curl 'http://passport.bilibili.com/x/passport-tv-login/qrcode/auth_code' \
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | -------------------- |
| mid | num | 登录用户UID | |
| mid | num | 登录用户mid | |
| access_token | str | APP登录Token | |
| refresh_token | str | APP刷新Token | |
| expires_in | num | 有效时间 | 单位为秒 一般为30天 |

2
login/login_action/SMS.md
View File

@ -131,7 +131,7 @@ curl 'http://passport.bilibili.com/web/generic/country/list'
**示例：**
例如手机号为`13888888888`，国际ID为`1（中国大陆）`，登录秘钥为`aabbccdd`，极验challenge为`2333`，极验结果为`666666`，进行发送短信验证码操作
例如手机号为`13888888888`，国际id为`1（中国大陆）`，登录秘钥为`aabbccdd`，极验challenge为`2333`，极验结果为`666666`，进行发送短信验证码操作
```shell
curl 'http://passport.bilibili.com/web/sms/general/v2/send' \

6
login/login_action/password.md
View File

@ -183,7 +183,7 @@ YgpjxAQ22pKa9socHIKPCZX0a/NS6Ng9Zzy+rp16b0LJGT6RHw2ERs3+ijCpG96PKTY1Baavwf0xgotm
**需验证手机号或邮箱时**
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------------------ | ---------------- |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| tel | str | 绑定的手机号 | 星号隐藏部分信息 |
| email | str | 绑定的邮箱 | 星号隐藏部分信息 |
| sorce | num | 0 | **作用尚不明确** |
@ -252,9 +252,9 @@ X-Cache-Webcdn: BYPASS from jd-sxhz-dx-w-01
https://passport.biligame.com/crossDomain?
DedeUserID=(登录UID)&
DedeUserID=(登录mid)&
DedeUserID__ckMd5=(登录UID MD5值)&
DedeUserID__ckMd5=(登录mid MD5值)&
Expires=(过期时间 秒)&

4
login/login_action/readme.md
View File

@ -12,7 +12,7 @@
人机验证流程：
1. 请求验证码参数，得到登录密钥`key`与极验ID`gt`和极验KEY`challenge`
1. 请求验证码参数，得到登录密钥`key`与极验id`gt`和极验KEY`challenge`
2. 进行滑动or点击验证
3. 返回验证结果`validate`与`seccode`，进行短信或密码登录
@ -44,7 +44,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | -------- |
| success | num | 1 | **作用尚不明确** |
| gt | str | 极验ID | 一般为固定值 |
| gt | str | 极验id | 一般为固定值 |
| challenge | str | 极验KEY | 由B站后端产生用于人机验证 |
| key | str | 登录秘钥 | 与人机验证无关，与登录接口有关，但与极验KEY对应 |

6
login/login_info.md
View File

@ -37,7 +37,7 @@
| email_verified | num | 是否验证邮箱地址 | 0：未验证<br />1：已验证 |
| face | str | 用户头像url | |
| level_info | obj | 等级信息 | |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| mobile_verified | num | 是否验证手机号 | 0：未验证<br />1：已验证 |
| money | num | 拥有硬币数 | |
| moral | num | 当前节操值 | 上限为70 |
@ -106,7 +106,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------- | ------------ |
| mid | num | 登录用户UID | |
| mid | num | 登录用户mid | |
| bcoin_balance | num | 拥有B币数 | |
| coupon_balance | num | 每月奖励B币数 | |
| coupon_due_time | num | 0 | 作用尚不明确 |
@ -313,7 +313,7 @@ curl 'http://account.bilibili.com/home/userInfo' \
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ----------------------------- |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| name | str | 用户昵称 | |
| sign | str | 用户签名 | |
| coins | num | 拥有硬币数 | |

6
login/login_notice.md
View File

@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ------------------------------------------------------------ |
| mid | num | 用户UID | 必要 | |
| mid | num | 用户mid | 必要 | |
| buvid | str | 设备虚拟id | 非必要 | web端为操作登录接口时Cookie中的`buvid3`<br />若登录设备无`buvid`则留空 |
**json回复：**
@ -34,7 +34,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ----------- | -------------------------- |
| mid | num | 登录用户UID | |
| mid | num | 登录用户mid | |
| device_name | str | 登录设备 | 依靠操作登录接口时的UA决定 |
| login_type | str | 登录方式 | 根据登录接口决定 |
| login_time | str | 登录时间 | YYYY-MM-DD hh:mm:ss |
@ -43,7 +43,7 @@
**示例：**
查询用户`293793435`设备ID为`fuck_chenrui`的登录记录
查询用户`293793435`设备id为`fuck_chenrui`的登录记录
```shell
curl -G 'http://api.bilibili.com/x/safecenter/login_notice' \

4
login/member_center.md
View File

@ -41,7 +41,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | -------------- | --------------------------------------- |
| mid | num | 我的UID | |
| mid | num | 我的mid | |
| uname | str | 我的昵称 | |
| userid | str | 我的用户名 | |
| sign | str | 我的签名 | |
@ -213,7 +213,7 @@ curl 'http://www.bilibili.com/plus/account/exp.php' \
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---------------- | ------------------------------------------------------------ |
| mid | num | 我的UID | |
| mid | num | 我的mid | |
| vip_type | num | 大会员类型 | 0：无<br />1：月度<br />2：年度 |
| vip_status | num | 大会员状态 | 1：正常<br />2：由于IP地址更换过于频繁,服务被冻结<br />3：你的大会员账号风险过高，大会员功能已被锁定 |
| vip_due_date | num | 大会员到期时间 | 时间戳 毫秒 |

8
message/private_msg.md
View File

@ -71,8 +71,8 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------------ | ------------------------------------ | ------------------------ | ------ | -------------------------------------- |
| msg[sender_uid] | num | 发送者UID | 必要 | |
| msg[receiver_id] | num | 接收者UID | 必要 | |
| msg[sender_uid] | num | 发送者mid | 必要 | |
| msg[receiver_id] | num | 接收者mid | 必要 | |
| msg[receiver_type] | num | 1 | 必要 | 固定为1 |
| msg[msg_type] | num | 消息类型 | 必要 | 1:发送文字<br>2:发送图片<br>5:撤回消息 |
| msg[msg_status] | num | 0 | 非必要 | |
@ -148,7 +148,7 @@ const deviceid = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (functi
**示例：**
给目标用户`UID=1`发一条文字私信：
给目标用户`mid=1`发一条文字私信：
> up主你好，
>
@ -182,7 +182,7 @@ curl 'http://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
</details>
给目标用户`UID=1`发一条图片私信：
给目标用户`mid=1`发一条图片私信：
> <img src="https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" style="zoom:50%;" >

4
newbie_exam/info.md
View File

@ -28,7 +28,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---------------- | ------------------------------------------------------------ |
| hid | num | 答题会话id | |
| mid | num | 答题用户UID | |
| mid | num | 答题用户mid | |
| score | num | 当前得分 | |
| status | num | 答题状态 | 0：未答题<br />2：答题中<br />3：已通过 |
| number | num | 当前题号 | |
@ -322,7 +322,7 @@ curl -G 'http://api.bilibili.com/x/answer/v4/pro/type' \
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----- | ------------------ | ------ |
| hid | num | 答题会话id | |
| mid | num | 答题用户UID | |
| mid | num | 答题用户mid | |
| member | num | | |
| score | num | 得分 | |
| level | num | | |

10
note/action.md
View File

@ -17,8 +17,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| aid | num | 目标稿件avID | 必要 | |
| note_id | num | 笔记ID | 非必要 | 创建时无需此项 |
| aid | num | 目标稿件avid | 必要 | |
| note_id | num | 笔记id | 非必要 | 创建时无需此项 |
| title | str | 笔记标题 | 必要 | |
| summary | str | 笔记预览文本 | 必要 | |
| content | str | 笔记正文json序列 | 必要 | 格式见[附表](readme.md#附表-笔记正文序列格式) |
@ -42,7 +42,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------ | ---- |
| note_id | num | 笔记ID | |
| note_id | num | 笔记id | |
**示例：**
@ -90,8 +90,8 @@ curl 'http://api.bilibili.com/x/note/add' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | ---- |
| aid | num | 目标稿件avID | 必要 | |
| note_id | num | 笔记ID | 非必要 | |
| aid | num | 目标稿件avid | 必要 | |
| note_id | num | 笔记id | 非必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**

24
note/info.md
View File

@ -17,8 +17,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回复：**
@ -42,13 +42,13 @@
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---------------- |
| 0 | num | 笔记ID | |
| 0 | num | 笔记id | |
**示例：**
查询视频`av970322090`/`BV1op4y167Uo`的笔记ID
查询视频`av970322090`/`BV1op4y167Uo`的笔记id
avID方式：
avid方式：
```shell
curl 'http://api.bilibili.com/x/note/list/archive' \
@ -56,7 +56,7 @@ curl 'http://api.bilibili.com/x/note/list/archive' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl 'http://api.bilibili.com/x/note/list/archive' \
@ -94,9 +94,9 @@ curl 'http://api.bilibili.com/x/note/list/archive' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ---------- | ----------- | -------- |
| aid | num | 稿件avID | 必要（可选）| avID与bvID任选一个，不与笔记所属稿件avID相同不影响返回 |
| bvid | str | 稿件bvID | 必要（可选）| avID与bvID任选一个，不与笔记所属稿件bvID相同不影响返回 |
| note_id | num | 笔记ID | 必要 | |
| aid | num | 稿件avid | 必要（可选）| avid与bvid任选一个，不与笔记所属稿件avid相同不影响返回 |
| bvid | str | 稿件bvid | 必要（可选）| avid与bvid任选一个，不与笔记所属稿件bvid相同不影响返回 |
| note_id | num | 笔记id | 必要 | |
**json回复：**
@ -119,7 +119,7 @@ curl 'http://api.bilibili.com/x/note/list/archive' \
| tags | array | 笔记跳转标签列表 | |
| cid_count | num | 视频分P数 | |
| audit_status | num | 0 | 作用暂不明确 |
| aid | num | 稿件avID | |
| aid | num | 稿件avid | |
`data`中的`tags`数组：
@ -143,7 +143,7 @@ curl 'http://api.bilibili.com/x/note/list/archive' \
查询视频`av583785685`/`BV1kz4y1X7XP`中笔记`7165769906913287`的内容
avID方式：
avid方式：
```shell
curl 'http://api.bilibili.com/x/note/info' \
@ -152,7 +152,7 @@ curl 'http://api.bilibili.com/x/note/info' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl 'http://api.bilibili.com/x/note/info' \

6
note/list.md
View File

@ -52,15 +52,15 @@
| summary | str | 笔记预览文本 | |
| mtime | str | 提交时间 | |
| arc | obj | 视频信息 | |
| note_id | num | 笔记ID | |
| note_id | num | 笔记id | |
| audit_status | num | 0 | 作用尚不明确 |
`list`中的`arc`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | ---------------------- |
| aid | num | 稿件avID | |
| bvid | str | 稿件bvID | |
| aid | num | 稿件avid | |
| bvid | str | 稿件bvid | |
| pic | str | 稿件封面图片url | |
| desc | str | 视频简介 | |
| status | num | 0 | |

4
other/API_auth.md
View File

@ -15,8 +15,8 @@ Token有效期为1月，更改密码或过期失效
| cookie项 | 含义 | 备注 |
| ----------------- | ----------------- | ------------------------------------------ |
| DedeUserID | 当前用户UID | |
| DedeUserID__ckMd5 | 用户UID md5校验值 | |
| DedeUserID | 当前用户mid | |
| DedeUserID__ckMd5 | 用户mid md5校验值 | |
| SESSDATA | 登录Token | 用于用户识别与鉴权<br />作用同`access_key` |
| bili_jct | CSRF Token | 用于操作性接口 |

28
other/bvID.md → other/bvid_desc.md
View File

@ -1,6 +1,6 @@
# bvID说明
# bvid说明
2020-03-23 B站推出了全新的稿件视频ID“bvID”来接替之前的“avID”，其用法与性质等价于“avID”
2020-03-23 B站推出了全新的稿件视频id“bvid”来接替之前的“avid”，其用法与性质等价于“avid”
详见：
@ -9,23 +9,23 @@
## 格式：
“bvID”恒为长度为12的字符串，前两个字母为大写“BV”，后10个位base58计算结果
“bvid”恒为长度为12的字符串，前两个字母为大写“BV”，后10个位base58计算结果
## 实质：
“bvID"为“avID”的base58编码，可通过算法进行相互转化
“bvid"为“avid”的base58编码，可通过算法进行相互转化
## avID发放方式的变化：
## 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
从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算法：
注：本算法及示例程序仅能编码及解码avID<` 29460791296 `，无法验证avID>=` 29460791296 `的正确性
注：本算法及示例程序仅能编码及解码avid<` 29460791296 `，无法验证avid>=` 29460791296 `的正确性
1. a=(avID⊕177451812)+8728348608
1. a=(avid⊕177451812)+8728348608
2. 以i为循环变量循环6次b[i]=(a/58^i)%58
3. 将b[i]中各个数字转换为以下码表中的字符
@ -112,14 +112,12 @@ const unsigned long long add = 8728348608; //固定加法值
const int s[] = {11, 10, 3, 8, 4, 6}; //位置编码表
//初始化反查码表
void tr_init()
{
void tr_init() {
for (int i = 0; i < 58; i++)
tr[table[i]] = i;
}
unsigned long long bv2av(char bv[])
{
unsigned long long bv2av(char bv[]) {
unsigned long long r = 0;
unsigned long long av;
for (int i = 0; i < 6; i++)
@ -128,8 +126,7 @@ unsigned long long bv2av(char bv[])
return av;
}
char* av2bv(unsigned long long av)
{
char* av2bv(unsigned long long av) {
char* result = (char*)malloc(13);
strcpy(result,"BV1 4 1 7 ");
av = (av ^ Xor) + add;
@ -138,8 +135,7 @@ char* av2bv(unsigned long long av)
return result;
}
int main()
{
int main() {
tr_init();
printf("%s\n",av2bv(170001));
printf("%u\n",bv2av("BV17x411w7KC"));

4
ranking&dynamic/dynamic.md
View File

@ -16,7 +16,7 @@
| ------ | ---- | ----------- | ------ | ------- |
| pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为5 |
| rid | num | 目标分区tID | 必要 | |
| rid | num | 目标分区tid | 必要 | |
**json回复：**
@ -58,7 +58,7 @@
**示例：**
获取`tID=21`（生活->日常）分区中的2条最新动态视频信息
获取`tid=21`（生活->日常）分区中的2条最新动态视频信息
```shell
curl -G 'http://api.bilibili.com/x/web-interface/dynamic/region' \

4
ranking&dynamic/ranking.md
View File

@ -20,7 +20,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ------------------------------------- |
| day | num | 页码 | 非必要 | 3：三日榜<br />7：一周榜<br />默认为3 |
| rid | num | 目标分区tID | 必要 | |
| rid | num | 目标分区tid | 必要 | |
**json回复：**
@ -48,7 +48,7 @@
**示例：**
获取`tID=1`（动画）分区中的三日视频排行榜
获取`tid=1`（动画）分区中的三日视频排行榜
```shell
curl -G 'http://api.bilibili.com/x/web-interface/ranking/region' \

8
search/hot.md
View File

@ -28,13 +28,13 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | --------------- | -------------- |
| seid | str | 搜索seID | |
| id | num | 默认搜索ID | |
| seid | str | 搜索seid | |
| id | num | 默认搜索id | |
| type | num | 0 | |
| show_name | str | 显示文字 | |
| name | str | 空 | |
| goto_type | num | 跳转类型 | 1：视频 |
| goto_value | str | 搜索目标ID | 视频：稿件avID |
| goto_value | str | 搜索目标id | 视频：稿件avid |
| url | str | 搜索目标跳转url | |
**示例：**
@ -85,7 +85,7 @@ curl 'http://api.bilibili.com/x/web-interface/search/default'
| exp_str | str | ？？？ | |
| code | num | 返回值 | 0：成功 |
| cost | obj | 详细搜索用时 | 大概是吧？ |
| seid | str | 搜索seID | |
| seid | str | 搜索seid | |
| timestamp | num | 榜单统计时间 | 时间戳 |
| message | str | 错误信息 | 默认为success |
| list | array | 热搜列表 | |

4
search/search_request.md
View File

@ -600,7 +600,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/search/all/v2' \
| order_sort | num | 用户粉丝数及等级排序顺序 | 非必要 | 仅用于搜索用户<br />默认为0<br />由高到低：0<br/>由低到高：1 |
| user_type | num | 用户分类筛选 | 非必要 | 仅用于搜索用户<br />默认为0<br />全部用户：0<br/>up主：1<br/>普通用户：2<br/>认证用户：3 |
| duration | num | 视频时长筛选 | 非必要 | 仅用于搜索视频<br />默认为0<br />全部时长：0<br/>10分钟以下：1<br/>10-30分钟：2<br/>30-60分钟：3<br/>60分钟以上：4 |
| tids | num | 视频分区筛选 | 非必要 | 仅用于搜索视频<br />默认为0<br />全部分区：0<br/>筛选分区：目标分区tID |
| tids | num | 视频分区筛选 | 非必要 | 仅用于搜索视频<br />默认为0<br />全部分区：0<br/>筛选分区：目标分区tid |
| category_id | num | 专栏及相簿分区筛选 | 非必要 | 搜索结果为专栏时：<br />默认为0<br />全部分区：0<br/>动画：2<br/>游戏：1<br/>影视：28<br/>生活：3<br/>兴趣：29<br/>轻小说：16<br/>科技：17<br/>--------<br/>搜索结果为相簿时：<br />默认为0<br />全部分区：0<br/>画友：1<br/>摄影：2 |
| page | num | 页码 | 非必要 | 默认为1 |
@ -619,7 +619,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/search/all/v2' \
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---------------------------------------------------------- | ------------ | ------------------------------ |
| seid | num | 搜索seID | |
| seid | num | 搜索seid | |
| page | num | 当前页码 | |
| pagesize | num | 每页条数 | 固定20 |
| numResults | num | 总条数 | 最大值为1000 |

46
search/search_response.md
View File

@ -20,14 +20,14 @@
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ----- | -------------- | ----------------------------------------- |
| type | str | 结果类型 | 固定为video |
| id | num | 结果ID | 为稿件avID |
| id | num | 结果 | 为稿件avid |
| author | str | UP主昵称 | |
| mid | num | UP主UID | |
| typeid | str | 视频分区tID | |
| mid | num | UP主mid | |
| 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 | **作用尚不明确** |
@ -107,8 +107,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------------- | ------------------------------- | ---------------------------- | ------------------------------------------------------------ |
| type | str | 结果类型 | media_bangumi：番剧<br />media_ft：影视 |
| media_id | num | 剧集mdID | |
| season_id | num | 剧集ssID | |
| media_id | num | 剧集mdid | |
| season_id | num | 剧集ssid | |
| title | str | 剧集标题 | 关键字用xml标签`<em class="keyword">`标注 |
| org_title | str | 剧集原名 | 关键字用xml标签`<em class="keyword">`标注<br />可为空 |
| cover | str | 剧集封面url | |
@ -133,8 +133,8 @@
| angle_title | str | 角标内容 | |
| angle_color | num | 角标颜色 | 0：红色<br />2：橙色 |
| display_info | array | 剧集标志信息 | |
| hit_epids | str | 关键字匹配分集标题的分集epID | 多个用`,`分隔 |
| pgc_season_id | num | 剧集ssID | |
| hit_epids | str | 关键字匹配分集标题的分集epid | 多个用`,`分隔 |
| pgc_season_id | num | 剧集ssid | |
| season_type | num | 剧集类型 | 1：番剧<br />2：电影<br />3：纪录片<br />4：国创<br />5：电视剧<br />7：综艺 |
| season_type_name | str | 剧集类型文字 | |
| selection_style | str | 分集选择按钮风格 | horizontal：横排式<br />grid：按钮式 |
@ -192,7 +192,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | ------------- | ---- |
| id | num | 分集epID | |
| id | num | 分集epid | |
| cover | str | 分集封面url | |
| title | str | 完整标题 | |
| url | str | 分集重定向url | |
@ -337,7 +337,7 @@
| ----------- | ----- | -------------- | ----------------------------------------- |
| type | str | 结果类型 | 固定为live_room |
| rank_offset | num | 搜索结果排名值 | |
| uid | num | 主播UID | |
| uid | num | 主播mid | |
| tas | str | 直播间TAG | 多个用`,`分隔 |
| hit_columns | array | 关键字匹配类型 | |
| live_time | str | 开播时间 | YYYY-MM-DD HH:MM:SS |
@ -353,7 +353,7 @@
| online | num | 在线人数 | |
| rank_index | num | 0 | **作用尚不明确** |
| rank_score | num | 结果排序量化值 | |
| roomid | num | 直播间ID | |
| roomid | num | 直播间id | |
| attentions | num | 主播粉丝数 | |
`直播间条目`中的`hit_columns`数组：
@ -405,7 +405,7 @@
| ----------- | ----- | -------------- | ------------------------------------------------------ |
| type | str | 结果类型 | 固定为live_user |
| rank_offset | num | 搜索结果排名值 | |
| uid | num | 主播UID | |
| uid | num | 主播mid | |
| tas | str | 直播间TAG | 多个用`,`分隔 |
| live_time | str | 开播时间 | YYYY-MM-DD HH:MM:SS<br />如未开播为0000-00-00 00:00:00 |
| hit_columns | array | 关键字匹配类型 | |
@ -464,16 +464,16 @@
| pub_time | num | 投稿时间 | 时间戳 |
| like | num | 获赞数 | |
| title | str | 标题 | |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
| image_urls | array | 封面图组 | |
| template_id | num | ？？？ | **作用尚不明确** |
| category_id | num | 专栏分区ID | |
| category_id | num | 专栏分区 | |
| view | num | 阅读数 | |
| reply | num | 评论数 | |
| rank_index | num | 0 | **作用尚不明确** |
| desc | str | 文章预览 | |
| rank_score | num | 结果排序量化值 | |
| id | num | 专栏cvID | |
| id | num | 专栏cvid | |
| category_name | str | 子分区名 | |
`专栏条目`中的`covers`数组：
@ -532,7 +532,7 @@
| click | num | ？？？ | **作用尚不明确** |
| tp_type | num | ？？？ | **作用尚不明确** |
| keyword | str | 空 | **作用尚不明确** |
| tp_id | num | 话题tpID | |
| tp_id | num | 话题tp | |
| rank_index | num | 0 | **作用尚不明确** |
| author | str | UP主昵称 | |
| arcurl | str | 话题页面重定向url | |
@ -584,7 +584,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ----- | -------------- | ----------------------------- |
| type | str | 结果类型 | 固定为bili_user |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| uname | str | 用户昵称 | |
| usign | str | 用户签名 | |
| fans | num | 用户粉丝数 | |
@ -595,7 +595,7 @@
| gender | num | 用户性别 | 1：男<br />2：女<br />3：私密 |
| is_upuser | num | 是否为UP主 | 0：否<br />1：是 |
| is_live | num | 是否正在直播 | 0：否<br />1：是 |
| room_id | num | 用户直播间ID | |
| room_id | num | 用户直播间id | |
| res | array | 用户投稿内容 | |
| official_verify | obj | 用户认证信息 | |
| hit_columns | array | 关键字匹配类型 | |
@ -612,8 +612,8 @@
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ----------------- | ---------------- |
| aid | num | 稿件avID | |
| bvid | str | 稿件bvID | |
| aid | num | 稿件avid | |
| bvid | str | 稿件bvid | |
| title | str | 视频标题 | |
| pubdate | num | 视频投稿时间 | 时间戳 |
| arcurl | str | 视频页面重定向url | |
@ -735,11 +735,11 @@
| hit_columns | array | 关键字匹配类型 | |
| rank_offset | num | 搜索结果排名值 | |
| cover | str | 相簿封面url | |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
| uname | str | UP主昵称 | |
| rank_index | num | 0 | **作用尚不明确** |
| view | num | 观看次数 | |
| id | num | 相簿ID | |
| id | num | 相簿id | |
| rank_score | num | 结果排序量化值 | |
`相簿条目`中的`hit_columns`数组：

16
user/info.md
View File

@ -20,7 +20,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -37,7 +37,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ------------------------------------------------------------ |
| mid | num | UID | |
| mid | num | mid | |
| name | str | 昵称 | |
| sex | str | 性别 | 男/女/保密 |
| face | str | 头像链接 | |
@ -113,7 +113,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | --------------- | ----------------------------------------------- |
| id | num | 系统提示类型ID | 8：争议账号<br />20：纪念账号<br />22：合约诉讼 |
| id | num | 系统提示类型id | 8：争议账号<br />20：纪念账号<br />22：合约诉讼 |
| content | str | 提示文案 | |
| url | str | 提示信息页面url | |
| notice_type | num | ？ | 作用尚不明确<br />此字段非必须 |
@ -131,13 +131,13 @@
| title | str | 直播间标题 | |
| cover | str | 直播间封面url | |
| online | num | 直播间人气 | 值为上次直播时刷新 |
| roomid | num | 直播间ID（短号） | |
| roomid | num | 直播间id（短号） | |
| roundStatus | num | 轮播状态 | 0：未轮播<br />1：轮播 |
| broadcast_type | num | 0 | |
**示例：**
查询用户`UID=2`的详细信息
查询用户`mid=2`的详细信息
```shell
curl -G 'http://api.bilibili.com/x/space/acc/info' \
@ -279,7 +279,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------------- | ------ | ----------------------- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
| photo | bool | 是否请求用户主页头图 | 非必要 | true：是<br />false：否 |
**json回复：**
@ -303,7 +303,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ----- | -------------- | ------------------------------------------------------------ |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| approve | bool | false | **作用尚不明确** |
| name | str | 用户昵称 | |
| sex | str | 用户性别 | 男 女 保密 |
@ -507,7 +507,7 @@ curl -G 'api.bilibili.com/x/web-interface/card' \
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | ------------------------ |
| mid | num | UID | |
| mid | num | mid | |
| name | str | 昵称 | |
| sex | str | 性别 | 男 女 保密 |
| face | str | 头像图片url | |

166
user/relation.md
View File

@ -15,7 +15,7 @@
- [查询关注分组列表](#查询关注分组列表)
- [查询关注分组明细](#查询关注分组明细)
- [查询目标用户所在的分组](#查询目标用户所在的分组 )
- [查询所有特别关注的UID](#查询所有特别关注的UID)
- [查询所有特别关注的mid](#查询所有特别关注的mid)
- [创建分组](#创建分组)
- [重命名分组](#重命名分组)
- [删除分组](#删除分组)
@ -42,7 +42,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| vmid | num | 目标用户UID | 必要 | |
| vmid | num | 目标用户mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 |
@ -77,7 +77,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | --------------------------------------- |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 成为粉丝时间 | 时间戳<br />互关后刷新 |
| tag | null | | |
@ -116,7 +116,7 @@
**示例：**
获取用户`UID=293793435`的粉丝明细
获取用户`mid=293793435`的粉丝明细
```shell
curl -G 'http://api.bilibili.com/x/relation/followers' \
@ -211,7 +211,7 @@ curl -G 'http://api.bilibili.com/x/relation/followers' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| vmid | num | 目标用户UID | 必要 | |
| vmid | num | 目标用户mid | 必要 | |
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 |
@ -247,10 +247,10 @@ data 对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
@ -262,8 +262,8 @@ data 对象：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | |
| n | num | 位于分组（n+1）的分组ID | |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… |
`list`中的对象中的`official_verify`对象：
@ -294,7 +294,7 @@ data 对象：
**示例：**
获取用户`UID=293793435`的关注明细，按照关注顺序
获取用户`mid=293793435`的关注明细，按照关注顺序
```shell
curl -G 'http://api.bilibili.com/x/relation/ollowings' \
@ -388,7 +388,7 @@ curl -G 'http://api.bilibili.com/x/relation/ollowings' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | |
| vmid | str | 目标用户UID | 必要 | |
| vmid | str | 目标用户mid | 必要 | |
| name | str | 搜索关键词 | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 |
@ -413,10 +413,10 @@ data 对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
@ -428,8 +428,8 @@ data 对象：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | |
| n | num | 位于分组（n+1）的分组ID | |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… |
`list`中的对象中的`official_verify`对象：
@ -533,7 +533,7 @@ curl -G 'http://api.bilibili.com/x/relation/followings/search' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | |
| vmid | num | 目标用户UID | 必要 | |
| vmid | num | 目标用户mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 |
@ -568,10 +568,10 @@ data 对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
@ -583,8 +583,8 @@ data 对象：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | |
| n | num | 位于分组（n+1）的分组ID | |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… |
`list`中的对象中的`official_verify`对象：
@ -615,7 +615,7 @@ data 对象：
**示例：**
获取自己与用户`UID=2`的共同关注明细
获取自己与用户`mid=2`的共同关注明细
```shell
curl -G 'http://api.bilibili.com/x/relation/same/followings' \
@ -746,10 +746,10 @@ data 对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
@ -761,8 +761,8 @@ data 对象：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | |
| n | num | 位于分组（n+1）的分组ID | |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… |
`list`中的对象中的`official_verify`对象：
@ -894,7 +894,7 @@ data 对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | ---------------------- |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| attribute | num | 关注属性 | 128：已拉黑 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | null | | |
@ -1029,7 +1029,7 @@ curl -G 'http://api.bilibili.com/x/relation/blacks' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fid | num | 目标用户UID | 必要 | |
| fid | num | 目标用户mid | 必要 | |
| act | num | 操作代码 | 必要 | **操作代码见下表** |
| re_src | num | 关注来源代码 | 必要 | 空间：11<br />视频：14<br />文章：115<br />活动页面：222 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -1058,7 +1058,7 @@ curl -G 'http://api.bilibili.com/x/relation/blacks' \
**示例：**
关注`UID=14082`的用户
关注`mid=14082`的用户
```shell
curl 'http://api.bilibili.com/x/relation/modify' \
@ -1095,7 +1095,7 @@ curl 'http://api.bilibili.com/x/relation/modify' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ---------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 目标用户UID | 必要 | 每个ID之间用`,`间隔 |
| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
| act | num | 操作代码 | 必要 | 同上<br />仅可为1或5，故只能进行批量关注和拉黑 |
| re_src | num | 关注来源代码 | 必要 | 同上 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -1115,19 +1115,19 @@ curl 'http://api.bilibili.com/x/relation/modify' \
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ----- | ------------- | ---- |
| failed_fids | array | 操作失败的UID | |
| failed_fids | array | 操作失败的mid | |
`data`中的`failed_fids`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------------- | ---- |
| 0 | num | 操作失败的UID 1 | |
| n | num | 操作失败的UID（n+1） | |
| 0 | num | 操作失败的mid 1 | |
| n | num | 操作失败的mid（n+1） | |
| …… | num | …… | …… |
**示例：**
批量关注`UID=1,2,3,4,5`的用户
批量关注`mid=1,2,3,4,5`的用户
```shell
curl 'http://http://api.bilibili.com/x/relation/batch/modify' \
@ -1166,7 +1166,7 @@ curl 'http://http://api.bilibili.com/x/relation/batch/modify' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| fid | num | 目标用户UID | 必要 | |
| fid | num | 目标用户mid | 必要 | |
**json回复：**
@ -1183,23 +1183,23 @@ curl 'http://http://api.bilibili.com/x/relation/batch/modify' \
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 目标用户UID | |
| mid | num | 目标用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
| mtime | num | 关注对方时间 | 时间戳<br />未关注为0 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | |
| tag | null默认分组<br />array存在至少一个分组 | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 |
`tag`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | |
| n | num | 位于分组（n+1）的分组ID | |
| 0 | num | 位于分组1的分组 | |
| n | num | 位于分组（n+1）的分组 | |
| …… | num | …… | …… |
**示例：**
可得对于`UID=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于ID为`-10`分组中
可得对于`mid=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于为`-10`分组中
```shell
curl -G 'http://http://api.bilibili.com/x/relation' \
@ -1240,7 +1240,7 @@ curl -G 'http://http://api.bilibili.com/x/relation' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -1264,33 +1264,33 @@ curl -G 'http://http://api.bilibili.com/x/relation' \
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---------------------------------------- | ------------ | -------------- |
| mid | num | 对方用户UID | |
| mid | num | 对方用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
| mtime | num | 关注对方时间 | 互关后刷新时间 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | |
| tag | null默认分组<br />array存在至少一个分组 | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 |
`data`中的`be_relation`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---------------------------------------- | ------------ | -------------- |
| mid | num | 自己的UID | |
| mid | num | 自己的mid | |
| attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
| mtime | num | 成为粉丝时间 | 互关后刷新时间 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | |
| tag | null默认分组<br />array存在至少一个分组 | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 |
`be_relation`与`relation`中的`tag`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | |
| n | num | 位于分组（n+1）的分组ID | |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… |
**示例：**
可得对于`UID=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于ID为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于ID为`-10`和`56502`的分组中（虽然我看不到）
可得对于`mid=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于为`-10`和`56502`的分组中（虽然我看不到）
```shell
curl -G 'http://api.bilibili.com/x/space/acc/relation' \
@ -1342,7 +1342,7 @@ curl -G 'http://api.bilibili.com/x/space/acc/relation' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 目标用户UID | 必要 | 每个ID之间用`,`间隔 |
| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
**json回复：**
@ -1359,30 +1359,30 @@ curl -G 'http://api.bilibili.com/x/space/acc/relation' \
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ---------- | ---- |
| {用户UID} | obj | 关注的用户 | 下同 |
| {用户mid} | obj | 关注的用户 | 下同 |
| …… | obj | …… | |
`{用户UID}`对象：
`{用户mid}`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | --------------------------------------- | ------------ | ------------------------------------------------------------ |
| mid | num | 目标用户UID | |
| mid | num | 目标用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
| mtime | num | 关注对方时间 | 时间戳<br />未关注为0 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | |
| tag | null默认分组<br />array存在至少一个分组 | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 |
`tag`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | |
| n | num | 位于分组（n+1）的分组ID | |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… |
**示例：**
批量查询`UID=1,2,3,4,5`的关系
批量查询`mid=1,2,3,4,5`的关系
```shell
curl -G 'http://http://api.bilibili.com/x/relation/relations' \
@ -1459,13 +1459,13 @@ curl -G 'http://http://api.bilibili.com/x/relation/relations' \
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ---------- | ---------------------------------- |
| tagid | num | 分组ID | 特别关注恒为-10<br />默认分组恒为0 |
| tagid | num | 分组id | 特别关注恒为-10<br />默认分组恒为0 |
| name | str | 分组名称 | |
| count | num | 分组成员数 | |
**示例：**
查询所有的分组的名字以及ID
查询所有的分组的名字以及id
```shell
curl 'http://api.bilibili.com/x/relation/tags' \
@ -1513,7 +1513,7 @@ curl 'http://api.bilibili.com/x/relation/tags' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组ID | 必要 | 特别关注恒为-10<br />默认分组恒为0 |
| tagid | num | 分组id | 必要 | 特别关注恒为-10<br />默认分组恒为0 |
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页数 | 非必要 | 默认为1 |
@ -1541,7 +1541,7 @@ curl 'http://api.bilibili.com/x/relation/tags' \
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------- | ---- |
| mid | num | 用户UID | |
| mid | num | 用户mid | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
@ -1576,7 +1576,7 @@ curl 'http://api.bilibili.com/x/relation/tags' \
**示例：**
以每页2项的方式获取了ID为`207542`分组的第1页的粉丝明细，按照关注顺序
以每页2项的方式获取了id为`207542`分组的第1页的粉丝明细，按照关注顺序
```shell
curl -G 'http://api.bilibili.com/x/relation/tag' \
@ -1656,7 +1656,7 @@ curl -G 'http://api.bilibili.com/x/relation/tag' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| fid | num | 目标用户UID | 必要 | |
| fid | num | 目标用户mid | 必要 | |
**json回复：**
@ -1673,13 +1673,13 @@ curl -G 'http://api.bilibili.com/x/relation/tag' \
| 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | --------- | ---- |
| ｛加入的分组ID 1｝ | str | 分组1名称 | |
| ｛加入的分组ID n｝ | str | 分组n名称 | |
| {加入的分组id 1} | str | 分组1名称 | |
| {加入的分组id n} | str | 分组n名称 | |
| …… | str | …… | |
**示例：**
查询用户`UID=319214221`存在的所有分组ID和名称
查询用户`mid=319214221`存在的所有分组和名称
```shell
curl -G 'http://api.bilibili.com/x/relation/tag/user' \
@ -1704,7 +1704,7 @@ curl -G 'http://api.bilibili.com/x/relation/tag/user' \
</details>
### 查询所有特别关注的UID
### 查询所有特别关注的mid
> http://api.bilibili.com/x/relation/tag/special
@ -1733,8 +1733,8 @@ curl -G 'http://api.bilibili.com/x/relation/tag/user' \
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | ---- |
| 0 | num | 成员1UID | |
| n | num | 成员（n+1）UID | |
| 0 | num | 成员1mid | |
| n | num | 成员（n+1）mid | |
| …… | num | …… | …… |
**示例：**
@ -1810,11 +1810,11 @@ curl 'http://api.bilibili.com/x/relation/tag/special' \
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------- | ---- |
| tagid | num | 创建的分组的ID | |
| tagid | num | 创建的分组的id | |
**示例：**
创建了名为`测试`的分组，得到ID为`216677`
创建了名为`测试`的分组，得到id为`216677`
```shell
curl 'http://api.bilibili.com/x/relation/tag/create' \
@ -1852,7 +1852,7 @@ curl 'http://api.bilibili.com/x/relation/tag/create' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ---------- |
| access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组ID | 必要 | |
| tagid | num | 分组id | 必要 | |
| name | str | 新名称 | 必要 | 最长16字符 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -1868,7 +1868,7 @@ curl 'http://api.bilibili.com/x/relation/tag/create' \
**示例：**
把ID为`194112`的分组更名为`膜法师`
把id为`194112`的分组更名为`膜法师`
```shell
curl 'http://api.bilibili.com/x/relation/tag/update' \
@ -1906,7 +1906,7 @@ curl 'http://api.bilibili.com/x/relation/tag/update' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组ID | 必要 | |
| tagid | num | 分组id | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@ -1921,7 +1921,7 @@ curl 'http://api.bilibili.com/x/relation/tag/update' \
示例：
删除分组ID为`216699`的分组
删除分组id为`216699`的分组
```shell
curl 'http://api.bilibili.com/x/relation/tag/del' \
@ -1958,8 +1958,8 @@ curl 'http://api.bilibili.com/x/relation/tag/del' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 目标用户UID | 必要 | 每个ID之间用`,`间隔 |
| tagids | nums | 分组ID | 必要 | 每个ID之间用`,`间隔 |
| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
| tagids | nums | 分组id | 必要 | 每个之间用`,`间隔 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@ -1974,7 +1974,7 @@ curl 'http://api.bilibili.com/x/relation/tag/del' \
**示例：**
把关注用户`UID=205631797`同时添加分组关系到ID为`-10`和`207542`的分组中
把关注用户`mid=205631797`同时添加分组关系到id为`-10`和`207542`的分组中
```shell
curl 'http://api.bilibili.com/x/relation/tags/addUsers' \
@ -2010,8 +2010,8 @@ curl 'http://api.bilibili.com/x/relation/tags/addUsers' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 待复制的用户UID | 必要 | 每个ID之间用`,`间隔 |
| tagids | nums | 目标分组ID | 必要 | 每个ID之间用`,`间隔 |
| fids | nums | 待复制的用户mid | 必要 | 每个之间用`,`间隔 |
| tagids | nums | 目标分组id | 必要 | 每个之间用`,`间隔 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@ -2026,7 +2026,7 @@ curl 'http://api.bilibili.com/x/relation/tags/addUsers' \
**示例：**
把关注用户`UID=4856007`和`UID=326499679`同时复制到ID为`231305`的分组中
把关注用户`mid=4856007`和`mid=326499679`同时复制到为`231305`的分组id中
```shell
curl 'http://api.bilibili.com/x/relation/tags/copyUsers' \
@ -2062,9 +2062,9 @@ curl 'http://api.bilibili.com/x/relation/tags/copyUsers' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ------------------------ | -------------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| beforeTagids | nums | 原分组ID | 必要 | 每个ID之间用`,`间隔 |
| afterTagids | nums | 新分组ID | 必要 | 每个ID之间用`,`间隔 |
| fids | nums | 待移动的用户UID | 必要 | 每个ID之间用`,`间隔 |
| beforeTagids | nums | 原分组id | 必要 | 每个之间用`,`间隔 |
| afterTagids | nums | 新分组id | 必要 | 每个之间用`,`间隔 |
| fids | nums | 待移动的用户mid | 必要 | 每个之间用`,`间隔 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@ -2079,7 +2079,7 @@ curl 'http://api.bilibili.com/x/relation/tags/copyUsers' \
**示例：**
把关注用户`UID=321173469`和`UID=327086920`同时从ID为`207542`的分组移动到ID为`231305`的分组中
把关注用户`mid=321173469`和`mid=327086920`同时从id为`207542`的分组移动到为`231305`的分组中
```shell
curl 'http://api.bilibili.com/x/relation/tags/moveUsers' \

190
user/space.md
View File

@ -65,7 +65,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| vmid | num | 目标用户UID | 必要 | |
| vmid | num | 目标用户mid | 必要 | |
**json回复：**
@ -82,9 +82,9 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------------------ | ------------------------------------------------------------ |
| aid | num | 稿件avID | |
| aid | num | 稿件avid | |
| videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区tID | |
| tid | num | 分区tid | |
| tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1：原创<br />2：转载 |
| pic | str | 视频封面图片url | |
@ -99,15 +99,15 @@
| owner | obj | 视频UP主信息 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`owner`对象 |
| stat | obj | 视频状态数 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`stat`对象 |
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| cid | num | 视频1P CID | |
| cid | num | 视频1P cid | |
| dimension | obj | 视频1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 |
| bvid | str | 稿件bvID | |
| bvid | str | 稿件bvid | |
| reason | str | 置顶视频备注 | |
| inter_video | bool | 是否为合作视频 | false：否<br />true：是 |
**示例：**
查询用户`UID=23215368`的置顶视频
查询用户`mid=23215368`的置顶视频
```shell
curl -G 'http://api.bilibili.com/x/space/top/arc' \
@ -196,8 +196,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） | 必要 | |
@ -215,7 +215,7 @@ curl -G 'http://api.bilibili.com/x/space/top/arc' \
置顶视频`av98948772`/`BV1n741127LD`
avID方式：
avid方式：
```shell
curl 'http://api.bilibili.com/x/space/top/arc/set' \
@ -223,7 +223,7 @@ curl 'http://api.bilibili.com/x/space/top/arc/set' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl 'http://api.bilibili.com/x/space/top/arc/set' \
@ -305,7 +305,7 @@ curl 'http://api.bilibili.com/x/space/top/arc/cancel' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| vmid | num | 目标用户UID | 必要 | |
| vmid | num | 目标用户mid | 必要 | |
**json回复：**
@ -332,7 +332,7 @@ curl 'http://api.bilibili.com/x/space/top/arc/cancel' \
**示例：**
查询用户`UID=23215368`的代表作视频列表
查询用户`mid=23215368`的代表作视频列表
```shell
curl -G 'http://api.bilibili.com/x/space/masterpiece' \
@ -536,8 +536,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） | 必要 | |
@ -555,7 +555,7 @@ curl -G 'http://api.bilibili.com/x/space/masterpiece' \
添加视频`av94916552`/`BV1ZE411K7ux`到代表作列表
avID方式：
avid方式：
```shell
curl 'http://api.bilibili.com/x/space/masterpiece/add' \
@ -564,7 +564,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/add' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl 'http://api.bilibili.com/x/space/masterpiece/add' \
@ -598,8 +598,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回复：**
@ -616,7 +616,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/add' \
删除置顶视频`av59765630`/`BV1Yt41137T6`
avID方式：
avid方式：
```shell
curl 'api.bilibili.com/x/space/masterpiece/cancel' \
@ -625,7 +625,7 @@ curl 'api.bilibili.com/x/space/masterpiece/cancel' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \
@ -650,7 +650,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -673,7 +673,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----- | ----------- | ---- |
| mid | num | 目标用户UID | |
| mid | num | 目标用户mid | |
| tags | array | TAG名称 | |
`data`数组中的对象中的`tags`数组：
@ -687,7 +687,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \
**示例：**
查看用户`UID=53456`的个人TAG
查看用户`mid=53456`的个人TAG
```shell
curl -G 'http://api.bilibili.com/x/space/acc/tags' \
@ -782,7 +782,7 @@ curl 'http://api.bilibili.com/x/space/acc/tags/set' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -797,7 +797,7 @@ curl 'http://api.bilibili.com/x/space/acc/tags/set' \
**示例：**
查看用户`UID=53456`的空间公告
查看用户`mid=53456`的空间公告
```shell
curl -G 'http://api.bilibili.com/x/space/notice' \
@ -881,7 +881,7 @@ curl 'http://api.bilibili.com/x/space/notice/set' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -950,7 +950,7 @@ curl 'http://api.bilibili.com/x/space/notice/set' \
**示例：**
查看`UID=2`的空间设置
查看`mid=2`的空间设置
```shell
curl -G 'http://space.bilibili.com/ajax/settings/getSettings' \
@ -1196,7 +1196,7 @@ curl 'http://space.bilibili.com/ajax/settings/setPrivacy' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -1227,7 +1227,7 @@ curl 'http://space.bilibili.com/ajax/settings/setPrivacy' \
**示例：**
查询`UID=2`的最近玩过的游戏
查询`mid=2`的最近玩过的游戏
```shell
curl -G 'http://api.bilibili.com/x/space/lastplaygame' \
@ -1288,7 +1288,7 @@ curl -G 'http://api.bilibili.com/x/space/lastplaygame' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| vmid | num | 目标用户UID | 必要 | |
| vmid | num | 目标用户mid | 必要 | |
**json回复：**
@ -1315,7 +1315,7 @@ curl -G 'http://api.bilibili.com/x/space/lastplaygame' \
**示例：**
查看用户`UID=15858903`的最近投币视频
查看用户`mid=15858903`的最近投币视频
```shell
curl -G 'http://space.bilibili.com/x/space/coin/video' \
@ -1531,9 +1531,9 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------ | ------ | ------------------------------------------------------------ |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
| order | str | 排序方式 | 非必要 | 默认为pubdate<br />最新发布：pubdate<br />最多播放：click<br />最多收藏：stow |
| tid | num | 筛选目标分区 | 非必要 | 默认为0<br />0：不进行分区筛选<br />分区tID为所筛选的分区 |
| tid | num | 筛选目标分区 | 非必要 | 默认为0<br />0：不进行分区筛选<br />分区tid为所筛选的分区 |
| keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
| pn | num | 页码 | 必要 | |
| ps | num | 每页项数 | 必要 | |
@ -1568,16 +1568,16 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------ | --------------------- |
| {tID} | obj | 该分区的详情 | 字段名为存在的分区tID |
| {tid} | obj | 该分区的详情 | 字段名为存在的分区tid |
| …… | obj | …… | 向下扩展 |
`tlist`中的`{tID}`对象：
`tlist`中的`{tid}`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------------- | ---- |
| count | num | 投稿至该分区的视频数 | |
| name | str | 该分区名称 | |
| tid | num | 该分区tID | |
| tid | num | 该分区tid | |
`list`中的`vlist`数组：
@ -1591,9 +1591,9 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | -------------- | ---------------------------- |
| aid | num | 稿件avID | |
| aid | num | 稿件avid | |
| author | str | 视频UP主 | 不一定为目标用户（合作视频） |
| bvid | str | 稿件bvID | |
| bvid | str | 稿件bvid | |
| comment | num | 视频评论数 | |
| copyright | str | 空 | 作用尚不明确 |
| created | num | 投稿时间 | 时间戳 |
@ -1602,13 +1602,13 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
| is_pay | num | 0 | 作用尚不明确 |
| is_union_video | num | 是否为合作视频 | 0：否<br />1：是 |
| length | str | 视频长度 | MM:SS |
| mid | num | 视频UP主UID | 不一定为目标用户（合作视频） |
| mid | num | 视频UP主mid | 不一定为目标用户（合作视频） |
| pic | str | 视频封面 | |
| play | num | 视频播放次数 | |
| review | num | 0 | 作用尚不明确 |
| subtitle | str | 空 | 作用尚不明确 |
| title | str | 视频标题 | |
| typeid | num | 视频分区tID | |
| typeid | num | 视频分区tid | |
| video_review | num | 视频弹幕数 | |
`data`中的`page`对象：
@ -1630,7 +1630,7 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
`pn`（页码）和`ps`（每页项数）只改变`vlist`中成员的多少与内容
以每页2项查询用户`UID=53456`的第1页投稿视频明细
以每页2项查询用户`mid=53456`的第1页投稿视频明细
```shell
curl -G 'http://api.bilibili.com/x/space/arc/search' \
@ -1750,7 +1750,7 @@ curl -G 'http://api.bilibili.com/x/space/arc/search' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ------- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
| ps | num | 获取的相簿量 | 非必要 | 默认为8 |
**json回复：**
@ -1779,10 +1779,10 @@ curl -G 'http://api.bilibili.com/x/space/arc/search' \
| count | num | 总计图片数 | |
| ctime | num | 发布时间 | 时间戳 |
| description | str | 简介 | |
| doc_id | num | 相簿ID | 非动态ID！！！ |
| doc_id | num | 相簿id | 非动态！！！ |
| like | num | 点赞数 | |
| pictures | array | 图片内容 | |
| poster_uid | num | 上传用户UID | |
| poster_uid | num | 上传用户mid | |
| title | str | 标题 | 动态内容无 |
| view | num | 浏览数 | |
@ -1805,7 +1805,7 @@ curl -G 'http://api.bilibili.com/x/space/arc/search' \
**示例：**
查询用户`UID=53456`的投稿相簿预览
查询用户`mid=53456`的投稿相簿预览
```shell
curl -G 'http://api.bilibili.com/x/space/album/index' \
@ -1877,7 +1877,7 @@ curl -G 'http://api.bilibili.com/x/space/album/index' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | ----------- | ------ | ------------------------------------------------------------ |
| uid | num | 目标用户UID | 必要 | |
| uid | num | 目标用户mid | 必要 | |
| page_num | num | 页码 | 非必要 | 默认为1 |
| page_size | num | 每页项数 | 非必要 | 默认为20 |
| biz | str | 查询类型 | 非必要 | 全部：all<br />绘画：draw<br />摄影：photo<br />日常：daily<br />默认为all |
@ -1914,10 +1914,10 @@ curl -G 'http://api.bilibili.com/x/space/album/index' \
| count | num | 总计图片数 | |
| ctime | num | 发布时间 | 时间戳 |
| description | str | 简介 | |
| doc_id | num | 相簿ID | 非动态ID！！！ |
| doc_id | num | 相簿id | 非动态！！！ |
| like | num | 点赞数 | |
| pictures | array | 图片内容 | |
| poster_uid | num | 上传用户UID | |
| poster_uid | num | 上传用户mid | |
| title | str | 标题 | 动态内容无 |
| view | num | 浏览数 | |
@ -1940,7 +1940,7 @@ curl -G 'http://api.bilibili.com/x/space/album/index' \
**示例：**
查询用户`UID=53456`的投稿明细中的全部类型
查询用户`mid=53456`的投稿明细中的全部类型
```shell
curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \
@ -2025,7 +2025,7 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -2057,17 +2057,17 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------- | -------- |
| cid | num | 频道ID | |
| cid | num | 频道id | |
| count | num | 频道内含视频数 | |
| cover | str | 封面图片url | |
| intro | str | 简介 | 无则为空 |
| mid | num | 创建用户UID | |
| mid | num | 创建用户mid | |
| mtime | num | 创建时间 | 时间戳 |
| name | str | 标题 | |
**示例：**
查询用户`UID=53456`的频道列表
查询用户`mid=53456`的频道列表
```shell
curl -G 'http://api.bilibili.com/x/space/channel/list' \
@ -2151,8 +2151,8 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | --------- |
| mid | num | 目标用户UID | 必要 | |
| cid | num | 目标频道ID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
| cid | num | 目标频道id | 必要 | |
| pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为100 |
@ -2179,11 +2179,11 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \
| 字段 | 类型 | 内容 | 备注 |
| -------- | ------ | -------------- | -------- |
| archives | array | 包含的视频列表 | |
| cid | num | 频道ID | |
| cid | num | 频道id | |
| count | num | 频道内含视频数 | |
| cover | str | 封面图片url | |
| intro | str | 简介 | 无则为空 |
| mid | num | 创建用户UID | |
| mid | num | 创建用户mid | |
| mtime | num | 创建时间 | 时间戳 |
| name | str | 标题 | |
@ -2197,7 +2197,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \
`list`中的`archives`数组中的对象：
基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象
基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avid/bvid互转）)」中的data对象
`data`中的`page`对象：
@ -2209,7 +2209,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \
**示例：**
查询用户`UID=53456`的频道`170`中的视频
查询用户`mid=53456`的频道`170`中的视频
```shell
curl -G 'http://api.bilibili.com/x/space/channel/video' \
@ -2368,7 +2368,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/video' \
认证方式：Cookie（SESSDATA）
创建成功后会返回新建频道的ID
创建成功后会返回新建频道的id
**正文参数（ application/x-www-form-urlencoded ）：**
@ -2393,7 +2393,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/video' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------ | ---- |
| cid | num | 频道ID | |
| cid | num | 频道id | |
**示例：**
@ -2435,7 +2435,7 @@ curl 'http://api.bilibili.com/x/space/channel/add' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 频道ID | 必要 | |
| cid | num | 频道id | 必要 | |
| name | str | 频道名 | 必要 | |
| intro | str | 频道简介 | 非必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
@ -2488,7 +2488,7 @@ curl 'http://api.bilibili.com/x/space/channel/edit' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 需要删除的频道ID | 必要 | |
| cid | num | 需要删除的频道id | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@ -2543,8 +2543,8 @@ curl 'http://api.bilibili.com/x/space/channel/del' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---------------------- |
| cid | num | 频道ID | 必要 | |
| aids | nums | 要添加的目标稿件avID | 必要 | 多个使用","（%2C）分隔 |
| cid | num | 频道id | 必要 | |
| aids | nums | 要添加的目标稿件avid | 必要 | 多个使用","（%2C）分隔 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@ -2556,14 +2556,14 @@ curl 'http://api.bilibili.com/x/space/channel/del' \
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<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 | 出错稿件avID（n+1） | |
| 0 | num | 出错稿件avid1 | |
| n | num | 出错稿件avid（n+1） | |
| …… | num | …… | …… |
**示例：**
@ -2606,8 +2606,8 @@ curl 'http://api.bilibili.com/x/space/channel/video/add' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 频道ID | 必要 | |
| aid | num | 要删除的目标稿件avID | 必要 | |
| cid | num | 频道id | 必要 | |
| aid | num | 要删除的目标稿件avid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@ -2657,8 +2657,8 @@ curl 'http://api.bilibili.com/x/space/channel/video/del' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| cid | num | 频道ID | 必要 | |
| aid | num | 要移动的目标稿件avID | 必要 | |
| cid | num | 频道id | 必要 | |
| aid | num | 要移动的目标稿件avid | 必要 | |
| to | num | 视频排序倒数位置 | 非必要 | 默认为1<br />1为列表底部，视频总数为首端<br />与显示顺序恰好相反 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
@ -2710,7 +2710,7 @@ curl 'http://api.bilibili.com/x/space/channel/video/sort' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ---- |
| cid | num | 目标频道ID | 必要 | |
| cid | num | 目标频道id | 必要 | |
**json回复：**
@ -2763,7 +2763,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| up_mid | num | 目标用户UID | 必要 | |
| up_mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -2795,9 +2795,9 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | --------------- |
| id | num | 收藏夹mlID | |
| fid | num | 原始收藏夹ID | 去除两位UID尾号 |
| mid | num | 创建用户UID | |
| id | num | 收藏夹mlid | |
| fid | num | 原始收藏夹mlid | 去除两位mid尾号 |
| mid | num | 创建用户mid | |
| attr | num | 收藏夹属性位配置 | |
| title | str | 收藏夹标题 | |
| fav_state | num | 0 | 作用尚不明确 |
@ -2813,7 +2813,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check
**示例：**
查询用户`UID=7792521`的收藏夹列表
查询用户`mid=7792521`的收藏夹列表
```shell
curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \
@ -2890,7 +2890,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \
| ------ | ---- | ----------- | ------ | ---- |
| ps | num | 每页项数 | 必要 | |
| pn | num | 页码 | 必要 | |
| up_mid | num | 目标用户UID | 必要 | |
| up_mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -2922,9 +2922,9 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------ | ----------------------------------------- |
| id | num | 收藏夹mlID | |
| fid | num | 原始收藏夹ID | 去除两位UID尾号 |
| mid | num | 创建用户UID | |
| id | num | 收藏夹ml | |
| fid | num | 原始收藏夹mlid | 去除两位mid尾号 |
| mid | num | 创建用户mid | |
| attr | num | 收藏夹属性 | 转换成8-bit二进制处理<br />详细说明见下表 |
| title | str | 收藏夹标题 | |
| cover | str | 收藏夹封面图片url | |
@ -2947,13 +2947,13 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---------- | ------------ |
| mid | num | 创建人UID | |
| mid | num | 创建人mid | |
| name | str | 创建人昵称 | |
| face | str | 空 | 作用尚不明确 |
**示例：**
查询用户`UID=293793435`的收藏夹收藏列表
查询用户`mid=293793435`的收藏夹收藏列表
```shell
curl -G 'http://api.bilibili.com/x/v3/fav/folder/collected/list' \
@ -3032,7 +3032,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/collected/list' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | -------- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
| pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为20 |
@ -3080,14 +3080,14 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/collected/list' \
| link | str | 课程页面url | 手机版页面url |
| page | num | 1 | 作用尚不明确 |
| play | num | 课程播放数 | |
| season_id | num | 课程ssID | |
| season_id | num | 课程ssid | |
| status | str | 更新状态说明 | |
| subtitle | str | 课程副标题 | |
| title | str | 课程标题 | |
**示例：**
查询用户`UID=33683045`的课程发布列表
查询用户`mid=33683045`的课程发布列表
```shell
curl -G 'http://api.bilibili.com/pugv/app/web/season/page' \
@ -3193,7 +3193,7 @@ curl -G 'http://api.bilibili.com/pugv/app/web/season/page' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -3232,14 +3232,14 @@ curl -G 'http://api.bilibili.com/pugv/app/web/season/page' \
| is_finish | num | 是否已完结 | 0：未完结<br />1：已完结 |
| last_ep_index | num | 0 | 作用尚不明确 |
| newest_ep_index | num | 最新一话 | 可能为0 |
| season_id | str | 番剧ssID | |
| season_id | str | 番剧ssid | |
| share_url | str | 播放页面链接url | |
| title | str | 标题 | |
| total_count | num | 总计集数 | 未完结：-1<br />已完结：非0正整数 |
**示例：**
查看用户`UID=14082`的追番预览列表
查看用户`mid=14082`的追番预览列表
```shell
curl -G 'http://space.bilibili.com/ajax/Bangumi/getList' \
@ -3303,7 +3303,7 @@ curl -G 'http://space.bilibili.com/ajax/Bangumi/getList' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | -------------------- |
| vmid | num | 目标用户UID | 必要 | |
| vmid | num | 目标用户mid | 必要 | |
| pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为15 |
| type | num | 查询类型 | 必要 | 1：追番<br />2：追剧 |
@ -3342,7 +3342,7 @@ curl -G 'http://space.bilibili.com/ajax/Bangumi/getList' \
**示例：**
查看用户`UID=14082`的追番明细
查看用户`mid=14082`的追番明细
```shell
curl -G 'http://api.bilibili.com/x/space/bangumi/follow/list' \
@ -3571,7 +3571,7 @@ curl -G 'http://api.bilibili.com/x/space/bangumi/follow/list' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -3606,12 +3606,12 @@ curl -G 'http://api.bilibili.com/x/space/bangumi/follow/list' \
| cover | str | TAG图片url | 无则为空 |
| name | str | TAG名 | |
| notify | num | 1 | 作用尚不明确 |
| tag_id | num | TAGID | |
| tag_id | num | tag_id | |
| updated_ts | str | 1970-01-01 08:00:00 | 作用尚不明确 |
**示例：**
查询用户`UID=2`的关注TAG
查询用户`mid=2`的关注TAG
```shell
curl -G 'http://space.bilibili.com/ajax/tags/getSubList' \

18
user/status_number.md
View File

@ -19,7 +19,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| vmid | num | 目标用户UID | 必要 | |
| vmid | num | 目标用户mid | 必要 | |
**json回复：**
@ -36,7 +36,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ----------- | ------------------------------------------------ |
| mid | num | 目标用户UID | |
| mid | num | 目标用户mid | |
| following | num | 关注数 | |
| whisper | num | 悄悄关注数 | 需要登录(Cooklie或APP) <br />未登录或非自己恒为0 |
| black | num | 黑名单数 | 需要登录(Cooklie或APP) <br />未登录或非自己恒为0 |
@ -44,7 +44,7 @@
**示例：**
查询用户`UID=332704117`的关系状态数
查询用户`mid=332704117`的关系状态数
```shell
curl -G 'http://api.bilibili.com/x/relation/stat' \
@ -87,7 +87,7 @@ curl -G 'http://api.bilibili.com/x/relation/stat' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -122,7 +122,7 @@ curl -G 'http://api.bilibili.com/x/relation/stat' \
**示例：**
查询用户`UID=456664753`的UP主状态数
查询用户`mid=456664753`的UP主状态数
```shell
curl -G 'http://api.bilibili.com/x/space/upstat' \
@ -164,7 +164,7 @@ curl -G 'http://api.bilibili.com/x/space/upstat' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
@ -209,7 +209,7 @@ curl -G 'http://api.bilibili.com/x/space/upstat' \
**示例：**
查询用户`UID=239202390`的订阅&投稿状态数
查询用户`mid=239202390`的订阅&投稿状态数
```shell
curl -G 'http://api.bilibili.com/x/space/navnum' \
@ -260,7 +260,7 @@ curl -G 'http://api.bilibili.com/x/space/navnum' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| uid | num | 目标用户UID | 必要 | |
| uid | num | 目标用户mid | 必要 | |
**json回复：**
@ -284,7 +284,7 @@ curl -G 'http://api.bilibili.com/x/space/navnum' \
**示例：**
查询用户`UID=53456`的投稿相簿数
查询用户`mid=53456`的投稿相簿数
```shell
curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/upload_count' \

71
video/attribute_data.md Normal file
View File

@ -0,0 +1,71 @@
# 视频属性数据说明
（PS：以下部分内容来源不明，且部分值前端不可见，有待验证）
- [attribute字段值(视频属性位)](#attribute字段值(视频属性位))
- [state字段值(稿件状态)](#state字段值(稿件状态))
## attribute字段值(稿件属性位)
该字段为二进制标志位，多个标志请用`AND`运算叠加
| 位 | 内容 | 备注 |
| ---- | ---------------------- | ------------------------------------------------------------ |
| 0 | 禁止排行 | |
| 1 | 动态禁止 | 禁止APP推送动态 |
| 2 | 禁止网页输出 | |
| 3 | 禁止客户端列表 | |
| 4 | 搜索禁止 | 打全标题或av/bv号都搜索不到的那种 |
| 5 | 海外禁止 | |
| 6 | 禁止推荐 | 禁止被APP端天马列表推荐 |
| 7 | 是否显示“禁止转载“标志 | **注：未经作者授权 禁止转载** |
| 8 | 是否高清 | 视频清晰度>=1080P |
| 9 | 是否PGC稿件 | 番剧&影视 |
| 10 | 允许承包 | |
| 11 | 是否番剧 | |
| 12 | 是否私单 | 存在商业推广恰饭内容 |
| 13 | 是否限制地区 | 大多数番剧&影视 |
| 14 | 禁止其他人添加TAG | |
| 15 | ？ | 大多数旧视频会有这个标志 |
| 16 | 跳转 | 番剧及影视av/bv->ep跳转 |
| 17 | 是否影视 | |
| 18 | 是否付费 | |
| 19 | 推送动态 | |
| 20 | 家长模式 | |
| 21 | 是否限制游客和外链 | 分为两种情况，默认全部网页限制referer跳转，但第二种未登录无法访问，可以通过未登陆b站访问http://api.bilibili.com/x/web-interface/view 返回的code为-403来判断 |
| 22 | ？ | |
| 23 | ？ | |
| 24 | 是否为联合投稿 | |
| 25 | ？ | |
| 26 | ？ | |
| 27 | ？ | |
| 28 | ？ | |
| 29 | 是否为互动视频 | |
## state字段值(稿件状态)
| 值 | 内容 | 备注 |
| ---- | ------------ | ---------- |
| 1 | 橙色通过 | |
| 0 | 开放浏览 | |
| -1 | 待审 | |
| -2 | 被打回 | |
| -3 | 网警锁定 | |
| -4 | 被锁定 | 视频撞车了 |
| -5 | 管理员锁定 | |
| -6 | 修复待审 | |
| -7 | 暂缓审核 | |
| -8 | 补档待审 | |
| -9 | 等待转码 | |
| -10 | 延迟审核 | |
| -11 | 视频源待修 | |
| -12 | 转储失败 | |
| -13 | 允许评论待审 | |
| -14 | 临时回收站 | |
| -15 | 分发中 | |
| -16 | 转码失败 | |
| -20 | 创建未提交 | |
| -30 | 创建已提交 | |
| -40 | 定时发布 | |
| -100 | 用户删除 | |

261
video/info.md
View File

@ -2,28 +2,28 @@
<img src="/imgs/ploading.gif" width="100" height="100"/>
- [获取视频详细信息（web端）](#获取视频详细信息（web端）)
- [获取视频详细信息(web端)](#获取视频详细信息(web端))
- [获取视频简介](#获取视频简介)
- [查询视频分P列表 (avID/bvID转CID)](#查询视频分P列表 (avID/bvID转CID))
- [查询视频分P列表 (avid/bvid转cid)](#查询视频分P列表 (avid/bvid转cid))
---
## 获取视频详细信息（web端）
## 获取视频详细信息(web端)
> http://api.bilibili.com/x/web-interface/view
*请求方式：GET*
认证方式：Cookie（SESSDATA）
认证方式：Cookie(SESSDATA)
限制游客访问的视频需要登录
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ---------- | ------------------ |
| aid | num | 稿件avid | 必要(可选) | avid与bvid任选一个 |
| bvid | str | 稿件bvid | 必要(可选) | avid与bvid任选一个 |
**json回复：**
@ -38,102 +38,51 @@
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------------------------- | ------- | ------------------------------ | ------------------------------------------------------------ |
| 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 | 视频状态 | **详情见下表** |
| ~~attribute~~（已经弃用） | ~~num~~ | ~~稿件属性位配置~~ | **详情见下表**|
| duration | num | 稿件总时长（所有分P） | 单位为秒 |
| forward | num | 撞车视频跳转avid | 仅撞车视频存在此字段 |
| mission_id | num | 稿件参与的活动ID | |
| redirect_url | str | 重定向url | 仅番剧或影视视频存在此字段<br />用于番剧&影视的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 | 合作成员列表 | 非合作视频无此项 |
| user_garb | obj | 用户装扮信息 | |
| 字段 | 类型 | 内容 | 备注 |
| ----------------------- | ------- | ------------------------------ | ------------------------------------------------------------ |
| 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 | 视频简介 | |
| desc_v2 | array | 新版视频简介 | |
| state | num | 视频状态 | 详情见[属性数据文档](attribute_data.md#attribute字段值(稿件属性位)) |
| ~~attribute~~(已经弃用) | ~~num~~ | ~~稿件属性位配置~~ | 详情见[属性数据文档](attribute_data.md#state字段值(稿件状态)) |
| duration | num | 稿件总时长(所有分P) | 单位为秒 |
| forward | num | 撞车视频跳转avid | 仅撞车视频存在此字段 |
| mission_id | num | 稿件参与的活动id | |
| redirect_url | str | 重定向url | 仅番剧或影视视频存在此字段<br />用于番剧&影视的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 | 合作成员列表 | 非合作视频无此项 |
| user_garb | obj | 用户装扮信息 | |
`attribute`字段属性位二进制值表：
`data`中的`desc_v2`数组：
（PS：以下部分内容来源不明，有待验证，下表只做历史保留，无实际作用）
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ---- |
| 0 | obj | 新版简介内容 | |
| 位 | 内容 | 备注 |
| ---- | ---------------------- | --------------------------------------------- |
| 0 | 禁止排行 | |
| 1 | 动态禁止 | 禁止APP推送动态 |
| 2 | 禁止网页输出 | |
| 3 | 禁止客户端列表 | |
| 4 | 搜索禁止 | 打全标题或av/bv号都搜索不到的那种 |
| 5 | 海外禁止 | |
| 6 | 禁止推荐 | 禁止被APP端天马列表推荐 |
| 7 | 是否显示“禁止转载“标志 | **注：未经作者授权 禁止转载** |
| 8 | 是否高清 | 视频清晰度>=1080P |
| 9 | 是否PGC稿件 | 番剧&影视 |
| 10 | 允许承包 | |
| 11 | 是否番剧 | |
| 12 | 是否私单 | 存在商业推广恰饭内容 |
| 13 | 是否限制地区 | 大多数番剧&影视 |
| 14 | 禁止其他人添加TAG | |
| 15 | ？ | |
| 16 | 跳转 | 番剧及影视av/bv->ep跳转 |
| 17 | 是否影视 | |
| 18 | 是否付费 | |
| 19 | 推送动态 | |
| 20 | 家长模式 | |
| 21 | 是否限制游客和外链 | 分为两种情况，默认全部网页限制referer跳转，但第二种未登录无法访问，可以通过未登陆b站访问http://api.bilibili.com/x/web-interface/view 返回的code为-403来判断 |
| 22 | ？ | |
| 23 | ？ | |
| 24 | 是否为联合投稿 | |
| 25 | ？ | |
| 26 | ？ | |
| 27 | ？ | |
| 28 | ？ | |
| 29 | 是否为互动视频 | |
`desc_v2`数组中的对象：
`state`字段值：
（PS：以下部分内容来源不明，且部分值前端不可见，有待验证）
| 值 | 内容 | 备注 |
| ---- | ------------ | ---------- |
| 1 | 橙色通过 | |
| 0 | 开放浏览 | |
| -1 | 待审 | |
| -2 | 被打回 | |
| -3 | 网警锁定 | |
| -4 | 被锁定 | 视频撞车了 |
| -5 | 管理员锁定 | |
| -6 | 修复待审 | |
| -7 | 暂缓审核 | |
| -8 | 补档待审 | |
| -9 | 等待转码 | |
| -10 | 延迟审核 | |
| -11 | 视频源待修 | |
| -12 | 转储失败 | |
| -13 | 允许评论待审 | |
| -14 | 临时回收站 | |
| -15 | 分发中 | |
| -16 | 转码失败 | |
| -20 | 创建未提交 | |
| -30 | 创建已提交 | |
| -40 | 定时发布 | |
| -100 | 用户删除 | |
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ---- |
| raw_text | num | 简介内容 | |
| type | num | ? | |
| biz_id | num | ? | |
`data`中的`rights`对象：
@ -157,7 +106,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| mid | num | UP主UID | |
| mid | num | UP主mid | |
| name | str | UP主昵称 | |
| face | str | UP主头像 | |
@ -165,7 +114,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | ------- |
| aid | num | 稿件avID | |
| aid | num | 稿件avid | |
| view | num | 播放数 | |
| danmaku | num | 弹幕数 | |
| reply | num | 评论数 | |
@ -191,7 +140,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | --------------- | --------------------------------------------------------- |
| cid | num | 当前分P CID | |
| cid | num | 当前分P cid | |
| page | num | 当前分P | |
| from | str | 视频来源 | vupload：普通上传（B站）<br />hunan：芒果TV<br />qq：腾讯 |
| part | str | 当前分P标题 | |
@ -227,11 +176,11 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------- | ---- |
| id | num | 字幕ID | |
| id | num | 字幕id | |
| lan | str | 字幕语言 | |
| lan_doc | str | 字幕语言名称 | |
| is_lock | bool | 是否锁定 | |
| author_mid | num | 字幕上传者UID | |
| author_mid | num | 字幕上传者mid | |
| subtitle_url | str | json格式字幕文件url | |
| author | obj | 字幕上传者信息 | |
@ -239,7 +188,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------------- | ------------ |
| mid | num | 字幕上传者UID | |
| mid | num | 字幕上传者mid | |
| name | str | 字幕上传者昵称 | |
| sex | str | 字幕上传者性别 | 男 女 保密 |
| face | str | 字幕上传者头像url | |
@ -261,7 +210,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------------- | ---- |
| mid | num | 成员UID | |
| mid | num | 成员mid | |
| title | str | 成员名称 | |
| name | str | 成员昵称 | |
| face | str | 成员头像url | |
@ -288,8 +237,6 @@
`data`中的`user_garb`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | ------- | ---- |
| url_image_ani_cut | str | 某url？ | |
@ -298,14 +245,14 @@
获取视频`av85440373`/`BV117411r7R1`的基本信息
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/web-interface/view' \
--data-urlencode 'aid=85440373'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/web-interface/view' \
@ -332,6 +279,13 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
"pubdate": 1580377255,
"ctime": 1580212263,
"desc": "【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包装：破晓天",
"desc_v2": [
{
"raw_text": "【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包装：破晓天",
"type": 1,
"biz_id": 0
}
],
"state": 0,
"duration": 486,
"mission_id": 11838,
@ -358,15 +312,15 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
},
"stat": {
"aid": 85440373,
"view": 1936852,
"danmaku": 11189,
"reply": 2626,
"favorite": 56572,
"coin": 66857,
"share": 9032,
"view": 2087084,
"danmaku": 11495,
"reply": 2669,
"favorite": 58113,
"coin": 68710,
"share": 9190,
"now_rank": 0,
"his_rank": 55,
"like": 142449,
"like": 148621,
"dislike": 0,
"evaluation": "",
"argue_msg": ""
@ -408,8 +362,22 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
"vip": {
"type": 2,
"status": 1,
"vip_pay_type": 0,
"theme_type": 0
"due_date": 1642694400000,
"vip_pay_type": 1,
"theme_type": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"role": 3,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png"
},
"official": {
"role": 2,
@ -417,7 +385,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
"desc": "",
"type": 0
},
"follower": 628808,
"follower": 662460,
"label_style": 0
},
{
@ -428,8 +396,22 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
"vip": {
"type": 2,
"status": 1,
"due_date": 1637424000000,
"vip_pay_type": 0,
"theme_type": 0
"theme_type": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"role": 3,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png"
},
"official": {
"role": 1,
@ -437,7 +419,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
"desc": "",
"type": 0
},
"follower": 2268492,
"follower": 2655737,
"label_style": 0
}
],
@ -452,7 +434,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
视频标题为：`当我给拜年祭的快板加了电音配乐…`
视频分区为：`tid=28（音乐->原创音乐）`
视频分区为：`tid=28(音乐->原创音乐)`
视频时长：`486s`
@ -462,15 +444,15 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
视频分P为：`1`
视频类型为：`1（原创）`
视频类型为：`1(原创)`
视频UP主为：`66606350（Crazy_Bucket）`
视频UP主为：`66606350(Crazy_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包装：破晓天`
`【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（开放浏览）`
视频状态为：`0(开放浏览)`
视频属性为： `显示“禁止转载“标志`、`高清`、`禁止其他人添加TAG`、`联合投稿视频`
@ -492,8 +474,8 @@ http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 |
| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
**json回复：**
@ -508,16 +490,16 @@ http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg
**示例：**
查看视频（教主的咕鸽）`av39330059`/`BV1Bt411z799`的简介
查看视频(教主的咕鸽)`av39330059`/`BV1Bt411z799`的简介
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/archive/desc' \
--data-urlencode 'aid=39330059'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/archive/desc' \
@ -538,7 +520,7 @@ curl -G 'http://api.bilibili.com/x/archive/desc' \
</details>
## 查询视频分P列表 (avID/bvID转CID)
## 查询视频分P列表 (avid/bvid转cid)
> http://api.bilibili.com/x/player/pagelist
@ -548,8 +530,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回复：**
@ -574,7 +556,7 @@ curl -G 'http://api.bilibili.com/x/archive/desc' \
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | --------------- | --------------------------------------------------------- |
| cid | num | 当前分P CID | |
| cid | num | 当前分P cid | |
| page | num | 当前分P | |
| from | str | 视频来源 | vupload：普通上传（B站）<br />hunan：芒果TV<br />qq：腾讯 |
| part | str | 当前分P标题 | |
@ -595,14 +577,14 @@ curl -G 'http://api.bilibili.com/x/archive/desc' \
查询视频`av13502509`/`BV1ex411J7GE`的分P列表
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/player/pagelist' \
--data-urlencode 'aid=13502509'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/player/pagelist' \
@ -677,4 +659,3 @@ curl -G 'http://api.bilibili.com/x/player/pagelist' \
</details>

24
video/interact_video.md
View File

@ -20,9 +20,9 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | -------- | ------------ | ------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 |
| graph_version | num | 剧情图ID | 必要 | 位于`player.so`中 |
| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| graph_version | num | 剧情图id | 必要 | 位于`player.so`中 |
| edge_id | num | 模块编号 | 非必要 | 0或留空为起始模块 |
**json回复：**
@ -41,7 +41,7 @@
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ----- | ------------------- | ------------------------------------------------ |
| title | str | 视频模块（分P）标题 | |
| edge_id | num | 当前模块ID | |
| edge_id | num | 当前模块id | |
| story_list | array | 进度回溯信息 | 未登录仅有起始模块 |
| edges | obj | 当前模块信息 | |
| preload | obj | 预加载的分P | |
@ -66,7 +66,7 @@
| node_id | num | 模块编号 | |
| edge_id | num | **同上** | |
| title | str | 模块（分P）标题 | |
| cid | num | 模块（分P）CID | |
| cid | num | 模块（分P）cid | |
| start_pos | num | 记录播放开始位置 | 单位为毫秒 |
| cover | str | 分P封面url | |
| is_current | num | 是否为当前模块 | 1：是<br />仅为当前模块时存在 |
@ -121,11 +121,11 @@
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | -------------------- | ------------------------------------- |
| id | num | 选项所跳转的模块ID | |
| platform_action | str | 跳转信息文字 | JUMP+{所跳转的模块编号}+{所跳转的CID} |
| id | num | 选项所跳转的模块id | |
| platform_action | str | 跳转信息文字 | JUMP+{所跳转的模块编号}+{所跳转的cid} |
| native_action | str | 点击后对变量运算语句 | 每项间用分号隔开<br />无为空 |
| condition | str | 选项出现条件判断语句 | 无为空 |
| cid | num | 选项所跳转分P的CID | |
| cid | num | 选项所跳转分P的cid | |
| x | num | 选项出现的x坐标 | 仅坐标模式有此项 |
| y | num | 选项出现的y坐标 | 仅坐标模式有此项 |
| text_align | num | 选项文本对齐方式 | |
@ -166,8 +166,8 @@
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| aid | num | 稿件avID | |
| cid | num | 分P CID | |
| aid | num | 稿件avid | |
| cid | num | 分P cid | |
`data`中的`hidden_vars`数组：
@ -193,7 +193,7 @@
查询互动视频`av73267982`下剧情图`155446`模块`5556092`的信息
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/stein/edgeinfo_v2' \
@ -203,7 +203,7 @@ curl -G 'http://api.bilibili.com/x/stein/edgeinfo_v2' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/stein/edgeinfo_v2' \

62
video/like_coin_fav.md
View File

@ -35,8 +35,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） | 必要 | |
@ -54,7 +54,7 @@
点赞视频`av79677524`/`BV1uJ411r7hL`
avID方式：
avid方式：
```shell
curl 'http://api.bilibili.com/x/web-interface/archive/like' \
@ -64,7 +64,7 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl 'http://api.bilibili.com/x/web-interface/archive/like' \
@ -100,7 +100,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回复：**
@ -160,8 +160,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回复：**
@ -178,7 +178,7 @@ curl 'http://app.bilibili.com/x/v2/view/like' \
视频`av39330059`/`BV1Bt411z799`的状态为已点赞
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/web-interface/archive/has/like' \
@ -186,7 +186,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/archive/has/like' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl -G 'api.bilibili.com/x/web-interface/archive/has/like' \
@ -225,8 +225,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） | 必要 | |
@ -252,7 +252,7 @@ data 对象：
为视频`av90671873`/`BV1N7411A7wC`投币2枚
avID方式：
avid方式：
```shell
curl 'http://api.bilibili.com/x/web-interface/coin/add' \
@ -263,7 +263,7 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl 'http://api.bilibili.com/x/web-interface/coin/add' \
@ -303,7 +303,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 |
@ -363,8 +363,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回复：**
@ -387,7 +387,7 @@ curl 'http://app.bilibili.com/x/v2/view/coin/add' \
视频`av37896701`/`BV18t411q7zz`的投币数为2枚
avID方式：
avid方式：
```shell
curl -G 'api.bilibili.com/x/web-interface/archive/coins' \
@ -395,7 +395,7 @@ curl -G 'api.bilibili.com/x/web-interface/archive/coins' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl -G 'api.bilibili.com/x/web-interface/archive/coins' \
@ -440,10 +440,10 @@ 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）分隔 |
| add_media_ids | nums | 需要加入的收藏夹mlid | 非必要 | 同时添加多个，用`,`（%2C）分隔 |
| del_media_ids | nums | 需要取消的收藏夹mlid | 非必要 | 同时取消多个，用`,`（%2C）分隔 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：**
@ -518,7 +518,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回复：**
@ -542,7 +542,7 @@ data 对象：
视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \
@ -550,7 +550,7 @@ curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \
@ -593,8 +593,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回复：**
@ -621,7 +621,7 @@ curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \
将视频`av91003840`/`BV1Wj411f79U`一键三连
avID方式：
avid方式：
```shell
curl 'http://api.bilibili.com/x/web-interface/archive/like/triple' \
@ -630,7 +630,7 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like/triple' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl 'http://api.bilibili.com/x/web-interface/archive/like/triple' \
@ -673,7 +673,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回复：**
@ -738,8 +738,8 @@ curl 'http://app.bilibili.com/x/v2/view/like/triple' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ------------------ |
| 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回复：**

8
video/pbp.md
View File

@ -20,9 +20,9 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| cid | num | 视频CID | 必要 | |
| aid | num | 稿件avID | 非必要 | |
| bvid | num | 稿件bvID | 非必要 | |
| cid | num | 视频cid | 必要 | |
| aid | num | 稿件avid | 非必要 | |
| bvid | num | 稿件bvid | 非必要 | |
**json回复：**
@ -51,7 +51,7 @@
**示例：**
获取视频`CID=3724723`的获取弹幕趋势顶点列表
获取视频`cid=3724723`的获取弹幕趋势顶点列表
```shell
curl -G 'http://api.bilibili.com/pbp/data' \

8
video/recommend.md
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任选一个 |
**json回复：**
@ -47,14 +47,14 @@
查询视频`av7`/`BV1xx411c7m9`的推荐视频列表
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/web-interface/archive/related' \
--data-urlencode 'aid=7'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/web-interface/archive/related' \

18
video/report.md
View File

@ -18,8 +18,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | --------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avID | 必要 | |
| cid | num | 视频CID | 必要 | 用于识别分P |
| aid | num | 稿件avid | 必要 | |
| cid | num | 视频cid | 必要 | 用于识别分P |
| progress | num | 观看进度 | 非必要 | 单位为秒<br />默认为0 |
| platform | str | 平台标识 | 非必要 | 可为android |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@ -36,7 +36,7 @@
**示例：**
记录视频`av13662970`（`CID=126654047`）的观看记录位于`1248`秒
记录视频`av13662970`（`cid=126654047`）的观看记录位于`1248`秒
Cookie方式：
@ -91,12 +91,12 @@ curl 'http://api.bilibili.com/x/v2/history/report' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------------ | ------------ | ------------------------------------------------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 |
| cid | num | 视频CID | 非必要 | 用于识别分P |
| epid | num | 番剧epID | 非必要 | |
| sid | num | 番剧ssID | 非必要 | |
| mid | num | 当前用户UID | 非必要 | |
| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| cid | num | 视频cid | 非必要 | 用于识别分P |
| epid | num | 番剧epid | 非必要 | |
| sid | num | 番剧ssid | 非必要 | |
| mid | num | 当前用户mid | 非必要 | |
| played_time | num | 视频播放进度 | 非必要 | 单位为秒<br />默认为0 |
| realtime | num | 总计播放时间 | 非必要 | 单位为秒 |
| start_ts | num | 开始播放时刻 | 非必要 | 时间戳 |

18
video/snapshot.md
View File

@ -25,9 +25,9 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------ | ------------ | ----------------------------------- |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 |
| cid | num | 分P CID | 非必要 | 默认为1P |
| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| cid | num | 分P cid | 非必要 | 默认为1P |
| index | num | json数组截取时间表 | 非必要 | 1：需要<br />0：不需要<br />默认为0 |
**json回复：**
@ -74,7 +74,7 @@
获取视频`av26273789`/`BV1os411H7wm`的快照
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/player/videoshot' \
@ -82,7 +82,7 @@ curl -G 'http://api.bilibili.com/x/player/videoshot' \
--data-urlencode 'index=1'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/player/videoshot' \
@ -125,8 +125,8 @@ curl -G 'http://api.bilibili.com/x/player/videoshot' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ----------- | ---- |
| appkey | str | APP密钥 | APP方式必要 | |
| aid | num | 稿件avID | 必要 | |
| cid | num | 分P CID | 必要 | |
| aid | num | 稿件avid | 必要 | |
| cid | num | 分P cid | 必要 | |
| ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | APP方式必要 | |
@ -162,7 +162,7 @@ curl -G 'http://api.bilibili.com/x/player/videoshot' \
示例：
获取视频`av26273789`（`CID=49075258`）的快照
获取视频`av26273789`（`cid=49075258`）的快照
```shell
curl -G 'http://app.bilibili.com/x/v2/view/video/shot' \
@ -209,7 +209,7 @@ curl -G 'http://app.bilibili.com/x/v2/view/video/shot' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| aid | num | 稿件avID | 必要 | |
| aid | num | 稿件avid | 必要 | |
**json回复：**

26
video/status_number.md
View File

@ -1,11 +1,11 @@
# 视频状态数
- [视频状态数（仅avID）](#视频状态数（仅avID）)
- [视频状态数（bvID/avID）](#视频状态数（bvID/avID）)
- [视频状态数（仅avid）](#视频状态数（仅avid）)
- [视频状态数（bvid/avid）](#视频状态数（bvid/avid）)
---
## 视频状态数（仅avID）
## 视频状态数（仅avid）
> http://api.bilibili.com/archive_stat/stat
*请求方式：GET*
@ -14,7 +14,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| aid | num | 稿件avID | 必要 | |
| aid | num | 稿件avid | 必要 | |
**json回复：**
@ -31,7 +31,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ------------------------ | ------------------------------ | -------------------- |
| aid | num | 稿件avID | |
| aid | num | 稿件avid | |
| view | 正常：num<br />屏蔽：str | 正常：播放次数<br />屏蔽："--" | |
| danmaku | num | 弹幕条数 | |
| reply | num | 评论条数 | |
@ -49,7 +49,7 @@
查询视频`av91572143`的状态数
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/archive_stat/stat' \
@ -84,7 +84,7 @@ curl -G 'http://api.bilibili.com/archive_stat/stat' \
</details>
## 视频状态数（bvID/avID）
## 视频状态数（bvid/avid）
> http://api.bilibili.com/x/web-interface/archive/stat
@ -96,8 +96,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回复：**
@ -114,8 +114,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 | 评论条数 | |
@ -135,14 +135,14 @@ curl -G 'http://api.bilibili.com/archive_stat/stat' \
查询视频`av2271112`/`BV1es411D7sW`的状态数
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/web-interface/archive/stat' \
--data-urlencode 'aid=2271112'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/web-interface/archive/stat' \

18
video/tags.md
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任选一个 |
**json回复：**
@ -44,7 +44,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | -------------- | ------------------------------------------------------------ |
| tag_id | num | TAGID | |
| tag_id | num | tag_id | |
| tag_name | str | TAG名称 | |
| cover | str | TAG图片url | |
| head_cover | str | TAG页面头图url | |
@ -73,7 +73,7 @@
查询视频`av89772773`/`BV1M741177Kg`的TAG
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/tag/archive/tags' \
@ -81,7 +81,7 @@ curl -G 'http://api.bilibili.com/x/tag/archive/tags' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/tag/archive/tags' \
@ -222,8 +222,8 @@ curl -G 'http://api.bilibili.com/x/tag/archive/tags' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| aid | num | 稿件avID | 必要 | |
| tag_id | num | TAGID | 必要 | |
| aid | num | 稿件avid | 必要 | |
| tag_id | num | tag_id | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@ -275,8 +275,8 @@ curl 'http://api.bilibili.com/x/tag/archive/like2' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| aid | num | 稿件avID | 必要 | |
| tag_id | num | TAGID | 必要 | |
| aid | num | 稿件avid | 必要 | |
| tag_id | num | tag_id | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**

44
video/video_zone.md
View File

@ -1,6 +1,6 @@
# 视频分区一览
用于通过稿件avID判断所在的分区，或推荐分区视频等.......
用于通过稿件avid判断所在的分区，或推荐分区视频等.......
亦可用于更深♂入了解B站的分区
@ -8,7 +8,7 @@
<img src="/imgs/zone/douga.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | --------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 动画（主分区） | douga | 1 | | [/v/douga](https://www.bilibili.com/v/douga) |
| MAD·AMV | mad | 24 | 具有一定制作程度的动画或静画的二次创作视频 | [/v/douga/mad](https://www.bilibili.com/v/douga/mad) |
@ -21,7 +21,7 @@
<img src="/imgs/zone/anime.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ----------- | ---- | -------------------------------------------------- | ------------------------------------------------------------ |
| 番剧（主分区） | anime | 13 | | [/anime](https://www.bilibili.com/anime) |
| 连载动画 | serial | 33 | 当季连载的动画番剧 | [/v/anime/serial](https://www.bilibili.com/v/anime/serial) |
@ -33,7 +33,7 @@
<img src="/imgs/zone/guochuang.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ----------- | ---- | ----------------- | ------------------------------------------------------------ |
| 国创（主分区） | guochuang | 167 | | [/guochuang](https://www.bilibili.com/guochuang) |
| 国产动画 | chinese | 153 | 我国出品的PGC动画 | [/v/guochuang/chinese](https://www.bilibili.com/v/guochuang/chinese) |
@ -46,7 +46,7 @@
<img src="/imgs/zone/music.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ---------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 音乐（主分区） | music | 3 | | [/v/music](https://www.bilibili.com/v/music) |
| 原创音乐 | original | 28 | 个人或团队制作以音乐为主要原创因素的歌曲或纯音乐 | [/v/music/original](https://www.bilibili.com/v/music/original) |
@ -62,7 +62,7 @@
<img src="/imgs/zone/dance.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 舞蹈（主分区） | dance | 129 | | [/v/dance](https://www.bilibili.com/v/dance) |
| 宅舞 | otaku | 20 | 与ACG相关的翻跳、原创舞蹈 | [/v/dance/otaku](https://www.bilibili.com/v/dance/otaku) |
@ -76,7 +76,7 @@
<img src="/imgs/zone/game.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ----------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 游戏（主分区） | game | 4 | | [/v/game](https://www.bilibili.com/v/game) |
| 单机游戏 | stand_alone | 17 | 以所有平台（PC、主机、移动端）的单机或联机游戏为主的视频内容，包括游戏预告、CG、实况解说及相关的评测、杂谈与视频剪辑等 | [/v/game/stand_alone](https://www.bilibili.com/v/game/stand_alone) |
@ -94,7 +94,7 @@
<img src="/imgs/zone/knowledge.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| ---------------------------------------------- | ----------------- | ------ | ------------------------------------------------------ | ------------------------------------------------------------ |
| 知识(主分区) | knowledge | 36 | | [/v/knowledge](https://www.bilibili.com/v/knowledge) |
| 科学科普 | science | 201 | 回答你的十万个为什么 | [/v/knowledge/science](https://www.bilibili.com/v/knowledge/science) |
@ -115,7 +115,7 @@
旧：<img src="/imgs/zone/digital.svg" width="100" height="100"/>新：<img src="/imgs/zone/tech.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------------- | ------------------- | ------- | ---------------------------------------------------------- | ------------------------------------------------------------ |
| 科技(主分区) | tech | 188 | | [/v/tech](https://www.bilibili.com/v/tech) |
| 数码(~~原手机平板~~) | digital | 95 | 科技数码产品大全，一起来做发烧友 | [/v/tech/digital](https://www.bilibili.com/v/tech/digital) |
@ -133,7 +133,7 @@
<img src="/imgs/zone/car.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | -------- | ---- | ------------------------------------------------------------ | ---------------------------------------------------------- |
| 汽车（主分区） | car | 223 | | [/v/car](https://www.bilibili.com/v/car) |
| 汽车生活 | life | 176 | 分享汽车及出行相关的生活体验类视频 | [/v/car/life](https://www.bilibili.com/v/car/life) |
@ -148,7 +148,7 @@
<img src="/imgs/zone/life.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------------- | -------------- | ------- | ------------------------------------------------ | ------------------------------------------------------------ |
| 生活（主分区） | life | 160 | | [/v/life](https://www.bilibili.com/v/life) |
| 搞笑 | funny | 138 | 各种沙雕有趣的搞笑剪辑，挑战，表演，配音等视频 | [/v/life/funny](https://www.bilibili.com/v/life/funny) |
@ -167,7 +167,7 @@
<img src="/imgs/zone/food.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| ------------------------------ | ----------- | ---- | -------------------------------- | ------------------------------------------------------------ |
| 美食（主分区） | food | 211 | | [/v/food](https://www.bilibili.com/v/food) |
| 美食制作（原[生活]->[美食圈]） | make | 76 | 学做人间美味，展示精湛厨艺 | [/v/food/make](https://www.bilibili.com/v/food/make) |
@ -182,7 +182,7 @@
<img src="/imgs/zone/animal.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------- | ---------------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 动物圈 | animal（主分区） | 217 | | [/v/animal](https://www.bilibili.com/v/animal) |
| 喵星人 | cat | 218 | 喵喵喵喵喵 | [/v/animal/cat](https://www.bilibili.com/v/animal/cat) |
@ -196,7 +196,7 @@
<img src="/imgs/zone/kichiku.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | --------------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 鬼畜（主分区） | kichiku | 119 | | [/v/kichiku](https://www.bilibili.com/v/kichiku) |
| 鬼畜调教 | guide | 22 | 使用素材在音频、画面上做一定处理，达到与BGM一定的同步感 | [/v/kichiku/guide](https://www.bilibili.com/v/kichiku/guide) |
@ -209,7 +209,7 @@
<img src="/imgs/zone/fashion.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | -------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 时尚（主分区） | fashion | 155 | | [/v/fashion](https://www.bilibili.com/v/fashion) |
| 美妆 | makeup | 157 | 涵盖妆容、发型、美甲等教程，彩妆、护肤相关产品测评、分享等 | [/v/fashion/makeup](https://www.bilibili.com/v/fashion/makeup) |
@ -226,7 +226,7 @@
<img src="/imgs/zone/information.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ----------- | ---- | -------------------------------------------- | ------------------------------------------------------------ |
| 资讯（主分区） | information | 202 | | [/v/information](https://www.bilibili.com/v/information) |
| 热点 | hotspot | 203 | 全民关注的时政热门资讯 | [/v/information/hotspot](https://www.bilibili.com/v/information/hotspot) |
@ -240,7 +240,7 @@
<img src="/imgs/zone/ad.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| ------------------ | ------ | ------- | ---- | ------------ |
| ~~广告（主分区）~~ | ~~ad~~ | ~~165~~ | | ~~/v/ad~~ |
| ~~广告~~ | ~~ad~~ | ~~166~~ | | ~~/v/ad/ad~~ |
@ -249,7 +249,7 @@
<img src="/imgs/zone/ent.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| ----------------------- | --------- | ------- | ----------------------------------- | -------------------------------------------------------- |
| 娱乐（主分区） | ent | 5 | | [/v/ent](https://www.bilibili.com/v/ent) |
| 综艺 | variety | 71 | 国内外有趣的综艺和综艺相关精彩剪辑 | [/v/ent/variety](https://www.bilibili.com/v/ent/variety) |
@ -260,7 +260,7 @@
<img src="/imgs/zone/cinephile.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ------------ | ---- | -------------------------------- | ------------------------------------------------------------ |
| 影视（主分区） | cinephile | 181 | | [/v/cinephile](https://www.bilibili.com/v/cinephile) |
| 影视杂谈 | cinecism | 182 | 影视评论、解说、吐槽、科普等 | [/v/cinephile/cinecism](https://www.bilibili.com/v/cinephile/cinecism) |
@ -272,7 +272,7 @@
<img src="/imgs/zone/documentary.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| ---------------- | ----------- | ---- | ---- | ------------------------------------------------------------ |
| 纪录片（主分区） | documentary | 177 | | [/documentary](https://www.bilibili.com/documentary) |
| 人文·历史 | history | 37 | | [/v/documentary/history](https://www.bilibili.com/v/documentary/history) |
@ -284,7 +284,7 @@
<img src="/imgs/zone/movie.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ------- | ---- | ---- | ------------------------------------------------------------ |
| 电影（主分区） | movie | 23 | | [/movie](https://www.bilibili.com/movie) |
| 华语电影 | chinese | 147 | | [/v/movie/chinese](https://www.bilibili.com/v/movie/chinese) |
@ -296,7 +296,7 @@
<img src="/imgs/zone/teleplay.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 |
| 名称 | 代号 | tid | 简介 | url路由 |
| ---------------- | -------- | ---- | ---- | -------------------------------------------------------- |
| 电视剧（主分区） | tv | 11 | | [/tv](https://www.bilibili.com/tv) |
| 国产剧 | mainland | 185 | | [/v/tv/mainland](https://www.bilibili.com/v/tv/mainland) |

20
video/videostream_url.md
View File

@ -83,15 +83,15 @@ B站的视频为http流媒体，需要对应的api以视频id获取取流url，
**部分视频**会有**分段**，需要特别注意
若视频有分P，仅为单P的视频的url，换P则需更换CID重新获取
若视频有分P，仅为单P的视频的url，换P则需更换cid重新获取
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------------- | ------------ | ------------------------------------------------------------ |
| avid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 |
| cid | num | 视频CID | 必要 | |
| avid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| cid | num | 视频cid | 必要 | |
| qn | num | 视频清晰度选择 | 非必要 | 未登录默认32（480P）<br />登录默认64（720P）<br />**值含义见上表**<br />注：dash方式无效 |
| fnval | num | 视频获取方式选择 | 非必要 | 默认为0<br />0 2：flv方式（可能会有分段）<br />1：低清mp4方式（仅240P与360P，且限速65K/s）<br />16 80：dash方式（音视频分流，支持H.265） |
| fnver | num | 0 | 非必要 | 固定为0 |
@ -179,9 +179,9 @@ B站的视频为http流媒体，需要对应的api以视频id获取取流url，
**视频无分段时：**
获取视频`av99999999`/`BV1y7411Q7Eq`中的1P（CID=`171776208`）的视频流url，清晰度为1080P+，使用flv方式获取
获取视频`av99999999`/`BV1y7411Q7Eq`中的1P（cid=`171776208`）的视频流url，清晰度为1080P+，使用flv方式获取
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/player/playurl' \
@ -194,7 +194,7 @@ curl -G 'http://api.bilibili.com/x/player/playurl' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/player/playurl' \
@ -417,9 +417,9 @@ curl -G 'http://api.bilibili.com/x/player/playurl' \
**示例：**
获取视频`av969628065`/`BV1rp4y1e745`中的1P（CID=`244954665`）的视频流url，使用dash方式获取
获取视频`av969628065`/`BV1rp4y1e745`中的1P（cid=`244954665`）的视频流url，使用dash方式获取
avID方式：
avid方式：
```shell
curl -G 'http://api.bilibili.com/x/player/playurl' \
@ -432,7 +432,7 @@ curl -G 'http://api.bilibili.com/x/player/playurl' \
-b 'SESSDATA=xxx'
```
bvID方式：
bvid方式：
```shell
curl -G 'http://api.bilibili.com/x/player/playurl' \