shiran/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions 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
Download Patch File Download Diff File Expand all files Collapse all files
APP_widget/splash.md
+3 -3
View File
@@ -53,7 +53,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | --------------------- | ---- | | -------- | ---- | --------------------- | ---- |
| id | num | 开屏图片ID | | | id | num | 开屏图片id | |
| thumb | str | 开屏图片url | | | thumb | str | 开屏图片url | |
| logo_url | str | “bilibili”logo图片url | | | logo_url | str | “bilibili”logo图片url | |
@@ -67,7 +67,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------- | ------------ | | ----------- | ---- | ---------- | ------------ |
| id | num | 开屏图片ID | | | id | num | 开屏图片id | |
| begin_time | num | 起始时间？ | 时间戳 | | begin_time | num | 起始时间？ | 时间戳 |
| end_time | num | 结束时间？ | 时间戳 | | end_time | num | 结束时间？ | 时间戳 |
| probability | num | 0 | 作用尚不明确 | | probability | num | 0 | 作用尚不明确 |
@@ -136,7 +136,7 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
</details> </details>
如ID=11的图片为： 如id=11的图片为：
![]( http://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png ) ![]( http://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png )
README.md
+2 -1
View File
@@ -45,7 +45,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http`
- [API认证与鉴权（APP与Cookie方式）](other/API_auth.md)× - [API认证与鉴权（APP与Cookie方式）](other/API_auth.md)×
- [公共错误码](other/errcode.md)√ - [公共错误码](other/errcode.md)√
- [图片格式化](other/picture.md)√ - [图片格式化](other/picture.md)√
- [bvID说明](other/bvID.md)√ - [bvid说明](other/bvid_desc.md)√
- [grpc接口](grpc_api)× - [grpc接口](grpc_api)×
- [登录](login) - [登录](login)
- [登录操作（人机认证）](login/login_action)√ - [登录操作（人机认证）](login/login_action)√
@@ -79,6 +79,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http`
- [互动视频](video/interact_video.md)× - [互动视频](video/interact_video.md)×
- [高能进度条](video/pbp.md)√ - [高能进度条](video/pbp.md)√
- [信息上报（心跳及记录历史）](video/report.md)× - [信息上报（心跳及记录历史）](video/report.md)×
- [视频属性数据](video/attribute_data.md)√
- [剧集（番剧、影视）](bangumi) - [剧集（番剧、影视）](bangumi)
- [基本信息](bangumi/info.md)× - [基本信息](bangumi/info.md)×
- 状态数 - 状态数
album/action.md
+6 -6
View File
@@ -18,7 +18,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | ---------------------- | | ---------- | ---- | ------------------------ | ------ | ---------------------- |
| doc_id | num | 相簿ID | 必要 | | | doc_id | num | 相簿id | 必要 | |
| type | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 | | type | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 |
| csrf_token | str | CSRF Token（位于cookie） | 非必要 | | | csrf_token | str | CSRF Token（位于cookie） | 非必要 | |
@@ -41,7 +41,7 @@
**示例：** **示例：**
点赞相簿`ID=99184721` 点赞相簿`id=99184721`
```shell ```shell
curl 'http://api.vc.bilibili.com/link_draw/v2/Vote/operate' \ 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 | 必要 | 作用尚不明确 | | biz_type | num | 2 | 必要 | 作用尚不明确 |
| csrf_token | str | CSRF Token（位于cookie） | 非必要 | | | 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 ```shell
curl 'http:///api.vc.bilibili.com/user_plus/v1/Fav/add' \ 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 | 必要 | 作用尚不明确 | | biz_type | num | 2 | 必要 | 作用尚不明确 |
| csrf_token | str | CSRF Token（位于cookie） | 非必要 | | | 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 ```shell
curl 'http://api.vc.bilibili.com/user_plus/v1/Fav/delete' \ curl 'http://api.vc.bilibili.com/user_plus/v1/Fav/delete' \
album/info.md
+5 -5
View File
@@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ---- | | ------ | ---- | ---------- | ------ | ---- |
| doc_id | num | 目标相簿ID | 必要 | | | doc_id | num | 目标相簿id | 必要 | |
**json回复：** **json回复：**
@@ -40,7 +40,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---------- | ---- | | ------------ | ---- | ---------- | ---- |
| uid | num | 作者UID | | | uid | num | 作者mid | |
| head_url | str | 头像url | | | head_url | str | 头像url | |
| name | str | 昵称 | | | name | str | 昵称 | |
| vip | obj | 会员信息 | | | vip | obj | 会员信息 | |
@@ -70,8 +70,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----- | ------------------ | ------------------------------------------------------------ | | ----------------- | ----- | ------------------ | ------------------------------------------------------------ |
| biz | num | 相簿分区 | 1：画友<br />2：摄影<br />3：日常 | | biz | num | 相簿分区 | 1：画友<br />2：摄影<br />3：日常 |
| doc_id | num | 相簿ID | | | doc_id | num | 相簿id | |
| poster_uid | num | 作者UID | | | poster_uid | num | 作者mid | |
| category | str | 子分区标识 | cos：cosplay<br />daily：日常<br />illustration：插画<br />comic：漫画<br />draw：其他<br />sifu：私服 | | category | str | 子分区标识 | cos：cosplay<br />daily：日常<br />illustration：插画<br />comic：漫画<br />draw：其他<br />sifu：私服 |
| type | num | 相簿类型 | 0：原创<br />1：同人 | | type | num | 相簿类型 | 0：原创<br />1：同人 |
| title | str | 标题 | | | title | str | 标题 | |
@@ -140,7 +140,7 @@
**示例：** **示例：**
查询相簿`ID=99184721`的详细信息 查询相簿`id=99184721`的详细信息
```shell ```shell
curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/detail' \ curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/detail' \
album/list.md
+5 -5
View File
@@ -61,7 +61,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------- | ---- | | -------- | ---- | ------- | ---- |
| uid | num | 作者UID | | | uid | num | 作者mid | |
| head_url | str | 头像url | | | head_url | str | 头像url | |
| name | str | 昵称 | | | name | str | 昵称 | |
@@ -69,8 +69,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------- | ----- | ---------- | --------------------------------- | | ------------- | ----- | ---------- | --------------------------------- |
| doc_id | num | 相簿ID | | | doc_id | num | 相簿id | |
| poster_uid | num | 作者UID | | | poster_uid | num | 作者mid | |
| pictures | array | 相簿图片 | | | pictures | array | 相簿图片 | |
| title | str | 标题 | | | title | str | 标题 | |
| category | 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 | | biz | num | 分区 | 非必要 | 0：全部<br />1：画友<br/>2：摄影<br />默认为0 |
| poster_uid | num | 作者UID | 必要 | 默认为20 | | poster_uid | num | 作者mid | 必要 | 默认为20 |
| page_num | num | 页码 | 非必要 | 默认为1 | | page_num | num | 页码 | 非必要 | 默认为1 |
| page_size | num | 每页项数 | 非必要 | 默认为45 | | 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 | | | head_url | str | 头像url | |
| name | str | 昵称 | | | name | str | 昵称 | |
album/recommend_author.md
+1 -1
View File
@@ -40,7 +40,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------- | ------------ | | ----------- | ---- | ------- | ------------ |
| uid | num | 作者UID | | | uid | num | 作者mid | |
| head_url | str | 头像url | | | head_url | str | 头像url | |
| name | str | 昵称 | | | name | str | 昵称 | |
| is_followed | num | 0 | 作用尚不明确 | | is_followed | num | 0 | 作用尚不明确 |
article/articles.md
+5 -5
View File
@@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- | | ------ | ---- | -------- | ------ | ---- |
| id | num | 文集rlID | 必要 | | | id | num | 文集rlid | 必要 | |
**json回复：** **json回复：**
@@ -43,8 +43,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | --------------- | ------------ | | -------------- | ---- | --------------- | ------------ |
| id | num | 文集rlID | | | id | num | 文集rlid | |
| mid | num | 文集作者UID | | | mid | num | 文集作者mid | |
| name | str | 文集名称 | | | name | str | 文集名称 | |
| image_url | str | 文集封面图片url | | | image_url | str | 文集封面图片url | |
| update_time | num | 文集更新时间 | 时间戳 | | update_time | num | 文集更新时间 | 时间戳 |
@@ -70,7 +70,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | -------------- | ------------------------------------------------------------ | | ------------ | ----- | -------------- | ------------------------------------------------------------ |
| id | num | 专栏cvID | | | id | num | 专栏cvid | |
| title | str | 文章标题 | | | title | str | 文章标题 | |
| state | num | 0 | 作用尚不明确 | | state | num | 0 | 作用尚不明确 |
| publish_time | num | 发布时间 | 秒时间戳 | | publish_time | num | 发布时间 | 秒时间戳 |
@@ -99,7 +99,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | -------------- | ---- | | --------------- | ---- | -------------- | ---- |
| mid | num | 作者UID | | | mid | num | 作者mid | |
| name | str | 作者昵称 | | | name | str | 作者昵称 | |
| face | str | 作者头像url | | | face | str | 作者头像url | |
| official_verify | obj | 作者认证信息 | | | official_verify | obj | 作者认证信息 | |
article/info.md
+4 -4
View File
@@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- | | ------ | ---- | -------- | ------ | ---- |
| id | num | 专栏cvID | 必要 | | | id | num | 专栏cvid | 必要 | |
**json回复：** **json回复：**
@@ -40,7 +40,7 @@
| stats | obj | 状态数信息 | | | stats | obj | 状态数信息 | |
| title | str | 文章标题 | | | title | str | 文章标题 | |
| banner_url | str | 文章头图url | | | banner_url | str | 文章头图url | |
| mid | num | 文章作者UID | | | mid | num | 文章作者mid | |
| author_name | str | 文章作者昵称 | | | author_name | str | 文章作者昵称 | |
| is_author | bool | true | 作用尚不明确 | | is_author | bool | true | 作用尚不明确 |
| image_urls | array | 动态封面 | | | image_urls | array | 动态封面 | |
@@ -49,8 +49,8 @@
| show_later_watch | bool | true | 作用尚不明确 | | show_later_watch | bool | true | 作用尚不明确 |
| show_small_window | bool | true | 作用尚不明确 | | show_small_window | bool | true | 作用尚不明确 |
| in_list | bool | 是否收于文集 | false：否<br />true：是 | | in_list | bool | 是否收于文集 | false：否<br />true：是 |
| pre | num | 上一篇文章cvID | 无为0 | | pre | num | 上一篇文章cvid | 无为0 |
| next | num | 下一篇文章cvID | 无为0 | | next | num | 下一篇文章cvid | 无为0 |
| share_channels | array | 分享方式列表 | | | share_channels | array | 分享方式列表 | |
`stats`对象： `stats`对象：
article/like_coin_fav.md
+3 -3
View File
@@ -20,7 +20,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---------------------- | | ------ | ---- | ------------------- | ------ | ---------------------- |
| id | num | 文章cvID | 必要 | | | id | num | 文章cvid | 必要 | |
| type | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 | | type | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | 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 | | multiply | num | 投币数量 | 必要 | 上限为2 |
| avtype | num | 2 | 必要 | 必须为2 | | avtype | num | 2 | 必要 | 必须为2 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | 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） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
audio/coin&fav.md
+2 -2
View File
@@ -19,7 +19,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- | | ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | | | sid | num | 音频auid | 必要 | |
**json回复：** **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回复：** **json回复：**
audio/info.md
+15 -15
View File
@@ -19,7 +19,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- | | ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | | | sid | num | 音频auid | 必要 | |
**json回复：** **json回复：**
@@ -35,8 +35,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ------ | ------------------ | ------------------ | | ---------- | ------ | ------------------ | ------------------ |
| id | num | 音频auID | | | id | num | 音频auid | |
| uid | num | UP主UID | | | uid | num | UP主mid | |
| uname | str | UP主昵称 | | | uname | str | UP主昵称 | |
| author | str | 作者名 | | | author | str | 作者名 | |
| title | str | 歌曲标题 | | | title | str | 歌曲标题 | |
@@ -47,9 +47,9 @@
| duration | num | 歌曲时间长度 | 单位为秒 | | duration | num | 歌曲时间长度 | 单位为秒 |
| passtime | num | 歌曲发布时间 | 时间戳 | | passtime | num | 歌曲发布时间 | 时间戳 |
| curtime | num | 当前请求时间 | 时间戳 | | curtime | num | 当前请求时间 | 时间戳 |
| aid | num | 关联稿件avID | 无为0 | | aid | num | 关联稿件avid | 无为0 |
| bvid | str | 关联稿件bvID | 无为空 | | bvid | str | 关联稿件bvid | 无为空 |
| cid | num | 关联视频CID | 无为0 | | cid | num | 关联视频cid | 无为0 |
| msid | num | 0 | **作用尚不明确** | | msid | num | 0 | **作用尚不明确** |
| attr | num | 0 | **作用尚不明确** | | attr | num | 0 | **作用尚不明确** |
| limit | num | 0 | **作用尚不明确** | | limit | num | 0 | **作用尚不明确** |
@@ -58,14 +58,14 @@
| ctime | null | - | **作用尚不明确** | | ctime | null | - | **作用尚不明确** |
| statistic | obj | 状态数 | | | statistic | obj | 状态数 | |
| vipInfo | obj | UP主会员状态 | | | vipInfo | obj | UP主会员状态 | |
| collectIds | array | 歌曲所在的收藏夹ID | 需要登录(SESSDATA) | | collectIds | array | 歌曲所在的收藏夹mlid | 需要登录(SESSDATA) |
| coin_num | num | 投币数 | | | coin_num | num | 投币数 | |
`data`中的`statistic`对象： `data`中的`statistic`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---- | | ------- | ---- | -------- | ---- |
| sid | num | 音频auID | | | sid | num | 音频auid | |
| play | num | 播放次数 | | | play | num | 播放次数 | |
| collect | num | 收藏数 | | | collect | num | 收藏数 | |
| comment | num | 评论数 | | | comment | num | 评论数 | |
@@ -84,8 +84,8 @@
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------------- | ---- | | ---- | ---- | ------------------------- | ---- |
| 0 | num | 第1个所在的收藏夹ID | | | 0 | num | 第1个所在的收藏夹mlid | |
| n | num | 第（n+1）个所在的收藏夹ID | | | n | num | 第（n+1）个所在的收藏夹mlid | |
| …… | num | …… | …… | | …… | 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回复：** **json回复：**
@@ -186,7 +186,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/song/info' \
| ------- | ---- | ---------- | ---------------- | | ------- | ---- | ---------- | ---------------- |
| type | str | song | **作用尚不明确** | | type | str | song | **作用尚不明确** |
| subtype | num | ？？？ | **作用尚不明确** | | subtype | num | ？？？ | **作用尚不明确** |
| key | num | TAG ID？？ | **作用尚不明确** | | key | num | TAG id？？ | **作用尚不明确** |
| info | str | TAG名 | | | 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回复：** **json回复：**
@@ -299,7 +299,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/tag/song' \
| --------- | ---- | ---------- | ---------------- | | --------- | ---- | ---------- | ---------------- |
| mid | num | 0 | **作用尚不明确** | | mid | num | 0 | **作用尚不明确** |
| name | str | 成员名 | | | 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回复：** **json回复：**
audio/music_list.md
+16 -16
View File
@@ -47,16 +47,16 @@
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | ---- | | ---- | ---- | ----------------- | ---- |
| 0 | obj | 音频收藏夹ID1 | | | 0 | obj | 音频收藏夹mlid1 | |
| n | obj | 音频收藏夹ID(n+1) | | | n | obj | 音频收藏夹mlid(n+1) | |
| …… | obj | …… | …… | | …… | obj | …… | …… |
`data`数组中的对象： `data`数组中的对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | ------------------------ | -------------------------------- | | --------- | ------ | ------------------------ | -------------------------------- |
| id | num | 音频收藏夹ID | | | id | num | 音频收藏夹mlid | |
| uid | num | 创建用户UID | | | uid | num | 创建用户mid | |
| uname | str | 创建用户昵称 | | | uname | str | 创建用户昵称 | |
| title | str | 歌单标题 | | | title | str | 歌单标题 | |
| type | num | 收藏夹属性 | 0：普通收藏夹<br />1：默认收藏夹 | | type | num | 收藏夹属性 | 0：普通收藏夹<br />1：默认收藏夹 |
@@ -66,22 +66,22 @@
| song | num | 歌单中的音乐数量 | | | song | num | 歌单中的音乐数量 | |
| desc | str | 歌单备注信息 | | | desc | str | 歌单备注信息 | |
| sids | array | 歌单中的音乐 | | | sids | array | 歌单中的音乐 | |
| menuId | num | 音频收藏夹对应的歌单amID | | | menuId | num | 音频收藏夹对应的歌单amid | |
| statistic | obj | 歌单状态数信息 | | | statistic | obj | 歌单状态数信息 | |
`data`中的`sids`数组： `data`中的`sids`数组：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------- | ---------------- | | ---- | ---- | ------------------- | ---------------- |
| 0 | num | 收藏的音频auID1 | | | 0 | num | 收藏的音频auid1 | |
| n | num | 收藏的音频auID(n+1) | 按照歌单顺序排列 | | n | num | 收藏的音频auid(n+1) | 按照歌单顺序排列 |
| …… | num | …… | …… | | …… | num | …… | …… |
`data`中的`statistic`对象： `data`中的`statistic`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------------------ | ---- | | ------- | ---- | ------------------------ | ---- |
| sid | num | 音频收藏夹对应的歌单amID | | | sid | num | 音频收藏夹对应的歌单amid | |
| play | num | 播放次数 | | | play | num | 播放次数 | |
| collect | num | 点赞次数 | | | collect | num | 点赞次数 | |
| comment | null | - | | | 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回复：** **json回复：**
@@ -204,8 +204,8 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | ------------------------ | ---------------------- | | --------- | ------ | ------------------------ | ---------------------- |
| id | num | 音频收藏夹ID | | | id | num | 音频收藏夹mlid | |
| uid | num | 创建用户UID | | | uid | num | 创建用户mid | |
| uname | str | 创建用户昵称 | | | uname | str | 创建用户昵称 | |
| title | str | 默认歌单 | 恒为`默认歌单` | | title | str | 默认歌单 | 恒为`默认歌单` |
| type | num | 1 | 恒为`1` | | type | num | 1 | 恒为`1` |
@@ -215,22 +215,22 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \
| song | num | 歌单中的音乐数量 | | | song | num | 歌单中的音乐数量 | |
| desc | str | 空 | 恒为空 | | desc | str | 空 | 恒为空 |
| sids | array | 歌单中的音乐 | | | sids | array | 歌单中的音乐 | |
| menuId | num | 音频收藏夹对应的歌单amID | 与普通歌单不同通用 | | menuId | num | 音频收藏夹对应的歌单amid | 与普通歌单不同通用 |
| statistic | obj | 歌单状态数信息 | | | statistic | obj | 歌单状态数信息 | |
`data`中的`sids`数组： `data`中的`sids`数组：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------- | ---------------- | | ---- | ---- | ------------------- | ---------------- |
| 0 | num | 收藏的音频auID1 | | | 0 | num | 收藏的音频auid1 | |
| n | num | 收藏的音频auID(n+1) | 按照歌单顺序排列 | | n | num | 收藏的音频auid(n+1) | 按照歌单顺序排列 |
| …… | num | …… | …… | | …… | num | …… | …… |
`data`中的`statistic`对象： `data`中的`statistic`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------------------ | ---- | | ------- | ---- | ------------------------ | ---- |
| sid | num | 音频收藏夹对应的歌单amID | | | sid | num | 音频收藏夹对应的歌单amid | |
| play | num | 0 | | | play | num | 0 | |
| collect | num | 0 | | | collect | num | 0 | |
| comment | null | - | | | comment | null | - | |
@@ -238,7 +238,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \
**示例：** **示例：**
查询我的默认歌单，ID为` 15967839 ` 查询我的默认歌单，id为` 15967839 `
```shell ```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/info' \ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/info' \
audio/musicstream_url.md
+5 -5
View File
@@ -31,7 +31,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- | | ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | | | sid | num | 音频auid | 必要 | |
**json回复：** **json回复：**
@@ -47,7 +47,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | --------- | --------------------------------------- | | --------- | ----- | --------- | --------------------------------------- |
| sid | num | 音频auID | | | sid | num | 音频auid | |
| type | num | 音质标识 | -1：试听片段（192K）<br />1：192K | | type | num | 音质标识 | -1：试听片段（192K）<br />1：192K |
| info | str | 空 | **作用尚不明确** | | info | str | 空 | **作用尚不明确** |
| timeout | num | 有效时长 | 单位为秒<br />一般为3h | | 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| songid | num | 音频auID | 必要 | | | songid | num | 音频auid | 必要 | |
| quality | num | 音质代码 | 必要 | **详情见上表** | | quality | num | 音质代码 | 必要 | **详情见上表** |
| privilege | num | 必须为`2` | 必要 | | | privilege | num | 必须为`2` | 必要 | |
| mid | num | 当前用户UID | 必要 | 可为任意值 | | mid | num | 当前用户mid | 必要 | 可为任意值 |
| platform | str | 平台标识 | 必要 | 可为任意值 | | platform | str | 平台标识 | 必要 | 可为任意值 |
**json回复：** **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 | | type | num | 音质标识 | -1：试听片段（192K）<br />0：128K<br />1：192K<br />2：320K<br />3：FLAC |
| info | str | 空 | **作用尚不明确** | | info | str | 空 | **作用尚不明确** |
| timeout | num | 有效时长 | 单位为秒<br />一般为3h | | timeout | num | 有效时长 | 单位为秒<br />一般为3h |
audio/status_number.md
+2 -2
View File
@@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- | | ------ | ---- | -------- | ------ | ---- |
| sid | num | 音频auID | 必要 | | | sid | num | 音频auid | 必要 | |
**json回复：** **json回复：**
@@ -32,7 +32,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---- | | ------- | ---- | -------- | ---- |
| sid | num | 音频auID | | | sid | num | 音频auid | |
| play | num | 播放次数 | | | play | num | 播放次数 | |
| collect | num | 收藏数 | | | collect | num | 收藏数 | |
| comment | num | 评论数 | | | comment | num | 评论数 | |
bangumi/info.md
+21 -21
View File
@@ -1,11 +1,11 @@
# 剧集基本信息 # 剧集基本信息
- [剧集基本信息（mdID方式）](#剧集基本信息（mdID方式）) - [剧集基本信息（mdid方式）](#剧集基本信息（mdid方式）)
- [获取剧集明细（web端）（ssID/epID方式）](#获取剧集明细（web端）（ssID/epID方式）) - [获取剧集明细（web端）（ssid/epid方式）](#获取剧集明细（web端）（ssid/epid方式）)
--- ---
## 剧集基本信息（mdID方式） ## 剧集基本信息（mdid方式）
> http://api.bilibili.com/pgc/review/user > http://api.bilibili.com/pgc/review/user
@@ -18,7 +18,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | -------- | ------ | ---- | | -------- | ---- | -------- | ------ | ---- |
| media_id | str | 剧集mdID | 必要 | | | media_id | str | 剧集mdid | 必要 | |
**json回复：** **json回复：**
@@ -43,10 +43,10 @@
| --------- | ----- | -------------- | -------------------------- | | --------- | ----- | -------------- | -------------------------- |
| areas | array | 地区 | | | areas | array | 地区 | |
| cover | str | 封面图片url | | | cover | str | 封面图片url | |
| media_id | num | 剧集mdID | | | media_id | num | 剧集mdid | |
| new_ep | obj | 最新一话信息 | | | new_ep | obj | 最新一话信息 | |
| rating | obj | 评分信息 | | | rating | obj | 评分信息 | |
| season_id | int | 剧集ssID | | | season_id | int | 剧集ssid | |
| share_url | url | 剧集详情页连接 | | | share_url | url | 剧集详情页连接 | |
| title | str | 标题 | | | title | str | 标题 | |
| type_name | str | 剧集类型 | `番剧`、`国创`、`电影`等等 | | type_name | str | 剧集类型 | `番剧`、`国创`、`电影`等等 |
@@ -70,7 +70,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------- | -------------------------- | | ---------- | ---- | ---------------- | -------------------------- |
| id | int | 最新一话的epID | | | id | int | 最新一话的epid | |
| index | str | 最新一话名称 | | | index | str | 最新一话名称 | |
| index_show | str | 最新一话显示名称 | eg. `第1话`、`更新至第4话` | | index_show | str | 最新一话显示名称 | eg. `第1话`、`更新至第4话` |
@@ -139,7 +139,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
</details> </details>
## 获取剧集明细（web端）（ssID/epID方式） ## 获取剧集明细（web端）（ssid/epid方式）
> http://api.bilibili.com/pgc/view/web/season > 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任选其一 | | season_id | num | 番剧ssid | 必要（可选） | season_id与ep_id任选其一 |
| ep_id | num | 剧集epID | 必要（可选） | season_id与ep_id任选其一 | | ep_id | num | 剧集epid | 必要（可选） | season_id与ep_id任选其一 |
**json回复：** **json回复：**
@@ -175,7 +175,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| evaluate | str | 简介 | | | evaluate | str | 简介 | |
| jp_title | str | 空 | 作用尚不明确 | | jp_title | str | 空 | 作用尚不明确 |
| link | str | 简介页面url | | | link | str | 简介页面url | |
| media_id | num | 剧集mdID | | | media_id | num | 剧集mdid | |
| mode | num | 2 | 作用尚不明确 | | mode | num | 2 | 作用尚不明确 |
| new_ep | obj | 更新信息 | | | new_ep | obj | 更新信息 | |
| payment | obj | 会员&付费信息 | 若无相关内容则无此项 | | payment | obj | 会员&付费信息 | 若无相关内容则无此项 |
@@ -184,7 +184,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| rating | obj | 评分信息 | 若无相关内容则无此项 | | rating | obj | 评分信息 | 若无相关内容则无此项 |
| record | str | 备案号 | 无则为空 | | record | str | 备案号 | 无则为空 |
| rights | obj | 属性标志信息 | | | rights | obj | 属性标志信息 | |
| season_id | num | 番剧ssID | | | season_id | num | 番剧ssid | |
| season_title | str | 剧集标题 | | | season_title | str | 剧集标题 | |
| seasons | array | 同系列所以季信息 | | | seasons | array | 同系列所以季信息 | |
| section | array | 花絮、PV、番外等非正片内容 | 若无相关内容则无此项 | | 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 | str | 标签文字 | 例如`会员`、`限免`等 |
| badge_info | obj | | | | badge_info | obj | | |
| badge_type | num | | | | badge_type | num | | |
| bvid | str | 单集稿件bvID | | | bvid | str | 单集稿件bvid | |
| cid | num | 视频CID | | | cid | num | 视频cid | |
| cover | str | 单集封面url | | | cover | str | 单集封面url | |
| dimension | obj | 分辨率信息 | | | dimension | obj | 分辨率信息 | |
| from | str | | | | from | str | | |
| id | num | 单集epID | | | id | num | 单集epid | |
| link | str | 单集网页url | | | link | str | 单集网页url | |
| long_title | str | 单集完整标题 | | | long_title | str | 单集完整标题 | |
| pub_time | num | 发布时间 | 时间戳 | | pub_time | num | 发布时间 | 时间戳 |
@@ -244,7 +244,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| status | num | | | | status | num | | |
| subtitle | str | 单集副标题 | 观看次数文字 | | subtitle | str | 单集副标题 | 观看次数文字 |
| title | 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 | 更新备注 | | | desc | str | 更新备注 | |
| id | num | 最新一话epID | | | id | num | 最新一话epid | |
| is_new | num | 是否最新发布 | 0：否<br />1：是 | | is_new | num | 是否最新发布 | 0：否<br />1：是 |
| title | str | 最新一话标题 | | | title | str | 最新一话标题 | |
@@ -365,7 +365,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| ---------- | ----- | -------- | ---- | | ---------- | ----- | -------- | ---- |
| episode_id | num | 0 | | | episode_id | num | 0 | |
| episodes | array | 板块内容 | | | episodes | array | 板块内容 | |
| id | num | 板块ID？ | | | id | num | 板块id？ | |
| title | str | 板块标题 | | | title | str | 板块标题 | |
| type | num | ？ | | | 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 | 系列名 | | | series_title | str | 系列名 | |
`result`中的`show`对象： `result`中的`show`对象：
@@ -411,7 +411,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \
| avatar | str | 头像图片url | | | avatar | str | 头像图片url | |
| follower | num | 粉丝数 | | | follower | num | 粉丝数 | |
| is_follow | num | 0 | | | is_follow | num | 0 | |
| mid | num | UP主UID | | | mid | num | UP主mid | |
| pendant | obj | | | | pendant | obj | | |
| theme_type | num | 0 | | | theme_type | num | 0 | |
| uname | str | UP主昵称 | | | uname | str | UP主昵称 | |
blackroom/banlist.md
+7 -7
View File
@@ -95,10 +95,10 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | --------------- | ---------------------------- | | ------------------- | ---- | --------------- | ---------------------------- |
| id | num | 封禁公示ID | | | id | num | 封禁公示id | |
| uname | str | 对象用户名 | | | uname | str | 对象用户名 | |
| face | str | 对象用户头像url | | | face | str | 对象用户头像url | |
| uid | num | 对象用户UID | | | uid | num | 对象用户mid | |
| originTitle | str | 来源标题 | | | originTitle | str | 来源标题 | |
| blockedRemark | str | | | | blockedRemark | str | | |
| originUrl | str | 来源url | | | originUrl | str | 来源url | |
@@ -117,7 +117,7 @@
| reasonType | num | 违规类型 | **见上表** | | reasonType | num | 违规类型 | **见上表** |
| reasonTypeName | str | 违规类型名称 | | | reasonTypeName | str | 违规类型名称 | |
| operatorName | str | 空 | 作用尚不明确 | | operatorName | str | 空 | 作用尚不明确 |
| caseId | num | 仲裁信息ID | 系统封禁时固定为0 | | caseId | num | 仲裁信息id | 系统封禁时固定为0 |
| ctime | num | 创建时间 | 时间戳 | | ctime | num | 创建时间 | 时间戳 |
| commentSum | num | 该条目评论数 | | | commentSum | num | 该条目评论数 | |
@@ -210,7 +210,7 @@ curl -G 'http://api.bilibili.com/x/credit/blocked/list' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ---- | | ------ | ---- | ---------- | ------ | ---- |
| id | num | 封禁公示ID | 必要 | | | id | num | 封禁公示id | 必要 | |
**json回复：** **json回复：**
@@ -227,10 +227,10 @@ curl -G 'http://api.bilibili.com/x/credit/blocked/list' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | --------------- | ---------------------------- | | ------------------- | ---- | --------------- | ---------------------------- |
| id | num | 封禁公示ID | | | id | num | 封禁公示id | |
| uname | str | 对象用户名 | | | uname | str | 对象用户名 | |
| face | str | 对象用户头像url | | | face | str | 对象用户头像url | |
| uid | num | 对象用户UID | | | uid | num | 对象用户mid | |
| originTitle | str | 来源标题 | | | originTitle | str | 来源标题 | |
| blockedRemark | str | | | | blockedRemark | str | | |
| originUrl | str | 来源url | | | originUrl | str | 来源url | |
@@ -255,7 +255,7 @@ curl -G 'http://api.bilibili.com/x/credit/blocked/list' \
**示例：** **示例：**
查询公示ID为`1091621`的公示详情 查询公示id为`1091621`的公示详情
```shell ```shell
curl -G 'http://api.bilibili.com/x/credit/blocked/info' \ curl -G 'http://api.bilibili.com/x/credit/blocked/info' \
blackroom/jury/action.md
+2 -2
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)」中表 | | vote | num | 投票类型 | 必要 | 见「[众裁信息](judgement_info.md)」中表 |
| content | str | 理由 | 非必要 | 见「[众裁信息](judgement_info.md)」中表 | | content | str | 理由 | 非必要 | 见「[众裁信息](judgement_info.md)」中表 |
| likes | nums | 支持的观点 | 非必要 | | | likes | nums | 支持的观点 | 非必要 | |
blackroom/jury/judgement_info.md
+13 -13
View File
@@ -32,7 +32,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ------------ | ------ | ------------- | ------------- | | ------ | ------------ | ------ | ------------- | ------------- |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| cid | num | 案件ID | 必要 | | | cid | num | 案件id | 必要 | |
**json回复：** **json回复：**
@@ -49,8 +49,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | -------- | ------------ | | --------- | ------ | -------- | ------------ |
| id | num | 案件ID | | | id | num | 案件id | |
| mid | num | 被举报用户UID | | | mid | num | 被举报用户mid | |
| status | num | 裁决状态 | 1：投票中<br />2：停止发放<br />3：复核中（结案中）<br />4：已裁决<br />5：待重启<br />6：未裁决<br />7：冻结中<br />8：队列中 | | status | num | 裁决状态 | 1：投票中<br />2：停止发放<br />3：复核中（结案中）<br />4：已裁决<br />5：待重启<br />6：未裁决<br />7：冻结中<br />8：队列中 |
| statusTitle | str | 封禁时间文字 | `judgeType`=1时有效 | | statusTitle | str | 封禁时间文字 | `judgeType`=1时有效 |
| originType | num | 来源类型 | 见「封禁公示」中表 | | originType | num | 来源类型 | 见「封禁公示」中表 |
@@ -70,7 +70,7 @@
| ctime | num | 举报创建时间 | 时间戳 | | ctime | num | 举报创建时间 | 时间戳 |
| mtime | num | 开始拉取时间 | 时间戳 | | mtime | num | 开始拉取时间 | 时间戳 |
| originTitle | str | 来源标题 | | | originTitle | str | 来源标题 | |
| relationId | str | 违规关系标识字 | ｛评论rpID｝-｛违规类型ID｝-｛来源对象ID｝ | | relationId | str | 违规关系标识字 | {评论rpid}-{违规类型id}-{来源对象id} |
| face | str | 被举报用户头像url | | | face | str | 被举报用户头像url | |
| uname | str | 被举报用户昵称 | | | uname | str | 被举报用户昵称 | |
| vote | num | 我的投票 | **见上表** | | vote | num | 我的投票 | **见上表** |
@@ -149,7 +149,7 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------ | ------ | ---- | | ------ | ---- | ------ | ------ | ---- |
| cid | num | 案件ID | 必要 | | | cid | num | 案件id | 必要 | |
**json回复：** **json回复：**
@@ -166,8 +166,8 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ----------------- | ------------------------------------------------------------ | | ------------- | ---- | ----------------- | ------------------------------------------------------------ |
| id | num | 案件ID | | | id | num | 案件id | |
| mid | num | 被举报用户UID | | | mid | num | 被举报用户mid | |
| status | num | 裁决状态 | 1：投票中<br />2：停止发放<br />3：复核中（结案中）<br />4：已裁决<br />5：待重启<br />6：未裁决<br />7：冻结中<br />8：队列中 | | status | num | 裁决状态 | 1：投票中<br />2：停止发放<br />3：复核中（结案中）<br />4：已裁决<br />5：待重启<br />6：未裁决<br />7：冻结中<br />8：队列中 |
| originType | num | 来源类型 | 见「封禁公示」中表 | | originType | num | 来源类型 | 见「封禁公示」中表 |
| reasonType | num | 原因类型 | 见「封禁公示」中表 | | reasonType | num | 原因类型 | 见「封禁公示」中表 |
@@ -185,7 +185,7 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
| ctime | num | 举报创建时间 | 时间戳 | | ctime | num | 举报创建时间 | 时间戳 |
| mtime | num | 开始拉取时间 | 时间戳 | | mtime | num | 开始拉取时间 | 时间戳 |
| originTitle | str | 来源标题 | | | originTitle | str | 来源标题 | |
| relationId | str | 违规关系标识字 | ｛评论rpID｝-｛违规类型ID｝-｛来源对象ID｝ | | relationId | str | 违规关系标识字 | {评论rpid}-{违规类型id}-{来源对象id} |
| face | str | 被举报用户头像url | | | face | str | 被举报用户头像url | |
| uname | str | 被举报用户昵称 | | | uname | str | 被举报用户昵称 | |
| vote | num | 0 | 固定为0 | | vote | num | 0 | 固定为0 |
@@ -278,8 +278,8 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ----------------- | ------------------------------------------------------------ | | ------------- | ---- | ----------------- | ------------------------------------------------------------ |
| id | num | 案件ID | | | id | num | 案件id | |
| mid | num | 被举报用户UID | | | mid | num | 被举报用户mid | |
| status | num | 裁决状态 | 1：投票中<br />2：停止发放<br />3：复核中（结案中）<br />4：已裁决<br />5：待重启<br />6：未裁决<br />7：冻结中<br />8：队列中 | | status | num | 裁决状态 | 1：投票中<br />2：停止发放<br />3：复核中（结案中）<br />4：已裁决<br />5：待重启<br />6：未裁决<br />7：冻结中<br />8：队列中 |
| originType | num | 来源类型 | 见「封禁公示」中表 | | originType | num | 来源类型 | 见「封禁公示」中表 |
| reasonType | num | 原因类型 | 见「封禁公示」中表 | | reasonType | num | 原因类型 | 见「封禁公示」中表 |
@@ -298,7 +298,7 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \
| ctime | num | 举报创建时间 | 时间戳 | | ctime | num | 举报创建时间 | 时间戳 |
| mtime | num | 开始拉取时间 | 时间戳 | | mtime | num | 开始拉取时间 | 时间戳 |
| originTitle | str | 来源标题 | | | originTitle | str | 来源标题 | |
| relationId | str | 违规关系标识字 | ｛评论rpID｝-｛违规类型ID｝-｛来源对象ID｝ | | relationId | str | 违规关系标识字 | {评论rpid}-{违规类型id}-{来源对象id} |
| face | str | 被举报用户头像url | | | face | str | 被举报用户头像url | |
| uname | str | 被举报用户昵称 | | | uname | str | 被举报用户昵称 | |
| vote | num | 我的投票 | **见上表** | | vote | num | 我的投票 | **见上表** |
@@ -413,10 +413,10 @@ curl -G 'http://api.bilibili.com/x/credit/jury/caseList' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ------ | -------- | ------------ | | --------- | ------ | -------- | ------------ |
| mid | num | 用户UID | 仅非匿名有此项 | | mid | num | 用户mid | 仅非匿名有此项 |
| face | str | 用户头像 | 仅非匿名有此项 | | face | str | 用户头像 | 仅非匿名有此项 |
| name | str | 用户昵称 | 仅非匿名有此项 | | name | str | 用户昵称 | 仅非匿名有此项 |
| opid | num | 观点ID | | | opid | num | 观点id | |
| vote | num | 投票选择 | **见上表** | | vote | num | 投票选择 | **见上表** |
| content | str | 观点内容 | | | content | str | 观点内容 | |
| attr | num | 是否匿名 | 0：匿名<br />1：不匿名 | | attr | num | 是否匿名 | 0：匿名<br />1：不匿名 |
broadcast/video_room.md
+3 -3
View File
@@ -16,7 +16,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ------ | -------- | ------------------------------ | | -------- | ------ | -------- | ------------------------------ |
| room_id | str | 目标视频 | `video://{稿件avID}/{视频CID}` | | room_id | str | 目标视频 | `video://{稿件avid}/{视频cid}` |
| platform | str | 平台标识 | 默认为`web` | | platform | str | 平台标识 | 默认为`web` |
| accepts | array | 操作标识 | | | 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............| 00000000 00 00 00 55 00 12 00 01 00 00 00 07 00 00 00 01 |...U............|
@@ -105,7 +105,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------ | ------------------------------ | | ------- | ---- | ------------ | ------------------------------ |
| online | num | 实时观看人数 | | | online | num | 实时观看人数 | |
| room_id | str | 目标视频 | `video://{稿件avID}/{视频CID}` | | room_id | str | 目标视频 | `video://{稿件avid}/{视频cid}` |
**示例：** **示例：**
cheese/info.md
+17 -17
View File
@@ -5,17 +5,17 @@
--- ---
课程ssID与epID和番剧不互通 课程ssid与epid和番剧不互通
课程avID与普通视频绝大部分api接口不能互通，少部分互通接口如下： 课程avid与普通视频绝大部分api接口不能互通，少部分互通接口如下：
1. 获取视频简介 1. 获取视频简介
2. 查询视频状态数 2. 查询视频状态数
3. 查询分P列表 3. 查询分P列表
4. 视频快照 4. 视频快照
5. 获取弹幕（使用CID） 5. 获取弹幕（使用cid）
6. 发送弹幕 6. 发送弹幕
7. 高能进度条（使用CID） 7. 高能进度条（使用cid）
## 获取课程基本信息 ## 获取课程基本信息
@@ -31,8 +31,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------- | ------------ | -------------------------------------------------- | | --------- | ---- | -------- | ------------ | -------------------------------------------------- |
| season_id | num | 课程ssID | 必要（可选） | season_id与ep_id任选其一<br />**与番剧ssID不互通** | | season_id | num | 课程ssid | 必要（可选） | season_id与ep_id任选其一<br />**与番剧ssid不互通** |
| ep_id | num | 课程epID | 必要（可选） | season_id与ep_id任选其一<br />**与番剧epID不互通** | | ep_id | num | 课程epid | 必要（可选） | season_id与ep_id任选其一<br />**与番剧epid不互通** |
**json回复：** **json回复：**
@@ -63,7 +63,7 @@
| release_info | str | 更新状态文字+更新连载状态文字 | | | release_info | str | 更新状态文字+更新连载状态文字 | |
| release_info2 | str | 更新连载状态文字 | | | release_info2 | str | 更新连载状态文字 | |
| release_status | str | 更新状态文字 | | | release_status | str | 更新状态文字 | |
| season_id | num | 课程ssID | **与番剧ssID不互通** | | season_id | num | 课程ssid | **与番剧ssid不互通** |
| share_url | str | 页面url | | | share_url | str | 页面url | |
| short_link | str | bilibili uri链接 | | | short_link | str | bilibili uri链接 | |
| stat | obj | 播放数信息 | | | stat | obj | 播放数信息 | |
@@ -129,11 +129,11 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------------------------------------------ | | -------------- | ---- | ---------------- | ------------------------------------------------------------ |
| aid | num | 课程分集avID | **与普通稿件avID部分不互通** | | aid | num | 课程分集avid | **与普通稿件avid部分不互通** |
| cid | num | 课程分集CID | **与普通视频CID部分不互通** | | cid | num | 课程分集cid | **与普通视频cid部分不互通** |
| duration | num | 课程分集时间长度 | 单位为秒 | | duration | num | 课程分集时间长度 | 单位为秒 |
| from | str | pugv | | | from | str | pugv | |
| id | num | 课程分集epID | **与番剧epID不互通** | | id | num | 课程分集epid | **与番剧epid不互通** |
| index | num | 课程分集数 | | | index | num | 课程分集数 | |
| page | num | 1 | | | page | num | 1 | |
| play | num | 课程分集播放量 | | | play | num | 课程分集播放量 | |
@@ -240,7 +240,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------------ | -------- | | ------------- | ---- | ------------------ | -------- |
| last_ep_id | num | 最后观看的epID | | | last_ep_id | num | 最后观看的epid | |
| last_ep_index | str | 最后观看的标题 | | | last_ep_index | str | 最后观看的标题 | |
| last_time | num | 最后观看的时间进度 | 单位为秒 | | last_time | num | 最后观看的时间进度 | 单位为秒 |
@@ -248,7 +248,7 @@
查询课程`ss61`或分集`ep790`的信息 查询课程`ss61`或分集`ep790`的信息
ssID方式： ssid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/pugv/view/web/season' \ 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' -e 'https://www.bilibili.com'
``` ```
epID方式： epid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/pugv/view/web/season' \ 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 | | ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 | | pn | num | 页码 | 非必要 | 默认为1 |
@@ -511,11 +511,11 @@ curl -G 'http://api.bilibili.com/pugv/view/web/season' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------------------------------------------ | | -------------- | ---- | ---------------- | ------------------------------------------------------------ |
| aid | num | 课程分集avID | **与普通稿件avID部分不互通** | | aid | num | 课程分集avid | **与普通稿件avid部分不互通** |
| cid | num | 课程分集CID | **与普通视频CID部分不互通** | | cid | num | 课程分集cid | **与普通视频cid部分不互通** |
| duration | num | 课程分集时间长度 | 单位为秒 | | duration | num | 课程分集时间长度 | 单位为秒 |
| from | str | pugv | | | from | str | pugv | |
| id | num | 课程分集epID | **与番剧epID不互通** | | id | num | 课程分集epid | **与番剧epid不互通** |
| index | num | 课程分集数 | | | index | num | 课程分集数 | |
| page | num | 1 | | | page | num | 1 | |
| play | num | 课程分集播放量 | | | play | num | 课程分集播放量 | |
cheese/videostream_url.md
+4 -4
View File
@@ -23,9 +23,9 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------- | ------ | ------------------------------------------------------------ | | ------ | ---- | -------------- | ------ | ------------------------------------------------------------ |
| avid | num | 课程avID | 必要 | | | avid | num | 课程avid | 必要 | |
| ep_id | num | 课程epID | 必要 | | | ep_id | num | 课程epid | 必要 | |
| cid | num | 视频CID | 必要 | | | cid | num | 视频cid | 必要 | |
| qn | num | 视频清晰度选择 | 非必要 | 参考[qn定义](../video/videostream_url.md#qn视频清晰度标识) | | qn | num | 视频清晰度选择 | 非必要 | 参考[qn定义](../video/videostream_url.md#qn视频清晰度标识) |
| fnver | num | 视频流版本 | 非必要 | 参考[fnver定义](../video/videostream_url.md#fnver视频流版本标识) | | fnver | num | 视频流版本 | 非必要 | 参考[fnver定义](../video/videostream_url.md#fnver视频流版本标识) |
| fnval | num | 视频流类型 | 非必要 | 参考[fnval定义](../video/videostream_url.md#fnval视频流格式标识) | | 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 ```shell
curl -G 'http://api.bilibili.com/pugv/player/web/playurl' \ curl -G 'http://api.bilibili.com/pugv/player/web/playurl' \
clientinfo/ip.md
+1 -1
View File
@@ -32,7 +32,7 @@
| isp | str | 运营商名 | | | isp | str | 运营商名 | |
| latitude | num | 纬度 | | | latitude | num | 纬度 | |
| longitude | num | 经度 | | | longitude | num | 经度 | |
| zone_id | num | ip数据库ID | | | zone_id | num | ip数据库id | |
| country_code | num | 国家/地区代码 | | | country_code | num | 国家/地区代码 | |
**示例：** **示例：**
comment/action.md
+26 -26
View File
@@ -23,9 +23,9 @@
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ | | ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| root | num | 根评论rpID | 非必要 | 二级评论以上使用 | | root | num | 根评论rpid | 非必要 | 二级评论以上使用 |
| parent | num | 父评论rpID | 非必要 | 二级评论同根评论ID<br />大于二级评论为要回复的评论ID | | parent | num | 父评论rpid | 非必要 | 二级评论同根评论id<br />大于二级评论为要回复的评论id |
| message | str | 发送评论内容 | 必要 | 最大1000字符<br />表情使用表情转义符 | | message | str | 发送评论内容 | 必要 | 最大1000字符<br />表情使用表情转义符 |
| plat | num | 发送平台标识 | 非必要 | 1：web端<br />2：安卓客户端<br />3：ios客户端<br />4：wp客户端<br />默认为1 | | plat | num | 发送平台标识 | 非必要 | 1：web端<br />2：安卓客户端<br />3：ios客户端<br />4：wp客户端<br />默认为1 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@@ -49,14 +49,14 @@
| success_toast | str | 状态文字 | | | success_toast | str | 状态文字 | |
| need_captcha | bool | false | 评论需要验证码(未证实) | | need_captcha | bool | false | 评论需要验证码(未证实) |
| url | str | 空 | **作用尚不明确** | | url | str | 空 | **作用尚不明确** |
| rpid | num | 评论rpID | | | rpid | num | 评论rpid | |
| rpid_str | str | 评论rpID | 字串格式 | | rpid_str | str | 评论rpid | 字串格式 |
| dialog | num | 回复对方rpID | 若为一级评论则为0<br />若为二级评论则为该评论ID<br />大于二级评论为上一级评论ID | | dialog | num | 回复对方rpid | 若为一级评论则为0<br />若为二级评论则为该评论id<br />大于二级评论为上一级评论id |
| dialog_str | str | 回复对方rpID | 字串格式 | | dialog_str | str | 回复对方rpid | 字串格式 |
| root | num | 根评论rpID | 若为一级评论则为0<br />大于一级评论则为根评论ID | | root | num | 根评论rpid | 若为一级评论则为0<br />大于一级评论则为根评论id |
| root_str | str | 根评论rpID | 字串格式 | | root_str | str | 根评论rpid | 字串格式 |
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论ID<br />大于二级评论为上一级评论ID | | parent | num | 回复父评论rpid | 若为一级评论则为0<br />若为二级评论则为根评论id<br />大于二级评论为上一级评论id |
| parent_str | str | 回复父评论rpID | 字串格式 | | parent_str | str | 回复父评论rpid | 字串格式 |
| emote | obj | 表情转义符信息 | [对象定义见表](readme.md#评论条目对象) | | emote | obj | 表情转义符信息 | [对象定义见表](readme.md#评论条目对象) |
| reply | 有效时：obj<br />无效时：null | | [对象定义见表](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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpID | 必要 | | | rpid | num | 目标评论rpid | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消赞<br />1：点赞 | | action | num | 操作代码 | 非必要 | 默认为0<br />0：取消赞<br />1：点赞 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | 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 ```shell
curl 'http://api.bilibili.com/x/v2/reply/action' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpID | 必要 | | | rpid | num | 目标评论rpid | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消踩<br />1：点踩 | | action | num | 操作代码 | 非必要 | 默认为0<br />0：取消踩<br />1：点踩 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | 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 ```shell
curl 'http://api.bilibili.com/x/v2/reply/hate' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpID | 必要 | | | rpid | num | 目标评论rpid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：** **json回复：**
@@ -381,7 +381,7 @@ curl 'http://api.bilibili.com/x/v2/reply/hate' \
**示例：** **示例：**
删除`av243322853`下评论`rpID=3039053308` 删除`av243322853`下评论`rpid=3039053308`
```shell ```shell
curl 'http://api.bilibili.com/x/v2/reply/del' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpID | 必要 | | | rpid | num | 目标评论rpid | 必要 | |
| action | num | 操作代码 | 非必要 | 默认为0<br />0：取消置顶<br />1：设为置顶 | | action | num | 操作代码 | 非必要 | 默认为0<br />0：取消置顶<br />1：设为置顶 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | 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 ```shell
curl 'http://api.bilibili.com/x/v2/reply/top' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| rpid | num | 目标评论rpID | 必要 | | | rpid | num | 目标评论rpid | 必要 | |
| reason | num | 举报类型 | 必要 | **类型代码见下表** | | reason | num | 举报类型 | 必要 | **类型代码见下表** |
| content | str | 其他举报备注 | 非必要 | `reason=0`时有效 | | content | str | 其他举报备注 | 非必要 | `reason=0`时有效 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | 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 ```shell
curl 'http://api.bilibili.com/x/v2/reply/report' \ curl 'http://api.bilibili.com/x/v2/reply/report' \
comment/list.md
+23 -23
View File
@@ -23,7 +23,7 @@
| ---------- | ---- | -------------- | ----------- | -------------------------------------------------------- | | ---------- | ---- | -------------- | ----------- | -------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) | | type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1：按点赞数<br />2：按回复数 | | sort | num | 排序方式 | 非必要 | 默认为0<br />0：按时间<br />1：按点赞数<br />2：按回复数 |
| nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 | | nohot | num | 是否不显示热评 | 非必要 | 默认为0<br />1：不显示<br />0：显示 |
| pn | num | 页码 | 非必要 | 默认为1 | | pn | num | 页码 | 非必要 | 默认为1 |
@@ -102,7 +102,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | ---------- | -------------------------------------- | | ---- | ----------------------------- | ---------- | -------------------------------------- |
| mid | num | UP主UID | | | mid | num | UP主mid | |
| top | 有效时：obj<br />无效时：null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) | | top | 有效时：obj<br />无效时：null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | 有效时：obj<br />无效时：null | 投票评论？ | | | vote | 有效时：obj<br />无效时：null | 投票评论？ | |
@@ -111,7 +111,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | --------------- | ---- | | ------- | ---- | --------------- | ---- |
| content | str | 公告正文 | | | content | str | 公告正文 | |
| id | num | 公告ID | | | id | num | 公告id | |
| link | str | 公告页面链接url | | | link | str | 公告页面链接url | |
| title | str | 公告标题 | | | title | str | 公告标题 | |
@@ -2342,7 +2342,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \
| ---------- | ---- | -------------- | ----------- | ------------------------------------------------------------ | | ---------- | ---- | -------------- | ----------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) | | type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| mode | num | 排序方式 | 非必要 | 默认为0<br />0 3：仅按热度<br />1：按热度+按时间<br />2：仅按时间 | | mode | num | 排序方式 | 非必要 | 默认为0<br />0 3：仅按热度<br />1：按热度+按时间<br />2：仅按时间 |
| next | num | 评论页选择 | 非必要 | 按热度时：热度顺序页码（0为第一页）<br />按时间时：时间倒序楼层号<br />默认为0 | | next | num | 评论页选择 | 非必要 | 按热度时：热度顺序页码（0为第一页）<br />按时间时：时间倒序楼层号<br />默认为0 |
| ps | num | 每页项数 | 非必要 | 默认为20<br />定义域：1-49 | | 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`对象： `data`中的`notice`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | --------------- | ---- | | ------- | ---- | --------------- | ---- |
| content | str | 公告正文 | | | content | str | 公告正文 | |
| id | num | 公告ID | | | id | num | 公告id | |
| link | str | 公告页面链接url | | | link | str | 公告页面链接url | |
| title | str | 公告标题 | | | title | str | 公告标题 | |
@@ -4724,8 +4724,8 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
| ---------- | ---- | ---------------- | ----------- | ---------------------------------------- | | ---------- | ---- | ---------------- | ----------- | ---------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) | | type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| root | num | 目标一级评论rpID | 必要 | | | root | num | 目标一级评论rpid | 必要 | |
| pn | num | 二级评论页码 | 非必要 | 默认为1 | | pn | num | 二级评论页码 | 非必要 | 默认为1 |
| ps | num | 二级评论每页项数 | 非必要 | 默认为20<br />定义域：1-49 | | ps | num | 二级评论每页项数 | 非必要 | 默认为20<br />定义域：1-49 |
@@ -4750,7 +4750,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
| replies | array | 二级评论列表 | | | replies | array | 二级评论列表 | |
| root | obj | 根评论 | [对象定义见表](readme.md#评论条目对象) | | root | obj | 根评论 | [对象定义见表](readme.md#评论条目对象) |
| show_bvid | bool | true | **作用尚不明确** | | show_bvid | bool | true | **作用尚不明确** |
| upper | obj | UP主UID | | | upper | obj | UP主mid | |
`data`中的`page`对象： `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 ```shell
curl -G 'http://api.bilibili.com/x/v2/reply/reply' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) | | type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| root | num | 根回复rpID | 必要 | | | root | num | 根回复rpid | 必要 | |
| next | num | 评论页选择 | 非必要 | 第一页为0<br />默认为0<br />顺序楼层号 | | next | num | 评论页选择 | 非必要 | 第一页为0<br />默认为0<br />顺序楼层号 |
| ps | num | 每页项数 | 非必要 | 默认为0 | | ps | num | 每页项数 | 非必要 | 默认为0 |
@@ -5488,7 +5488,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
| vote | num | 0 | **作用尚不明确** | | vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** | | lottery | num | 0 | **作用尚不明确** |
| config | obj | 评论区显示控制 | | | config | obj | 评论区显示控制 | |
| upper | obj | UP主UID | | | upper | obj | UP主mid | |
| show_bvid | bool | true | **作用尚不明确** | | show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | | | control | obj | 评论区输入属性 | |
| root | obj | 根评论 | [对象定义见表](readme.md#评论条目对象) | | 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`对象： `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 ```shell
curl -G 'http://api.bilibili.com/x/v2/reply/detail' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) | | type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
| root | num | 根回复rpID | 必要 | | | root | num | 根回复rpid | 必要 | |
| dialog | num | 对话树根rpID | 必要 | | | dialog | num | 对话树根rpid | 必要 | |
| size | num | 每页最大项数 | 必要 | | | size | num | 每页最大项数 | 必要 | |
**json回复：** **json回复：**
@@ -6247,7 +6247,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
| vote | num | 0 | **作用尚不明确** | | vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** | | lottery | num | 0 | **作用尚不明确** |
| config | obj | 评论区显示控制 | | | config | obj | 评论区显示控制 | |
| upper | obj | UP主UID | | | upper | obj | UP主mid | |
| show_bvid | bool | true | **作用尚不明确** | | show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | | | 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`对象： `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 ```shell
curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor' \ 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#评论区类型代码)** | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** |
| oid | num | 目标评论区ID | 必要 | | | oid | num | 目标评论区id | 必要 | |
**json回复：** **json回复：**
comment/readme.md
+29 -29
View File
@@ -17,40 +17,40 @@
| 代码 | 评论区类型 | oid的意义 | | 代码 | 评论区类型 | oid的意义 |
| ---- | ----------------------- | ---------- | | ---- | ----------------------- | ---------- |
| 1 | 视频稿件 | 稿件avID | | 1 | 视频稿件 | 稿件avid |
| 2 | 话题 | 话题ID | | 2 | 话题 | 话题id |
| 4 | 活动 | 活动ID | | 4 | 活动 | 活动id |
| 5 | 小视频 | 小视频ID | | 5 | 小视频 | 小视频id |
| 6 | 小黑屋封禁信息 | 封禁公示ID | | 6 | 小黑屋封禁信息 | 封禁公示id |
| 7 | 公告信息 | 公告ID | | 7 | 公告信息 | 公告id |
| 8 | 直播活动 | 直播间ID | | 8 | 直播活动 | 直播间id |
| 9 | 活动稿件 | | | 9 | 活动稿件 | |
| 10 | 直播公告 | | | 10 | 直播公告 | |
| 11 | 相簿（图片动态） | 相簿ID | | 11 | 相簿（图片动态） | 相簿id |
| 12 | 专栏 | 专栏cvID | | 12 | 专栏 | 专栏cvid |
| 13 | 票务 | | | 13 | 票务 | |
| 14 | 音频 | 音频auID | | 14 | 音频 | 音频auid |
| 15 | 风纪委员会 | 众裁项目ID | | 15 | 风纪委员会 | 众裁项目id |
| 16 | 点评 | | | 16 | 点评 | |
| 17 | 动态（纯文字动态&分享） | 动态ID | | 17 | 动态（纯文字动态&分享） | 动态id |
| 18 | 播单 | | | 18 | 播单 | |
| 19 | 音乐播单 | | | 19 | 音乐播单 | |
| 20 | 漫画 | | | 20 | 漫画 | |
| 21 | 漫画 | | | 21 | 漫画 | |
| 22 | 漫画 | 漫画mcID | | 22 | 漫画 | 漫画mcid |
| 33 | 课程 | 课程epID | | 33 | 课程 | 课程epid |
## 评论条目对象 ## 评论条目对象
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ | | ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ |
| rpid | num | 评论rpID | | | rpid | num | 评论rpid | |
| oid | num | 评论区对象id | | | oid | num | 评论区对象id | |
| type | num | 评论区类型代码 | **类型代码见上表** | | type | num | 评论区类型代码 | **类型代码见上表** |
| mid | num | 发送者UID | | | mid | num | 发送者mid | |
| root | num | 根评论rpID | 若为一级评论则为0<br />大于一级评论则为根评论ID | | root | num | 根评论rpid | 若为一级评论则为0<br />大于一级评论则为根评论id |
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论rpID<br />大于二级评论为上一级评论rpID | | parent | num | 回复父评论rpid | 若为一级评论则为0<br />若为二级评论则为根评论rpid<br />大于二级评论为上一级评论rpid |
| dialog | num | 回复对方rpID | 若为一级评论则为0<br />若为二级评论则为该评论rpID<br />大于二级评论为上一级评论rpID | | dialog | num | 回复对方rpid | 若为一级评论则为0<br />若为二级评论则为该评论rpid<br />大于二级评论为上一级评论rpid |
| count | num | 二级评论条数 | | | count | num | 二级评论条数 | |
| rcount | num | 回复评论条数 | | | rcount | num | 回复评论条数 | |
| floor | num | 评论楼层号 | **注：若不支持楼层则无此项** | | floor | num | 评论楼层号 | **注：若不支持楼层则无此项** |
@@ -58,9 +58,9 @@
| fansgrade | num | 是否具有粉丝标签 | 0：无<br />1：有 | | fansgrade | num | 是否具有粉丝标签 | 0：无<br />1：有 |
| attr | num | 某属性位？ | **作用尚不明确** | | attr | num | 某属性位？ | **作用尚不明确** |
| ctime | num | 评论发送时间 | 时间戳 | | ctime | num | 评论发送时间 | 时间戳 |
| rpid_str | str | 评论rpID | 字串格式 | | rpid_str | str | 评论rpid | 字串格式 |
| root_str | str | 根评论rpID | 字串格式 | | root_str | str | 根评论rpid | 字串格式 |
| parent_str | str | 回复父评论rpID | 字串格式 | | parent_str | str | 回复父评论rpid | 字串格式 |
| like | num | 评论获赞数 | | | like | num | 评论获赞数 | |
| action | num | 当前用户操作状态 | 需要登录(Cookie或APP) <br />否则恒为0<br />0：无<br />1：已点赞<br />2：已点踩 | | action | num | 当前用户操作状态 | 需要登录(Cookie或APP) <br />否则恒为0<br />0：无<br />1：已点赞<br />2：已点踩 |
| member | obj | 评论发送者信息 | | | member | obj | 评论发送者信息 | |
@@ -75,7 +75,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ----------------------------- | ---------------------- | ------------------------------------------------------------ | | --------------- | ----------------------------- | ---------------------- | ------------------------------------------------------------ |
| mid | str | 发送者UID | | | mid | str | 发送者mid | |
| uname | str | 发送者昵称 | | | uname | str | 发送者昵称 | |
| sex | str | 发送者性别 | 男 女 保密 | | sex | str | 发送者性别 | 男 女 保密 |
| sign | str | 发送者签名 | | | sign | str | 发送者签名 | |
@@ -155,8 +155,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | -------------------- | | ------------- | ---- | ------------ | -------------------- |
| uid | num | 用户UID | | | uid | num | 用户mid | |
| medal_id | num | 粉丝标签ID | **详细说明有待补充** | | medal_id | num | 粉丝标签id | **详细说明有待补充** |
| medal_name | str | 粉丝标签名 | | | medal_name | str | 粉丝标签名 | |
| score | num | 0 | **作用尚不明确** | | score | num | 0 | **作用尚不明确** |
| level | num | 当前标签等级 | | | level | num | 当前标签等级 | |
@@ -176,7 +176,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------- | ------------------------------------- | | -------- | ---- | ------------- | ------------------------------------- |
| id | num | 头像框ID | | | id | num | 头像框id | |
| name | str | 头像框名称 | | | name | str | 头像框名称 | |
| image | str | 头像框图片url | | | image | str | 头像框图片url | |
| jump_url | str | 空 | | | jump_url | str | 空 | |
@@ -186,7 +186,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ----------------------- | ------------------------------------- | | -------- | ---- | ----------------------- | ------------------------------------- |
| id | num | 评论条目装扮ID | | | id | num | 评论条目装扮id | |
| name | str | 评论条目装扮名称 | | | name | str | 评论条目装扮名称 | |
| image | str | 评论条目装扮图片url | | | image | str | 评论条目装扮图片url | |
| jump_url | str | 评论条目装扮商城页面url | | | jump_url | str | 评论条目装扮商城页面url | |
@@ -234,8 +234,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | -------------------------------------------------------- | | ---------- | ---- | ------------ | -------------------------------------------------------- |
| id | num | 表情ID | | | id | num | 表情id | |
| package_id | num | 表情包ID | | | package_id | num | 表情包id | |
| state | num | 0 | | | state | num | 0 | |
| type | num | 表情类型 | 1：免费<br />2：会员专属<br />3：购买所得<br />4：颜文字 | | type | num | 表情类型 | 1：免费<br />2：会员专属<br />3：购买所得<br />4：颜文字 |
| attr | num | 0 | **作用尚不明确** | | attr | num | 0 | **作用尚不明确** |
creativecenter/railgun.md
+1 -1
View File
@@ -31,7 +31,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ----------- | ---------------- | | ------ | ---- | ----------- | ---------------- |
| mid | num | 当前用户UID | | | mid | num | 当前用户mid | |
| state | num | 电磁力等级 | | | state | num | 电磁力等级 | |
| reason | str | 空 | **作用尚不明确** | | reason | str | 空 | **作用尚不明确** |
creativecenter/statistics&data.md
+2 -2
View File
@@ -503,8 +503,8 @@ curl -G 'http://member.bilibili.com/x/web/data/article/thirty' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------- | ------------ | | ----------- | ---- | -------------- | ------------ |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
| bvid | str | 稿件bvID | | | bvid | str | 稿件bvid | |
| daytime | num | 统计时间 | 时间戳 | | daytime | num | 统计时间 | 时间戳 |
| incr | num | 稿件增长情况数 | | | incr | num | 稿件增长情况数 | |
| interactive | num | 0 | 作用尚不明确 | | interactive | num | 0 | 作用尚不明确 |
danmaku/action.md
+45 -45
View File
@@ -31,10 +31,10 @@
| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ | | ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 弹幕类选择 | 必要 | 1：视频弹幕 | | type | num | 弹幕类选择 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | | | oid | num | 视频cid | 必要 | |
| msg | str | 弹幕内容 | 必要 | 长度小于100字符 | | msg | str | 弹幕内容 | 必要 | 长度小于100字符 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 | | progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
| color | num | 弹幕颜色设置 | 非必要 | 十进制RGB888值<br />默认为16777215（#FFFFFF）白色 | | color | num | 弹幕颜色设置 | 非必要 | 十进制RGB888值<br />默认为16777215（#FFFFFF）白色 |
| fontsize | num | 弹幕字号设置 | 非必要 | 默认为25<br />极小：12<br />超小：16<br />小：18<br />标准：25<br />大：36<br />超大：45<br />极大：64 | | fontsize | num | 弹幕字号设置 | 非必要 | 默认为25<br />极小：12<br />超小：16<br />小：18<br />标准：25<br />大：36<br />超大：45<br />极大：64 |
@@ -59,13 +59,13 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ------------ | | -------- | ---- | -------- | ------------ |
| action | str | 空 | 作用尚不明确 | | action | str | 空 | 作用尚不明确 |
| dmid | num | 弹幕dmID | | | dmid | num | 弹幕dmid | |
| dmid_str | str | 弹幕dmID | 字串形式 | | dmid_str | str | 弹幕dmid | 字串形式 |
| visible | bool | true | 作用尚不明确 | | visible | bool | true | 作用尚不明确 |
**示例：** **示例：**
为视频`av2`/`BV1xx411c7mD`（CID为`62131`）的5000ms位置发送一条弹幕`前来考古`（颜色为#FFFFFF，字号25，普通弹幕，游动弹幕） 为视频`av2`/`BV1xx411c7mD`（cid为`62131`）的5000ms位置发送一条弹幕`前来考古`（颜色为#FFFFFF，字号25，普通弹幕，游动弹幕）
```shell ```shell
curl 'http://api.bilibili.com/x/v2/dm/post' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 互动弹幕类型 | 必要 | 1：UP主头像弹幕<br />2：关联视频弹幕<br />5：视频内嵌引导关注按钮 | | type | num | 互动弹幕类型 | 必要 | 1：UP主头像弹幕<br />2：关联视频弹幕<br />5：视频内嵌引导关注按钮 |
| aid | num | 稿件avID | 必要 | | | aid | num | 稿件avid | 必要 | |
| cid | num | 视频CID | 必要 | | | cid | num | 视频cid | 必要 | |
| progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 | | progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒<br />默认为0 |
| plat | num | 平台标识 | 必要 | 1：web端<br />2：安卓端<br />8：视频管理页面 | | plat | num | 平台标识 | 必要 | 1：web端<br />2：安卓端<br />8：视频管理页面 |
| data | str | json序列 | 必要 | | | data | str | json序列 | 必要 | |
| dmid | num | 修改互动弹幕的弹幕ID | 非必要 | 注：修改弹幕`plat`必须为8 | | dmid | num | 修改互动弹幕的弹幕id | 非必要 | 注：修改弹幕`plat`必须为8 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
`data`参数json序列： `data`参数json序列：
@@ -145,7 +145,7 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | ---- | | ---- | ---- | -------------- | ---- |
| msg | str | 弹幕内容 | | | 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 | | message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | | | ttl | num | 1 | |
| data | 正确时：obj<br />错误时：null | 信息本体 | | | 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# | | command | str | 指令？ | UP主头像弹幕：#UP#<br />关联视频弹幕：#LINK#<br />视频内嵌引导关注按钮：#ATTENTION# |
| content | str | 弹幕内容 | | | content | str | 弹幕内容 | |
| extra | str | 弹幕数据 | json序列 | | extra | str | 弹幕数据 | json序列 |
| id | num | 弹幕dmID | | | id | num | 弹幕dmid | |
| idStr | str | 弹幕dmID | 字串形式 | | idStr | str | 弹幕dmid | 字串形式 |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| oid | num | 视频CID | | | oid | num | 视频cid | |
| progress | num | 弹幕出现在视频内的时间 | | | progress | num | 弹幕出现在视频内的时间 | |
| type | num | 互动弹幕类型 | 1：UP主头像弹幕<br />2：关联视频弹幕<br />5：视频内嵌引导关注按钮 | | 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 | 关联视频的标题 | | | 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 ```shell
curl 'http://api.bilibili.com/x/v2/dm/command/post' \ 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> </details>
为视频`av201947622`（CID为`230709860`）的5000ms位置发送一条发送关联视频弹幕`测试1234`关联视频为`BV1kz4y1X7XP` 为视频`av201947622`（cid为`230709860`）的5000ms位置发送一条发送关联视频弹幕`测试1234`关联视频为`BV1kz4y1X7XP`
```shell ```shell
curl 'http://api.bilibili.com/x/v2/dm/command/post' \ 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> </details>
为视频`av201947622`（CID为`230709860`）的5000ms位置发送视频内嵌引导关注按钮，X坐标为118，Y坐标为82，持续时间为5000ms 为视频`av201947622`（cid为`230709860`）的5000ms位置发送视频内嵌引导关注按钮，X坐标为118，Y坐标为82，持续时间为5000ms
```shell ```shell
curl 'http://api.bilibili.com/x/v2/dm/command/post' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| dmid | num | 弹幕dmID | 必要 | | | dmid | num | 弹幕dmid | 必要 | |
| cid | num | 视频CID | 必要 | | | cid | num | 视频cid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：** **json回复：**
@@ -353,7 +353,7 @@ curl 'http://api.bilibili.com/x/v2/dm/command/post' \
**示例：** **示例：**
撤回`CID=168901231`下的弹幕`32310301474947077`的弹幕 撤回`cid=168901231`下的弹幕`32310301474947077`的弹幕
```shell ```shell
curl 'http://api.bilibili.com/x/dm/recall' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| mode | str | sp | 必要 | | | mode | str | sp | 必要 | |
| cid | num | 视频CID | 必要 | | | cid | num | 视频cid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：** **json回复：**
@@ -406,7 +406,7 @@ curl 'http://api.bilibili.com/x/dm/recall' \
示例： 示例：
购买视频CID为`168901231`的高级弹幕发送权限 购买视频cid为`168901231`的高级弹幕发送权限
```shell ```shell
curl 'http://api.bilibili.com/x/dm/adv/buy' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| mode | str | sp | 必要 | | | mode | str | sp | 必要 | |
| cid | num | 视频CID | 必要 | | | cid | num | 视频cid | 必要 | |
**json回复：** **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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| oid | num | 视频CID | 必要 | | | oid | num | 视频cid | 必要 | |
| ids | nums | 弹幕dmID列表 | 必要 | 多个ID之间用`,`分隔 | | ids | nums | 弹幕dmid列表 | 必要 | 多个id之间用`,`分隔 |
**json回复** **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对应的信息 | | | …… | obj | 弹幕id对应的信息 | |
`{弹幕ID}`对象： `{弹幕id}`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | -------- | ------------------------------------------------------------ | | --------- | ---- | -------- | ------------------------------------------------------------ |
| likes | num | 点赞数 | | | likes | num | 点赞数 | |
| user_like | num | 是否点赞 | 0：未点赞<br />1：已点赞<br />需要登录(Cookie或APP) <br />未登录恒为0 | | 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 ```shell
curl -G 'http://api.bilibili.com/x/v2/dm/thumbup/stats' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| dmid | num | 弹幕dmID | 必要 | | | dmid | num | 弹幕dmid | 必要 | |
| oid | num | 视频CID | 必要 | | | oid | num | 视频cid | 必要 | |
| op | num | 操作 | 必要 | 1：点赞<br />2：取消点赞 | | op | num | 操作 | 必要 | 1：点赞<br />2：取消点赞 |
| platform | str | 平台 | 非必要 | | | platform | str | 平台 | 非必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | 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 ```shell
curl 'http://api.bilibili.com/x/v2/dm/thumbup/add' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| cid | num | 视频CID | 必要 | | | cid | num | 视频cid | 必要 | |
| dmid | num | 弹幕dmID | 必要 | | | dmid | num | 弹幕dmid | 必要 | |
| reason | num | 举报类型 | 必要 | **类型代码见下表** | | reason | num | 举报类型 | 必要 | **类型代码见下表** |
| content | str | 其他举报备注 | 非必要 | `reason=11`时有效 | | content | str | 其他举报备注 | 非必要 | `reason=11`时有效 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | 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 ```shell
curl 'http://api.bilibili.com/x/dm/report/add' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 弹幕类选择 | 必要 | 1：视频弹幕 | | type | num | 弹幕类选择 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | | | oid | num | 视频cid | 必要 | |
| dmids | nums | 弹幕dmID | 必要 | 多个ID之间用`,`分隔 | | dmids | nums | 弹幕dmid | 必要 | 多个id之间用`,`分隔 |
| state | num | 操作代码 | 必要 | 1：删除弹幕<br />2：弹幕保护<br />3：取消保护 | | state | num | 操作代码 | 必要 | 1：删除弹幕<br />2：弹幕保护<br />3：取消保护 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | 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 ```shell
curl 'http://api.bilibili.com/x/v2/dm/edit/state' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| type | num | 弹幕类选择 | 必要 | 1：视频弹幕 | | type | num | 弹幕类选择 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | | | oid | num | 视频cid | 必要 | |
| dmids | nums | 弹幕dmID | 必要 | 多个ID之间用`,`分隔 | | dmids | nums | 弹幕dmid | 必要 | 多个id之间用`,`分隔 |
| pool | num | 操作代码 | 必要 | 0：移出字幕池<br />1：移入字幕池 | | pool | num | 操作代码 | 必要 | 0：移出字幕池<br />1：移入字幕池 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | 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 ```shell
curl 'http://api.bilibili.com/x/v2/dm/edit/state' \ curl 'http://api.bilibili.com/x/v2/dm/edit/state' \
danmaku/danmaku_proto.md
+6 -6
View File
@@ -31,8 +31,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | -------- | ------ | ----------- | | ------------- | ---- | -------- | ------ | ----------- |
| type | num | 弹幕类 | 必要 | 1：视频弹幕 | | type | num | 弹幕类 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | | | oid | num | 视频cid | 必要 | |
| pid | num | 稿件avID | 非必要 | | | pid | num | 稿件avid | 非必要 | |
| segment_index | num | 分包 | 必要 | 6分钟一包 | | segment_index | num | 分包 | 必要 | 6分钟一包 |
**proto回复：** **proto回复：**
@@ -49,22 +49,22 @@ porto定义见：[bilibili.community.service.dm.v1.DmSegMobileReply](../grpc_api
| 名称 | 类型 | 含义 | 备注 | | 名称 | 类型 | 含义 | 备注 |
| -------- | ------ | ------------------ | ------------------------------------------------------------ | | -------- | ------ | ------------------ | ------------------------------------------------------------ |
| id | int64 | 弹幕dmID | 唯一 可用于操作参数 | | id | int64 | 弹幕dmid | 唯一 可用于操作参数 |
| progress | int32 | 视频内弹幕出现时间 | 毫秒 | | progress | int32 | 视频内弹幕出现时间 | 毫秒 |
| mode | int32 | 弹幕类型 | 1 2 3：普通弹幕<br />4：底部弹幕<br />5：顶部弹幕<br />6：逆向弹幕<br />7：高级弹幕<br />8：代码弹幕<br />9：BAS弹幕（仅限于特殊弹幕专包） | | 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：大 | | fontsize | int32 | 弹幕字号 | 18：小<br />25：标准<br />36：大 |
| color | uint32 | 弹幕颜色 | 十进制RGB888值 | | color | uint32 | 弹幕颜色 | 十进制RGB888值 |
| midHash | string | 发送者UID的HASH | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户ID | | midHash | string | 发送者mid的HASH | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户id |
| content | string | 弹幕内容 | utf-8编码 | | content | string | 弹幕内容 | utf-8编码 |
| ctime | int64 | 弹幕发送时间 | 时间戳 | | ctime | int64 | 弹幕发送时间 | 时间戳 |
| weight | int32 | 权重 | 用于智能屏蔽，根据弹幕语义及长度通过AI识别得出<br />范围：[0-10]<br />值越大权重越高 | | weight | int32 | 权重 | 用于智能屏蔽，根据弹幕语义及长度通过AI识别得出<br />范围：[0-10]<br />值越大权重越高 |
| action | string | 动作？ | 作用尚不明确 | | action | string | 动作？ | 作用尚不明确 |
| pool | int32 | 弹幕池 | 0：普通池<br />1：字幕池<br />2：特殊池（代码/BAS弹幕） | | 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安装** **注：[proto定义](../grpc_api/bilibili/community/service/dm/v1/dm.proto)需要编译，`bilibili.community.service.dm.v1.dm_pb2`并非通过pypi安装**
danmaku/danmaku_view_proto.md
+19 -19
View File
@@ -30,8 +30,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ----------- | | ------ | ---- | -------- | ------ | ----------- |
| type | num | 弹幕类 | 必要 | 1：视频弹幕 | | type | num | 弹幕类 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | | | oid | num | 视频cid | 必要 | |
| pid | num | 稿件avID | 非必要 | | | pid | num | 稿件avid | 非必要 | |
**proto回复：** **proto回复：**
@@ -69,16 +69,16 @@
| 名称 | 类型 | 含义 | 备注 | | 名称 | 类型 | 含义 | 备注 |
| -------- | ------ | ------------ | ------------------------------------------------------------ | | -------- | ------ | ------------ | ------------------------------------------------------------ |
| id | int64 | 弹幕dmID | | | id | int64 | 弹幕dmid | |
| oid | int64 | 视频CID | | | oid | int64 | 视频cid | |
| mid | int64 | 发送者UID | | | mid | int64 | 发送者mid | |
| command | string | 弹幕指令 | `#UP#`：UP主头像弹幕<br />`#LINK#`：关联视频弹幕<br />`#ATTENTION#`：视频内嵌引导关注按钮 | | command | string | 弹幕指令 | `#UP#`：UP主头像弹幕<br />`#LINK#`：关联视频弹幕<br />`#ATTENTION#`：视频内嵌引导关注按钮 |
| content | string | 弹幕文字 | | | content | string | 弹幕文字 | |
| progress | int32 | 弹幕出现时间 | 单位为毫秒 | | progress | int32 | 弹幕出现时间 | 单位为毫秒 |
| ctime | string | 创建时间？ | 此项为空 | | ctime | string | 创建时间？ | 此项为空 |
| mtime | string | 修改时间？ | 此项为空 | | mtime | string | 修改时间？ | 此项为空 |
| extra | string | 弹幕负载数据 | json序列字串 | | extra | string | 弹幕负载数据 | json序列字串 |
| idStr | string | 弹幕dmID | 字串形式 | | idStr | string | 弹幕dmid | 字串形式 |
`extra`json序列： `extra`json序列：
@@ -92,10 +92,10 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------------- | ---- | | ----- | ---- | ------------------- | ---- |
| aid | num | 关联视频的avID | | | aid | num | 关联视频的avid | |
| title | str | 关联视频的标题 | | | title | str | 关联视频的标题 | |
| icon | str | 关联视频按钮图片url | | | icon | str | 关联视频按钮图片url | |
| bvid | str | 关联视频的bvID | | | bvid | str | 关联视频的bvid | |
类型为【视频内嵌引导关注按钮】时： 类型为【视频内嵌引导关注按钮】时：
@@ -154,16 +154,16 @@ message DanmakuFlagConfig {
// 互动弹幕条目 // 互动弹幕条目
message CommandDm { message CommandDm {
int64 id = 1; //弹幕dmID int64 id = 1; //弹幕dmid
int64 oid = 2; //视频CID int64 oid = 2; //视频cid
int64 mid = 3; //发送者UID int64 mid = 3; //发送者mid
string command = 4; //弹幕指令 string command = 4; //弹幕指令
string content = 5; //弹幕文字 string content = 5; //弹幕文字
int32 progress = 6; //弹幕出现时间 int32 progress = 6; //弹幕出现时间
string ctime = 7; // string ctime = 7; //
string mtime = 8; // string mtime = 8; //
string extra = 9; //弹幕负载数据 string extra = 9; //弹幕负载数据
string idStr = 10; //弹幕dmID（字串形式） string idStr = 10; //弹幕dmid（字串形式）
} }
//弹幕个人配置 //弹幕个人配置
@@ -206,7 +206,7 @@ message DmWebViewReply {
**示例：** **示例：**
获取视频`av797164471(CID=236871317)`的弹幕元数据 获取视频`av797164471(cid=236871317)`的弹幕元数据
```shell ```shell
curl -G 'http://api.bilibili.com/x/v2/dm/web/view' \ 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 ```python
import web_dmview_pb2 import web_dmview_pb2
@@ -241,8 +241,8 @@ print(f'互动弹幕数={len(target.commandDms)}')
for i in target.commandDms: for i in target.commandDms:
print(f'''\ print(f'''\
---弹幕ID={i.id} ---弹幕ID={i.id}
---视频CID={i.oid} ---视频cid={i.oid}
---发送者UID={i.mid} ---发送者mid={i.mid}
---弹幕指令={i.command} ---弹幕指令={i.command}
---弹幕文字={i.content} ---弹幕文字={i.content}
---弹幕出现时间={i.progress} ---弹幕出现时间={i.progress}
@@ -256,8 +256,8 @@ for i in target.commandDms:
``` ```
互动弹幕数=1 互动弹幕数=1
---弹幕ID=38469676112019463 ---弹幕ID=38469676112019463
---视频CID=236871317 ---视频cid=236871317
---发送者UID=501183549 ---发送者mid=501183549
---弹幕指令=#UP# ---弹幕指令=#UP#
---弹幕文字=这个视频没有恰饭！别紧张！ ---弹幕文字=这个视频没有恰饭！别紧张！
---弹幕出现时间=157818 ---弹幕出现时间=157818
@@ -269,7 +269,7 @@ for i in target.commandDms:
BAS弹幕（`pool=2` `mode=9`）只能从此包获取，代码弹幕（`pool=2` `mode=8`）也能从此包获取 BAS弹幕（`pool=2` `mode=9`）只能从此包获取，代码弹幕（`pool=2` `mode=8`）也能从此包获取
获取并显示视频`av2(CID=62131)`的所有BAS（代码）弹幕专包 获取并显示视频`av2(cid=62131)`的所有BAS（代码）弹幕专包
```python ```python
import web_dmview_pb2 import web_dmview_pb2
danmaku/danmaku_xml.md
+5 -5
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 - 标签 i
- 标签 chatserver：chat.bilibili.com - 标签 chatserver：chat.bilibili.com
- 标签 chatid：视频CID - 标签 chatid：视频cid
- 标签 mission：0 - 标签 mission：0
- 标签 maxlimit：实时弹幕池最大容量 - 标签 maxlimit：实时弹幕池最大容量
- 标签 state：弹幕状态（0：正常 1：弹幕已关闭） - 标签 state：弹幕状态（0：正常 1：弹幕已关闭）
@@ -119,8 +119,8 @@ curl 'http://comment.bilibili.com/144541892.xml'
| 3 | 弹幕颜色 | int32 | 十进制RGB888值 | | 3 | 弹幕颜色 | int32 | 十进制RGB888值 |
| 4 | 弹幕发送时间 | int32 | 时间戳 | | 4 | 弹幕发送时间 | int32 | 时间戳 |
| 5 | 弹幕池类型 | int32 | 0：普通池<br />1：字幕池<br />2：特殊池（代码/BAS弹幕） | | 5 | 弹幕池类型 | int32 | 0：普通池<br />1：字幕池<br />2：特殊池（代码/BAS弹幕） |
| 6 | 发送者UID的HASH | string | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户ID | | 6 | 发送者mid的HASH | string | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户id |
| 7 | 弹幕dmID | int64 | 唯一 可用于操作参数 | | 7 | 弹幕dmid | int64 | 唯一 可用于操作参数 |
```xml ```xml
<d p="490.19100,1,25,16777215,1584268892,0,a16fe0dd,29950852386521095">从结尾回来看这里，更感动了！</d> <d p="490.19100,1,25,16777215,1584268892,0,a16fe0dd,29950852386521095">从结尾回来看这里，更感动了！</d>
danmaku/history.md
+5 -5
View File
@@ -23,7 +23,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ------- | | ------ | ---- | ------------ | ------ | ------- |
| type | num | 1 | 必要 | | | type | num | 1 | 必要 | |
| oid | num | 视频CID | 必要 | | | oid | num | 视频cid | 必要 | |
| month | str | 查询目标年月 | 必要 | YYYY-MM | | month | str | 查询目标年月 | 必要 | YYYY-MM |
**json回复：** **json回复：**
@@ -120,7 +120,7 @@ curl -G 'http://api.bilibili.com/x/v2/dm/history/index' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ----------- | | ------ | ---- | -------- | ------ | ----------- |
| type | num | 弹幕类 | 必要 | 1：视频弹幕 | | type | num | 弹幕类 | 必要 | 1：视频弹幕 |
| oid | num | 视频CID | 必要 | | | oid | num | 视频cid | 必要 | |
| date | str | 弹幕日期 | 必要 | YYYY-MM-DD | | date | str | 弹幕日期 | 必要 | YYYY-MM-DD |
**proto回复：** **proto回复：**
@@ -129,7 +129,7 @@ porto定义见：[bilibili.community.service.dm.v1.DmSegMobileReply](../grpc_api
详细说明见[protobuf弹幕](danmaku_proto.md) 详细说明见[protobuf弹幕](danmaku_proto.md)
获取视频`av84271171(CID=144541892)`2020-01-21的历史弹幕 获取视频`av84271171(cid=144541892)`2020-01-21的历史弹幕
**注：proto定义需要编译** **注：proto定义需要编译**
@@ -192,12 +192,12 @@ idStr: "27532611677585408"
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---------- | | ------ | ---- | -------- | ------ | ---------- |
| type | num | 1 | 必要 | | | type | num | 1 | 必要 | |
| oid | num | 视频CID | 必要 | | | oid | num | 视频cid | 必要 | |
| date | str | 弹幕日期 | 必要 | YYYY-MM-DD | | date | str | 弹幕日期 | 必要 | YYYY-MM-DD |
**示例：** **示例：**
获取视频`av84271171(CID=144541892)`2020-01-21的历史弹幕 获取视频`av84271171(cid=144541892)`2020-01-21的历史弹幕
```shell ```shell
curl -G 'http://api.bilibili.com/x/v2/dm/history' \ curl -G 'http://api.bilibili.com/x/v2/dm/history' \
danmaku/snapshot.md
+3 -3
View File
@@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | -------- | ------------------ | ------ | ---- | | ------ | -------- | ------------------ | ------ | ---- |
| aid | num或str | 稿件avID或稿件bvID | 必要 | | | aid | num或str | 稿件avid或稿件bvid | 必要 | |
**json回复：** **json回复：**
@@ -42,14 +42,14 @@
获取视频`av43337021`/`BV1rb411m7gE`的弹幕快照，总计20条 获取视频`av43337021`/`BV1rb411m7gE`的弹幕快照，总计20条
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/v2/dm/ajax' \ curl -G 'http://api.bilibili.com/x/v2/dm/ajax' \
--data-urlencode 'aid=43337021' --data-urlencode 'aid=43337021'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/v2/dm/ajax' \ curl -G 'http://api.bilibili.com/x/v2/dm/ajax' \
dynamic/content.md
+1 -1
View File
@@ -54,7 +54,7 @@
| face | str | 直播者头像 | | | face | str | 直播者头像 | |
| link | str | 直播链接 | | | link | str | 直播链接 | |
| title | str | 直播标题 | | | title | str | 直播标题 | |
| uid | num | 直播者ID | | | uid | num | 直播者id | |
| uname | str | 直播者昵称 | | | uname | str | 直播者昵称 | |
**示例：** **示例：**
dynamic/get_dynamic_detail.md
+2 -2
View File
@@ -8,7 +8,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ---------- | ------ | -------- | | ------------ | ---- | ---------- | ------ | -------- |
| dynamic_id | id | 动态ID | 必要 | | | dynamic_id | id | 动态id | 必要 | |
**json回复：** **json回复：**
@@ -73,7 +73,7 @@
**示例：** **示例：**
获取`哔哩哔哩弹幕网`的动态ID为`507420325550127049`动态 获取`哔哩哔哩弹幕网`的动态id为`507420325550127049`动态
```shell ```shell
curl -G 'http://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/get_dynamic_detail' \ curl -G 'http://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/get_dynamic_detail' \
dynamic/tag_dynamics.md
+4 -4
View File
@@ -14,7 +14,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ---------- | ------ | -------- | | ------------ | ---- | ---------- | ------ | -------- |
| topic_name | str | 话题名称 | 必要（可选） | topic_id与topic_name任选一个 | | 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，在部分话题中使用可以排除热门部分| | sortby | num | 排序方式 | 非必要 | 一般情况下带上参数2，在部分话题中使用可以排除热门部分|
| offset | num | 偏移值 | 非必要| 可用于偏移显示的动态列表（为`0`时获取不包含置顶及热门的最新动态） | | offset | num | 偏移值 | 非必要| 可用于偏移显示的动态列表（为`0`时获取不包含置顶及热门的最新动态） |
@@ -55,7 +55,7 @@
**示例：** **示例：**
获取话题`哔哩哔哩漫画`（话题ID`7539944`）的当前动态列表（包含置顶&热门） 获取话题`哔哩哔哩漫画`（话题id`7539944`）的当前动态列表（包含置顶&热门）
topic_name方式： topic_name方式：
```shell ```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_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`时获取最新动态） | | offset_dynamic_id | num | 偏移值 | 必要| 可用于偏移显示的动态列表（为`0`时获取最新动态） |
**json回复：** **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方式： topic_name方式：
```shell ```shell
electric/Bcoin.md
+10 -10
View File
@@ -27,9 +27,9 @@
| -------- | ---- | ------------------------ | ------ | ------------------------------------------------- | | -------- | ---- | ------------------------ | ------ | ------------------------------------------------- |
| bp_num | num | 贝壳数量 | 必要 | 必须在20-99990之间 | | bp_num | num | 贝壳数量 | 必要 | 必须在20-99990之间 |
| is_bp_remains_prior | bool | 是否优先扣除B币余额 | 必要 | [true,false]，B币充电请选择true | | is_bp_remains_prior | bool | 是否优先扣除B币余额 | 必要 | [true,false]，B币充电请选择true |
| up_mid | num | 充电对象用户UID | 必要 | | | up_mid | num | 充电对象用户mid | 必要 | |
| otype | str | 充电来源 | 必要 | up：空间充电<br />archive：视频充电 | | otype | str | 充电来源 | 必要 | up：空间充电<br />archive：视频充电 |
| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户UID<br />视频充电：稿件avID | | oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户mid<br />视频充电：稿件avid |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
@@ -47,8 +47,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ----------- | ------------------------------------------------ | | -------- | ---- | ----------- | ------------------------------------------------ |
| mid | num | 本用户UID | | | mid | num | 本用户mid | |
| up_mid | num | 目标用户UID | | | up_mid | num | 目标用户mid | |
| order_no | str | 留言token | 用于添加充电留言 | | order_no | str | 留言token | 用于添加充电留言 |
| bp_num | num | 充电贝壳数 | | | bp_num | num | 充电贝壳数 | |
| exp | num | 获得经验数 | | | exp | num | 获得经验数 | |
@@ -57,7 +57,7 @@
**示例：** **示例：**
以空间的方式向用户`UID=293793435`充了2贝壳，得到2经验，留言token为`BPRG5CEC3VUPOOANA540` 以空间的方式向用户`mid=293793435`充了2贝壳，得到2经验，留言token为`BPRG5CEC3VUPOOANA540`
此时`data`.`status`=`4` 此时`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之间 | | elec_num | num | 充电电池数量 | 必要 | 必须在20-99990之间 |
| up_mid | num | 充电对象用户UID | 必要 | | | up_mid | num | 充电对象用户mid | 必要 | |
| otype | str | 充电来源 | 必要 | up：空间充电<br />archive：视频充电 | | otype | str | 充电来源 | 必要 | up：空间充电<br />archive：视频充电 |
| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户UID<br />视频充电：稿件avID | | oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户mid<br />视频充电：稿件avid |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
@@ -208,8 +208,8 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ----------- | ------------------------------------------------ | | -------- | ---- | ----------- | ------------------------------------------------ |
| mid | num | 本用户UID | | | mid | num | 本用户mid | |
| up_mid | num | 目标用户UID | | | up_mid | num | 目标用户mid | |
| order_no | str | 留言token | 用于添加充电留言 | | order_no | str | 留言token | 用于添加充电留言 |
| elec_num | num | 充电电池数 | | | elec_num | num | 充电电池数 | |
| exp | 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` 此时`data`.`status`=`4`
electric/WeChat&Alipay.md
+3 -3
View File
@@ -33,10 +33,10 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ | | ------------------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| elec_num | num | 充电电池数量 | 必要 | 必须在20-99990之间<br />1-19区间视为充值B币 | | 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币不足时剩余的部分利用支付平台支付 | | is_bp_remains_prior | bool | 是否优先扣除B币 | 必要 | true：是<br />false：否<br />在B币不足时剩余的部分利用支付平台支付 |
| otype | str | 充电来源 | 必要 | up：空间充电<br />archive：视频充电 | | otype | str | 充电来源 | 必要 | up：空间充电<br />archive：视频充电 |
| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户UID<br />视频充电：稿件avID | | oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户mid<br />视频充电：稿件avid |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
@@ -122,7 +122,7 @@ curl 'http://api.bilibili.com/x/ugcpay/trade/elec/pay/qr_code/create' \
| -------- | ---- | ----------- | ------------------------------------------------------------ | | -------- | ---- | ----------- | ------------------------------------------------------------ |
| qr_token | str | 扫码秘钥 | | | qr_token | str | 扫码秘钥 | |
| order_no | str | 留言token | 未成功则无此项<br />用于添加充电留言 | | order_no | str | 留言token | 未成功则无此项<br />用于添加充电留言 |
| mid | num | 当前用户UID | | | mid | num | 当前用户mid | |
| status | num | 状态值 | 若秘钥错误则无此项<br />1：已支付<br />2：未扫描<br />3：未确认 | | status | num | 状态值 | 若秘钥错误则无此项<br />1：已支付<br />2：未扫描<br />3：未确认 |
**示例：** **示例：**
electric/charge_list.md
+13 -13
View File
@@ -15,7 +15,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- | | ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | | | mid | num | 目标用户mid | 必要 | |
**json回复：** **json回复：**
@@ -23,7 +23,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ----------------------------- | | ---- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功 <br />500011：UID错误 | | code | num | 返回值 | 0：成功 <br />500011：mid错误 |
| msg | str | 错误信息 | 正确时无此项 | | msg | str | 错误信息 | 正确时无此项 |
| data | obj | 数据本体 | | | data | obj | 数据本体 | |
@@ -50,8 +50,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ---------------- | | ----------- | ---- | ---------------- | ---------------- |
| mid | num | 充电对象UID | | | mid | num | 充电对象mid | |
| pay_mid | num | 充电用户UID | | | pay_mid | num | 充电用户mid | |
| rank | num | 充电用户排名 | 取决于充电的多少 | | rank | num | 充电用户排名 | 取决于充电的多少 |
| uname | str | 充电用户昵称 | | | uname | str | 充电用户昵称 | |
| avatar | str | 充电用户头像url | | | avatar | str | 充电用户头像url | |
@@ -70,7 +70,7 @@
**示例：** **示例：**
查询用户`UID=53456`的充电公示列表 查询用户`mid=53456`的充电公示列表
```shell ```shell
curl -G 'http://elec.bilibili.com/api/query.rank.do' \ 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 | 必要 | | | mid | num | 目标用户mid | 必要 | |
| aid | num | 目标稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 目标稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 目标稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 目标稿件bvid | 必要（可选） | avid与bvid任选一个 |
**json回复：** **json回复：**
@@ -200,8 +200,8 @@ curl -G 'http://elec.bilibili.com/api/query.rank.do' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ---------------- | | ----------- | ---- | ---------------- | ---------------- |
| mid | num | 充电对象UID | | | mid | num | 充电对象mid | |
| pay_mid | num | 充电用户UID | | | pay_mid | num | 充电用户mid | |
| rank | num | 充电用户排名 | 取决于充电的多少 | | rank | num | 充电用户排名 | 取决于充电的多少 |
| uname | str | 充电用户昵称 | | | uname | str | 充电用户昵称 | |
| avatar | str | 充电用户头像url | | | 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 ```shell
curl -G 'http://api.bilibili.com/x/web-interface/elec/show' \ 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' --data-urlencode 'aid=967773538'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/web-interface/elec/show' \ curl -G 'http://api.bilibili.com/x/web-interface/elec/show' \
emoji/action.md
+4 -4
View File
@@ -19,7 +19,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | -------------------------------- | | ---------- | ---- | ------------------------ | ------ | -------------------------------- |
| package_id | num | 表情包ID | 必要 | | | package_id | num | 表情包id | 必要 | |
| business | str | 使用场景 | 必要 | reply：评论区<br />dynamic：动态 | | business | str | 使用场景 | 必要 | reply：评论区<br />dynamic：动态 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
@@ -35,7 +35,7 @@
**示例：** **示例：**
添加ID为`25`的表情包，使用场景为评论区 添加id为`25`的表情包，使用场景为评论区
```shell ```shell
curl 'http://api.bilibili.com/x/emote/package/add' \ 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：动态 | | business | str | 使用场景 | 必要 | reply：评论区<br />dynamic：动态 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
@@ -86,7 +86,7 @@ curl 'http://api.bilibili.com/x/emote/package/add' \
**示例：** **示例：**
移除ID为`25`的表情包，使用场景为评论区 移除id为`25`的表情包，使用场景为评论区
```shell ```shell
curl 'http://api.bilibili.com/x/emote/package/remove' \ curl 'http://api.bilibili.com/x/emote/package/remove' \
emoji/list.md
+6 -6
View File
@@ -234,7 +234,7 @@ curl -G 'http://api.bilibili.com/x/emote/user/panel/web' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | -------- | ------ | -------------------------------- | | -------- | ---- | -------- | ------ | -------------------------------- |
| business | str | 使用场景 | 必要 | reply：评论区<br />dynamic：动态 | | business | str | 使用场景 | 必要 | reply：评论区<br />dynamic：动态 |
| ids | nums | 表情包ID | 必要 | | | ids | nums | 表情包id | 必要 | |
**json回复：** **json回复：**
@@ -263,7 +263,7 @@ curl -G 'http://api.bilibili.com/x/emote/user/panel/web' \
**示例：** **示例：**
获取表情包ID为`93`的表情包明细 获取表情包id为`93`的表情包明细
```shell ```shell
curl -G 'http://api.bilibili.com/x/emote/package' \ 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 | 表情包名称 | | | text | str | 表情包名称 | |
| url | str | 表情包标志图片url | | | url | str | 表情包标志图片url | |
| mtime | num | 创建时间 | 时间戳 | | mtime | num | 创建时间 | 时间戳 |
@@ -607,7 +607,7 @@ curl -G 'http://api.bilibili.com/x/emote/setting/panel' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | --------------- | ---------------- | | -------- | ---- | --------------- | ---------------- |
| size | num | 表情尺寸信息 | 1：小<br />2：大 | | size | num | 表情尺寸信息 | 1：小<br />2：大 |
| item_id | num | 购买物品ID | | | item_id | num | 购买物品id | |
| item_url | num | 购买物品页面url | 无则无此项 | | item_url | num | 购买物品页面url | 无则无此项 |
`表情包对象`中的`emote`数组： `表情包对象`中的`emote`数组：
@@ -622,8 +622,8 @@ curl -G 'http://api.bilibili.com/x/emote/setting/panel' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ----------- | -------------------------------------------------------- | | ---------- | ---- | ----------- | -------------------------------------------------------- |
| id | num | 表情ID | | | id | num | 表情id | |
| package_id | num | 表情包ID | | | package_id | num | 表情包id | |
| text | str | 表情转义符 | 颜文字时为该字串 | | text | str | 表情转义符 | 颜文字时为该字串 |
| url | str | 表情图片url | 颜文字时为该字串 | | url | str | 表情图片url | 颜文字时为该字串 |
| mtime | num | 创建时间 | 时间戳 | | mtime | num | 创建时间 | 时间戳 |
fav/info.md
+9 -9
View File
@@ -36,9 +36,9 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------------- | -------------------------------------------------- | | ----------- | ---- | -------------------- | -------------------------------------------------- |
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者UID尾号2位 | | id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 |
| fid | num | 收藏夹原始id | | | fid | num | 收藏夹原始id | |
| mid | num | 创建者UID | | | mid | num | 创建者mid | |
| attr | num | 属性位（？） | | | attr | num | 属性位（？） | |
| title | str | 收藏夹标题 | | | title | str | 收藏夹标题 | |
| cover | str | 收藏夹封面图片url | | | cover | str | 收藏夹封面图片url | |
@@ -59,7 +59,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------- | ----------------------------------------------- | | ---------- | ---- | ---------------- | ----------------------------------------------- |
| mid | num | 创建者UID | | | mid | num | 创建者mid | |
| name | str | 创建者昵称 | | | name | str | 创建者昵称 | |
| face | str | 创建者头像url | | | face | str | 创建者头像url | |
| followed | bool | 是否已关注创建者 | | | followed | bool | 是否已关注创建者 | |
@@ -77,7 +77,7 @@
**示例：** **示例：**
查询收藏夹`ID=1052622027`的元数据 查询收藏夹`id=1052622027`的元数据
```shell ```shell
curl -G 'http://api.bilibili.com/x/v3/fav/folder/info' \ 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：视频稿件 | | type | num | 目标内容属性 | 非必要 | 默认为全部<br />0：全部<br />2：视频稿件 |
| rid | num | 目标内容id | 非必要 | 视频稿件：视频稿件avid | | 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 | | | fid | num | 收藏夹原始id | |
| mid | num | 创建者UID | | | mid | num | 创建者mid | |
| attr | num | 属性位（？） | | | attr | num | 属性位（？） | |
| title | str | 收藏夹标题 | | | title | str | 收藏夹标题 | |
| fav_state | num | 目标id是否存在于该收藏夹 | 存在于该收藏夹：1<br />不存在于该收藏夹：0 | | 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 ```shell
curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \ 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主昵称 | | | name | str | UP主昵称 | |
| face | str | UP主头像url | | | face | str | UP主头像url | |
fav/list.md
+6 -6
View File
@@ -49,9 +49,9 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------------- | -------------------------------------------------- | | ----------- | ---- | -------------------- | -------------------------------------------------- |
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者UID尾号2位 | | id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 |
| fid | num | 收藏夹原始id | | | fid | num | 收藏夹原始id | |
| mid | num | 创建者UID | | | mid | num | 创建者mid | |
| attr | num | 属性 | 0：正常<br />1：失效 | | attr | num | 属性 | 0：正常<br />1：失效 |
| title | str | 收藏夹标题 | | | title | str | 收藏夹标题 | |
| cover | str | 收藏夹封面图片url | | | cover | str | 收藏夹封面图片url | |
@@ -72,7 +72,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------- | ----------------------------------------------- | | ---------- | ---- | ---------------- | ----------------------------------------------- |
| mid | num | 创建者UID | | | mid | num | 创建者mid | |
| name | str | 创建者昵称 | | | name | str | 创建者昵称 | |
| face | str | 创建者头像url | | | face | str | 创建者头像url | |
| followed | bool | 是否已关注创建者 | | | followed | bool | 是否已关注创建者 | |
@@ -122,7 +122,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---- | | ---- | ---- | ----------- | ---- |
| mid | num | UP主UID | | | mid | num | UP主mid | |
| name | str | UP主昵称 | | | name | str | UP主昵称 | |
| face | str | UP主头像url | | | face | str | UP主头像url | |
@@ -136,7 +136,7 @@
**示例：** **示例：**
查询收藏夹`ID=1052622027`，每页5个视频，第`1`页的内容明细 查询收藏夹`id=1052622027`，每页5个视频，第`1`页的内容明细
```shell ```shell
curl -G 'http://api.bilibili.com/x/v3/fav/resource/list' \ 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 ```shell
curl -G 'http://api.bilibili.com/x/v3/fav/resource/ids' \ curl -G 'http://api.bilibili.com/x/v3/fav/resource/ids' \
garb/color.md
+2 -2
View File
@@ -46,7 +46,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | ------------------------------- | | ---------- | ---- | ------------ | ------------------------------- |
| id | num | 颜色ID | | | id | num | 颜色id | |
| name | str | 颜色名称 | | | name | str | 颜色名称 | |
| is_free | bool | 是否免费 | false：收费<br />true：免费 | | is_free | bool | 是否免费 | false：收费<br />true：免费 |
| price | num | 价格 | 单位为硬币 | | 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 | 颜色名称 | | | name | str | 颜色名称 | |
| is_free | bool | 是否免费 | false：收费<br />true：免费 | | is_free | bool | 是否免费 | false：收费<br />true：免费 |
| price | num | 价格 | 单位为硬币 | | price | num | 价格 | 单位为硬币 |
garb/skin.md
+3 -3
View File
@@ -47,7 +47,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | --------------- | ------ | | ----------- | ---- | --------------- | ------ |
| id | num | 装扮ID | | | id | num | 装扮id | |
| name | str | 装扮名称 | | | name | str | 装扮名称 | |
| preview | str | 装扮封面url | | | preview | str | 装扮封面url | |
| ver | num | 装扮版本 | 时间戳 | | ver | num | 装扮版本 | 时间戳 |
@@ -80,7 +80,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | ------------------------------- | | ---------- | ---- | ------------ | ------------------------------- |
| id | num | 颜色ID | | | id | num | 颜色id | |
| name | str | 颜色名称 | | | name | str | 颜色名称 | |
| is_free | bool | 是否免费 | false：收费<br />true：免费 | | is_free | bool | 是否免费 | false：收费<br />true：免费 |
| price | num | 价格 | 单位为硬币 | | price | num | 价格 | 单位为硬币 |
@@ -95,7 +95,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | --------------- | ------ | | ----------- | ---- | --------------- | ------ |
| id | num | 装扮ID | | | id | num | 装扮id | |
| name | str | 装扮名称 | | | name | str | 装扮名称 | |
| ver | num | 装扮版本 | 时间戳 | | ver | num | 装扮版本 | 时间戳 |
| loading_url | str | 加载动画图标url | | | loading_url | str | 加载动画图标url | |
history&toview/history.md
+20 -20
View File
@@ -23,8 +23,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------------------- | ------ | ------------------------------------------------------------ | | -------- | ---- | ---------------------- | ------ | ------------------------------------------------------------ |
| max | num | 历史记录截止目标ID | 非必要 | 默认为0<br />稿件：稿件avID<br />番剧（影视）：剧集ssID<br />直播：直播间ID<br />文集：文集rlID<br />文章：文章cvID | | max | num | 历史记录截止目标id | 非必要 | 默认为0<br />稿件：稿件avid<br />番剧（影视）：剧集ssid<br />直播：直播间id<br />文集：文集rlid<br />文章：文章cvid |
| business | num | 历史记录截止目标ID类型 | 非必要 | 默认为空<br />archive：稿件<br />pgc：番剧（影视）<br />live：直播<br />article-list：文集<br />article：文章 | | business | num | 历史记录截止目标id类型 | 非必要 | 默认为空<br />archive：稿件<br />pgc：番剧（影视）<br />live：直播<br />article-list：文集<br />article：文章 |
| view_at | num | 历史记录截止时间 | 非必要 | 时间戳<br />默认为0<br />0为当前时间 | | view_at | num | 历史记录截止时间 | 非必要 | 时间戳<br />默认为0<br />0为当前时间 |
| ps | num | 每页项数 | 非必要 | 默认为20 | | ps | num | 每页项数 | 非必要 | 默认为20 |
@@ -51,9 +51,9 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------------ | ------------------ | | -------- | ---- | ------------------ | ------------------ |
| max | num | 最后一项目标ID | **详细内容见参数** | | max | num | 最后一项目标id | **详细内容见参数** |
| view_at | num | 最后一项时间节点 | 时间戳 | | view_at | num | 最后一项时间节点 | 时间戳 |
| business | str | 最后一项目标ID类型 | **详细内容见参数** | | business | str | 最后一项目标id类型 | **详细内容见参数** |
| ps | num | 每页项数 | | | ps | num | 每页项数 | |
`data`中的`tab`数组： `data`中的`tab`数组：
@@ -92,7 +92,7 @@
| videos | num | 视频分P数目 | 仅用于稿件视频 | | videos | num | 视频分P数目 | 仅用于稿件视频 |
| author_name | str | UP主昵称 | | | author_name | str | UP主昵称 | |
| author_face | str | UP主头像url | | | author_face | str | UP主头像url | |
| author_mid | num | UP主UID | | | author_mid | num | UP主mid | |
| view_at | num | 查看时间 | 时间戳 | | view_at | num | 查看时间 | 时间戳 |
| progress | num | 视频观看进度 | 单位为秒<br />用于稿件视频或剧集 | | progress | num | 视频观看进度 | 单位为秒<br />用于稿件视频或剧集 |
| badge | str | 条目备注标识 | 用于稿件视频或剧集 | | badge | str | 条目备注标识 | 用于稿件视频或剧集 |
@@ -103,7 +103,7 @@
| new_desc | str | 最新一话/最新一P标识 | 用于稿件视频或剧集 | | new_desc | str | 最新一话/最新一P标识 | 用于稿件视频或剧集 |
| is_finish | num | 是否已完结 | 仅用于剧集<br />0：未完结<br />1：已完结 | | is_finish | num | 是否已完结 | 仅用于剧集<br />0：未完结<br />1：已完结 |
| is_fav | num | 是否收藏 | 0：未收藏<br />1：已收藏 | | is_fav | num | 是否收藏 | 0：未收藏<br />1：已收藏 |
| kid | num | 条目目标ID | **详细内容见参数** | | kid | num | 条目目标id | **详细内容见参数** |
| tag_name | str | 子分区名 | 用于稿件视频和直播 | | tag_name | str | 子分区名 | 用于稿件视频和直播 |
| live_status | num | 直播状态 | 仅用于直播<br />0：未开播<br />1：已开播 | | 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 | | oid | num | 目标id | 稿件视频&剧集（当`business=archive`或`business=pgc`时）：稿件avid<br />直播（当`business=live`时）：直播间id<br />文章（当`business=article`时）：文章cvid<br />文集（当`business=article-list`时）：文集rlid |
| epid | num | 剧集epID | 仅用于剧集 | | epid | num | 剧集epid | 仅用于剧集 |
| bvid | str | 稿件bvID | 仅用于稿件视频 | | bvid | str | 稿件bvid | 仅用于稿件视频 |
| page | num | 观看到的视频分P数 | 仅用于稿件视频 | | 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标题 | 仅用于稿件视频 | | part | str | 观看到的视频分P标题 | 仅用于稿件视频 |
| business | str | 条目类型 | **详细内容见参数** | | business | str | 条目类型 | **详细内容见参数** |
| dt | num | 查看平台代码 | 1 3 5 7：手机端<br />2：web端<br />4 6：pad端<br />33：TV端<br />0：其他 | | 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 | | videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区tID | | | tid | num | 分区tid | |
| tname | str | 子分区名称 | | | tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1：原创<br />2：转载 | | copyright | num | 是否转载 | 1：原创<br />2：转载 |
| pic | str | 视频封面图片url | | | 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`对象 | | owner | obj | 视频UP主信息 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`owner`对象 |
| stat | obj | 视频状态数 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`stat`对象 | | stat | obj | 视频状态数 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`stat`对象 |
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 | | dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| cid | num | 视频1P CID | | | cid | num | 视频1P cid | |
| dimension | obj | 视频1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 | | dimension | obj | 视频1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 |
| bangumi | obj | 番剧/影视信息 | 非番剧/影视无此项 | | bangumi | obj | 番剧/影视信息 | 非番剧/影视无此项 |
| cheese | obj | 课程信息 | 非课程无此项 | | cheese | obj | 课程信息 | 非课程无此项 |
@@ -416,17 +416,17 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \
| count | num | 分P数 | 非投稿视频无此项 | | count | num | 分P数 | 非投稿视频无此项 |
| progress | num | 观看进度 | 单位为秒 | | progress | num | 观看进度 | 单位为秒 |
| view_at | num | 观看时间 | 时间戳 | | view_at | num | 观看时间 | 时间戳 |
| kid | num | 稿件avID | | | kid | num | 稿件avid | |
| business | str | 视频类型标识 | archive：用户投稿视频<br />pgc：番剧/影视<br />cheese：课程 | | business | str | 视频类型标识 | archive：用户投稿视频<br />pgc：番剧/影视<br />cheese：课程 |
| redirect_link | str | 重定向url | | | redirect_link | str | 重定向url | |
| bvid | str | 稿件bvID | | | bvid | str | 稿件bvid | |
`data`数组中的对象`bangumi`对象： `data`数组中的对象`bangumi`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | --------------- | ------------ | | -------------- | ---- | --------------- | ------------ |
| cover | str | 番剧封面图片url | | | cover | str | 番剧封面图片url | |
| ep_id | num | 番剧epID | | | ep_id | num | 番剧epid | |
| episode_status | num | ？？？ | | | episode_status | num | ？？？ | |
| follow | num | 0 | 作用尚不明确 | | follow | num | 0 | 作用尚不明确 |
| long_title | str | 单集标题 | | | long_title | str | 单集标题 | |
@@ -438,9 +438,9 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | ---------------------- | | --------------- | ---- | ------------ | ---------------------- |
| is_finish | num | 是否完结 | 0：连载中<br />1：完结 | | is_finish | num | 是否完结 | 0：连载中<br />1：完结 |
| newest_ep_id | num | 最细一话epID | | | newest_ep_id | num | 最细一话epid | |
| newest_ep_index | str | 最细一话集数 | | | newest_ep_index | str | 最细一话集数 | |
| season_id | num | 番剧ssID | | | season_id | num | 番剧ssid | |
| season_status | num | ？？？ | | | season_status | num | ？？？ | |
| season_type | num | ？？？ | | | season_type | num | ？？？ | |
| title | str | 番剧标题 | | | title | str | 番剧标题 | |
@@ -453,7 +453,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \
| cover | str | 课程封面图片url | | | cover | str | 课程封面图片url | |
| long_title | str | 完整标题 | | | long_title | str | 完整标题 | |
| number | str | 本集数 | | | number | str | 本集数 | |
| season_id | num | 课程ssID | | | season_id | num | 课程ssid | |
| update_info | str | 总集数 | | | 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） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
history&toview/toview.md
+12 -12
View File
@@ -24,8 +24,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ------------------ | | ------ | ---- | ------------------------ | ------------ | ------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
@@ -42,7 +42,7 @@
添加视频`av41687433`/`BV1ht41147kj`到稍后再看列表 添加视频`av41687433`/`BV1ht41147kj`到稍后再看列表
avID方式： avid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/v2/history/toview/add' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/v2/history/toview/add' \ 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 | 必要 | | | cid | num | 目标频道id | 必要 | |
| mid | num | 目标频道所属的用户UID | 必要 | | | mid | num | 目标频道所属的用户mid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
@@ -106,7 +106,7 @@ curl 'http://api.bilibili.com/x/v2/history/toview/add' \
**示例：** **示例：**
添加用户`UID=282994`下的频道`4693`中所有视频到稍后再看 添加用户`mid=282994`下的频道`4693`中所有视频到稍后再看
```shell ```shell
curl 'http://space.bilibili.com/ajax/channel/addAllToView' \ 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 | | videos | num | 稿件分P总数 | 默认为1 |
| tid | num | 分区tID | | | tid | num | 分区tid | |
| tname | str | 子分区名称 | | | tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1：原创<br />2：转载 | | copyright | num | 是否转载 | 1：原创<br />2：转载 |
| pic | str | 稿件封面图片url | | | pic | str | 稿件封面图片url | |
@@ -187,10 +187,10 @@ curl 'http://space.bilibili.com/ajax/channel/addAllToView' \
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 | | dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| dimension | obj | 稿件1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 | | dimension | obj | 稿件1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 |
| count | num | 稿件分P数 | 非投稿视频无此项 | | count | num | 稿件分P数 | 非投稿视频无此项 |
| cid | num | 视频CID | | | cid | num | 视频cid | |
| progress | num | 观看进度时间 | 单位为秒 | | progress | num | 观看进度时间 | 单位为秒 |
| add_at | 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 | | viewed | bool | 是否删除所有已观看的视频 | 非必要 | true：删除已观看视频<br />false：不删除已观看视频<br />默认为false |
| aid | num | 删除的目标记录的avID | 非必要 | | | aid | num | 删除的目标记录的avid | 非必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
live/info.md
+11 -11
View File
@@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- | | ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | | | mid | num | 目标用户mid | 必要 | |
**json回复：** **json回复：**
@@ -40,13 +40,13 @@
| title | str | 直播间标题 | | | title | str | 直播间标题 | |
| cover | str | 直播间封面url | | | cover | str | 直播间封面url | |
| online | num | 直播间人气 | 值为上次直播时刷新 | | online | num | 直播间人气 | 值为上次直播时刷新 |
| roomid | num | 直播间ID（短号） | | | roomid | num | 直播间id（短号） | |
| broadcast_type | num | 0 | | | broadcast_type | num | 0 | |
| online_hidden | num | 0 | | | online_hidden | num | 0 | |
**示例：** **示例：**
查询用户`UID=322892`的直播间信息 查询用户`mid=322892`的直播间信息
```shell ```shell
curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \ 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 | | | room_id | num | 直播间真实id | |
| short_id | num | 直播间ID（短号） | | | short_id | num | 直播间id（短号） | |
| uid | num | 主播用户UID | | | uid | num | 主播用户mid | |
| need_p2p | num | 是否p2p | | | need_p2p | num | 是否p2p | |
| is_hidden | bool | 是否隐藏 | | | is_hidden | bool | 是否隐藏 | |
| is_locked | bool | 是否锁定 | | | is_locked | bool | 是否锁定 | |
@@ -124,7 +124,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \
**示例：** **示例：**
查询直播间`ID=76`的直播间信息 查询直播间`id=76`的直播间信息
```shell ```shell
curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \ 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回复：** **json回复：**
@@ -192,7 +192,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \
| info | obj | 主播信息 | | | info | obj | 主播信息 | |
| exp | obj | 经验等级 | | | exp | obj | 经验等级 | |
| follower_num | num | 主播粉丝数 | | | follower_num | num | 主播粉丝数 | |
| room_id | num | 直播间ID（短号） | | | room_id | num | 直播间id（短号） | |
| medal_name | str | 粉丝勋章名 | | | medal_name | str | 粉丝勋章名 | |
| glory_count | int | 主播荣誉数 | | | glory_count | int | 主播荣誉数 | |
| pendant | str | 直播间头像框url | | | 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 | 主播用户名 | | | uname | str | 主播用户名 | |
| face | str | 主播头像url | | | face | str | 主播头像url | |
| official_verify | obj | 认证信息 | | | official_verify | obj | 认证信息 | |
@@ -254,7 +254,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \
**示例：** **示例：**
查询直播间`UID=76`的主播信息 查询直播间`mid=76`的主播信息
```shell ```shell
curl -G 'http://api.live.bilibili.com/live_user/v1/Master/info' \ curl -G 'http://api.live.bilibili.com/live_user/v1/Master/info' \
live/live_area.md
+5 -5
View File
@@ -35,7 +35,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---------- | ---- | | ---- | ---- | ---------- | ---- |
| id | num | 父分区ID | | | id | num | 父分区id | |
| name | name | 父分区名 | | | name | name | 父分区名 | |
| list | list | 子分区列表 | | | list | list | 子分区列表 | |
@@ -51,9 +51,9 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ----------------- | ---------------- | | ----------- | ---- | ----------------- | ---------------- |
| id | str | 子分区ID | | | id | str | 子分区id | |
| parent_id | str | 父分区ID | | | parent_id | str | 父分区id | |
| old_area_id | str | 旧分区ID | | | old_area_id | str | 旧分区id | |
| name | str | 子分区名 | | | name | str | 子分区名 | |
| act_id | str | 0 | **作用尚不明确** | | act_id | str | 0 | **作用尚不明确** |
| pk_status | str | ？？？ | **作用尚不明确** | | pk_status | str | ？？？ | **作用尚不明确** |
@@ -65,7 +65,7 @@
**示例：** **示例：**
如想在`网游`父分区下的`英雄联盟`分区开播，则查到子分区ID为`86` 如想在`网游`父分区下的`英雄联盟`分区开播，则查到子分区id为`86`
```shell ```shell
curl 'http://api.live.bilibili.com/room/v1/Area/getList' curl 'http://api.live.bilibili.com/room/v1/Area/getList'
live/live_stream.md
+1 -1
View File
@@ -84,7 +84,7 @@
**示例：** **示例：**
查询直播间`CID=14073662`的直播间信息 查询直播间`cid=14073662`的直播间信息
```shell ```shell
curl -G 'http://api.live.bilibili.com/room/v1/Room/playUrl' \ curl -G 'http://api.live.bilibili.com/room/v1/Room/playUrl' \
live/manage.md
+5 -5
View File
@@ -20,7 +20,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | -------------------- | | ------- | ---- | ------------------------ | ------ | -------------------- |
| room_id | num | 直播间ID | 必要 | 必须为自己的直播间ID | | room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
| title | str | 直播间标题 | 必要 | 最大20字符 | | title | str | 直播间标题 | 必要 | 最大20字符 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
@@ -77,8 +77,8 @@ curl 'http://api.live.bilibili.com/room/v1/Room/update' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------------ | ------ | ----------------------------------- | | -------- | ---- | ------------------------ | ------ | ----------------------------------- |
| room_id | num | 直播间ID | 必要 | 必须为自己的直播间ID | | room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
| area_v2 | num | 直播分区ID（子分区ID） | 必要 | 详见[直播分区](live_area.md) | | area_v2 | num | 直播分区id（子分区id） | 必要 | 详见[直播分区](live_area.md) |
| platform | str | 直播平台 | 必要 | web端：<br />bililink：android_link | | platform | str | 直播平台 | 必要 | web端：<br />bililink：android_link |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | 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"`为推流地址 其中`"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） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
live/message_stream.md
+2 -2
View File
@@ -40,8 +40,8 @@ json格式
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ------------ | -------------- | | --------- | ---- | ------------ | -------------- |
| uid | num | 用户UID | 不可为0 | | uid | num | 用户mid | 不可为0 |
| roomid | num | 加入房间的ID | | | roomid | num | 加入房间的id | |
| protover | num | 协议版本 | 现在是2 | | protover | num | 协议版本 | 现在是2 |
| platform | str | 平台标识 | 可为"web" | | platform | str | 平台标识 | 可为"web" |
| clientver | str | 客户端版本 | 现在是"1.10.3" | | clientver | str | 客户端版本 | 现在是"1.10.3" |
login/login_action/QR.md
+5 -5
View File
@@ -207,9 +207,9 @@ X-Cache-Webcdn: BYPASS from ks-sxhz-dx-w-01
https://passport.biligame.com/crossDomain? https://passport.biligame.com/crossDomain?
DedeUserID=(登录UID)& DedeUserID=(登录mid)&
DedeUserID__ckMd5=(登录UID MD5值)& DedeUserID__ckMd5=(登录mid MD5值)&
Expires=(过期时间 秒)& Expires=(过期时间 秒)&
@@ -236,7 +236,7 @@ gourl=(跳转网址 默认为主页)
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------- | ----------- | ------------------------ | | -------- | ---- | ---------- | ----------- | ------------------------ |
| appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` | | appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` |
| local_id | str | TV端ID | TV端必要 | 可为0 | | local_id | str | TV端id | TV端必要 | 可为0 |
| ts | num | 当前时间戳 | APP方式必要 | | | ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | 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` | | appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` |
| auth_code | str | 扫码秘钥 | 必要 | | | auth_code | str | 扫码秘钥 | 必要 | |
| local_id | str | TV端ID | TV端必要 | 可为0 | | local_id | str | TV端id | TV端必要 | 可为0 |
| ts | num | 当前时间戳 | APP方式必要 | | | ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | 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 | | | access_token | str | APP登录Token | |
| refresh_token | str | APP刷新Token | | | refresh_token | str | APP刷新Token | |
| expires_in | num | 有效时间 | 单位为秒 一般为30天 | | expires_in | num | 有效时间 | 单位为秒 一般为30天 |
login/login_action/SMS.md
+1 -1
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 ```shell
curl 'http://passport.bilibili.com/web/sms/general/v2/send' \ curl 'http://passport.bilibili.com/web/sms/general/v2/send' \
login/login_action/password.md
+3 -3
View File
@@ -183,7 +183,7 @@ YgpjxAQ22pKa9socHIKPCZX0a/NS6Ng9Zzy+rp16b0LJGT6RHw2ERs3+ijCpG96PKTY1Baavwf0xgotm
**需验证手机号或邮箱时** **需验证手机号或邮箱时**
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------------------ | ---------------- | | -------- | ---- | ------------------------ | ---------------- |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| tel | str | 绑定的手机号 | 星号隐藏部分信息 | | tel | str | 绑定的手机号 | 星号隐藏部分信息 |
| email | str | 绑定的邮箱 | 星号隐藏部分信息 | | email | str | 绑定的邮箱 | 星号隐藏部分信息 |
| sorce | num | 0 | **作用尚不明确** | | sorce | num | 0 | **作用尚不明确** |
@@ -252,9 +252,9 @@ X-Cache-Webcdn: BYPASS from jd-sxhz-dx-w-01
https://passport.biligame.com/crossDomain? https://passport.biligame.com/crossDomain?
DedeUserID=(登录UID)& DedeUserID=(登录mid)&
DedeUserID__ckMd5=(登录UID MD5值)& DedeUserID__ckMd5=(登录mid MD5值)&
Expires=(过期时间 秒)& Expires=(过期时间 秒)&
login/login_action/readme.md
+2 -2
View File
@@ -12,7 +12,7 @@
人机验证流程： 人机验证流程：
1. 请求验证码参数，得到登录密钥`key`与极验ID`gt`和极验KEY`challenge` 1. 请求验证码参数，得到登录密钥`key`与极验id`gt`和极验KEY`challenge`
2. 进行滑动or点击验证 2. 进行滑动or点击验证
3. 返回验证结果`validate`与`seccode`，进行短信或密码登录 3. 返回验证结果`validate`与`seccode`，进行短信或密码登录
@@ -44,7 +44,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | -------- | | -------- | ----- | ------ | -------- |
| success | num | 1 | **作用尚不明确** | | success | num | 1 | **作用尚不明确** |
| gt | str | 极验ID | 一般为固定值 | | gt | str | 极验id | 一般为固定值 |
| challenge | str | 极验KEY | 由B站后端产生用于人机验证 | | challenge | str | 极验KEY | 由B站后端产生用于人机验证 |
| key | str | 登录秘钥 | 与人机验证无关，与登录接口有关，但与极验KEY对应 | | key | str | 登录秘钥 | 与人机验证无关，与登录接口有关，但与极验KEY对应 |
login/login_info.md
+3 -3
View File
@@ -37,7 +37,7 @@
| email_verified | num | 是否验证邮箱地址 | 0：未验证<br />1：已验证 | | email_verified | num | 是否验证邮箱地址 | 0：未验证<br />1：已验证 |
| face | str | 用户头像url | | | face | str | 用户头像url | |
| level_info | obj | 等级信息 | | | level_info | obj | 等级信息 | |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| mobile_verified | num | 是否验证手机号 | 0：未验证<br />1：已验证 | | mobile_verified | num | 是否验证手机号 | 0：未验证<br />1：已验证 |
| money | num | 拥有硬币数 | | | money | num | 拥有硬币数 | |
| moral | num | 当前节操值 | 上限为70 | | moral | num | 当前节操值 | 上限为70 |
@@ -106,7 +106,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------- | ------------ | | --------------- | ---- | ------------- | ------------ |
| mid | num | 登录用户UID | | | mid | num | 登录用户mid | |
| bcoin_balance | num | 拥有B币数 | | | bcoin_balance | num | 拥有B币数 | |
| coupon_balance | num | 每月奖励B币数 | | | coupon_balance | num | 每月奖励B币数 | |
| coupon_due_time | num | 0 | 作用尚不明确 | | coupon_due_time | num | 0 | 作用尚不明确 |
@@ -313,7 +313,7 @@ curl 'http://account.bilibili.com/home/userInfo' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ----------------------------- | | -------------- | ---- | ---------------- | ----------------------------- |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| name | str | 用户昵称 | | | name | str | 用户昵称 | |
| sign | str | 用户签名 | | | sign | str | 用户签名 | |
| coins | num | 拥有硬币数 | | | coins | num | 拥有硬币数 | |
login/login_notice.md
+3 -3
View File
@@ -16,7 +16,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ------------------------------------------------------------ | | ------ | ---- | ---------- | ------ | ------------------------------------------------------------ |
| mid | num | 用户UID | 必要 | | | mid | num | 用户mid | 必要 | |
| buvid | str | 设备虚拟id | 非必要 | web端为操作登录接口时Cookie中的`buvid3`<br />若登录设备无`buvid`则留空 | | buvid | str | 设备虚拟id | 非必要 | web端为操作登录接口时Cookie中的`buvid3`<br />若登录设备无`buvid`则留空 |
**json回复：** **json回复：**
@@ -34,7 +34,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ----------- | -------------------------- | | ----------- | ---- | ----------- | -------------------------- |
| mid | num | 登录用户UID | | | mid | num | 登录用户mid | |
| device_name | str | 登录设备 | 依靠操作登录接口时的UA决定 | | device_name | str | 登录设备 | 依靠操作登录接口时的UA决定 |
| login_type | str | 登录方式 | 根据登录接口决定 | | login_type | str | 登录方式 | 根据登录接口决定 |
| login_time | str | 登录时间 | YYYY-MM-DD hh:mm:ss | | login_time | str | 登录时间 | YYYY-MM-DD hh:mm:ss |
@@ -43,7 +43,7 @@
**示例：** **示例：**
查询用户`293793435`设备ID为`fuck_chenrui`的登录记录 查询用户`293793435`设备id为`fuck_chenrui`的登录记录
```shell ```shell
curl -G 'http://api.bilibili.com/x/safecenter/login_notice' \ curl -G 'http://api.bilibili.com/x/safecenter/login_notice' \
login/member_center.md
+2 -2
View File
@@ -41,7 +41,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | -------------- | --------------------------------------- | | --------- | ---- | -------------- | --------------------------------------- |
| mid | num | 我的UID | | | mid | num | 我的mid | |
| uname | str | 我的昵称 | | | uname | str | 我的昵称 | |
| userid | str | 我的用户名 | | | userid | str | 我的用户名 | |
| sign | 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_type | num | 大会员类型 | 0：无<br />1：月度<br />2：年度 |
| vip_status | num | 大会员状态 | 1：正常<br />2：由于IP地址更换过于频繁,服务被冻结<br />3：你的大会员账号风险过高，大会员功能已被锁定 | | vip_status | num | 大会员状态 | 1：正常<br />2：由于IP地址更换过于频繁,服务被冻结<br />3：你的大会员账号风险过高，大会员功能已被锁定 |
| vip_due_date | num | 大会员到期时间 | 时间戳 毫秒 | | vip_due_date | num | 大会员到期时间 | 时间戳 毫秒 |
message/private_msg.md
+4 -4
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[sender_uid] | num | 发送者mid | 必要 | |
| msg[receiver_id] | num | 接收者UID | 必要 | | | msg[receiver_id] | num | 接收者mid | 必要 | |
| msg[receiver_type] | num | 1 | 必要 | 固定为1 | | msg[receiver_type] | num | 1 | 必要 | 固定为1 |
| msg[msg_type] | num | 消息类型 | 必要 | 1:发送文字<br>2:发送图片<br>5:撤回消息 | | msg[msg_type] | num | 消息类型 | 必要 | 1:发送文字<br>2:发送图片<br>5:撤回消息 |
| msg[msg_status] | num | 0 | 非必要 | | | 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主你好， > up主你好，
> >
@@ -182,7 +182,7 @@ curl 'http://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
</details> </details>
给目标用户`UID=1`发一条图片私信： 给目标用户`mid=1`发一条图片私信：
> <img src="https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" style="zoom:50%;" > > <img src="https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" style="zoom:50%;" >
newbie_exam/info.md
+2 -2
View File
@@ -28,7 +28,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---------------- | ------------------------------------------------------------ | | ------------ | ---- | ---------------- | ------------------------------------------------------------ |
| hid | num | 答题会话id | | | hid | num | 答题会话id | |
| mid | num | 答题用户UID | | | mid | num | 答题用户mid | |
| score | num | 当前得分 | | | score | num | 当前得分 | |
| status | num | 答题状态 | 0：未答题<br />2：答题中<br />3：已通过 | | status | num | 答题状态 | 0：未答题<br />2：答题中<br />3：已通过 |
| number | num | 当前题号 | | | number | num | 当前题号 | |
@@ -322,7 +322,7 @@ curl -G 'http://api.bilibili.com/x/answer/v4/pro/type' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----- | ------------------ | ------ | | ----------------- | ----- | ------------------ | ------ |
| hid | num | 答题会话id | | | hid | num | 答题会话id | |
| mid | num | 答题用户UID | | | mid | num | 答题用户mid | |
| member | num | | | | member | num | | |
| score | num | 得分 | | | score | num | 得分 | |
| level | num | | | | level | num | | |
note/action.md
+5 -5
View File
@@ -17,8 +17,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ | | ------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| aid | num | 目标稿件avID | 必要 | | | aid | num | 目标稿件avid | 必要 | |
| note_id | num | 笔记ID | 非必要 | 创建时无需此项 | | note_id | num | 笔记id | 非必要 | 创建时无需此项 |
| title | str | 笔记标题 | 必要 | | | title | str | 笔记标题 | 必要 | |
| summary | str | 笔记预览文本 | 必要 | | | summary | str | 笔记预览文本 | 必要 | |
| content | str | 笔记正文json序列 | 必要 | 格式见[附表](readme.md#附表-笔记正文序列格式) | | 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 | 必要 | | | aid | num | 目标稿件avid | 必要 | |
| note_id | num | 笔记ID | 非必要 | | | note_id | num | 笔记id | 非必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
note/info.md
+12 -12
View File
@@ -17,8 +17,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------ | ----------- | -------- | | ------- | ---- | ------------ | ----------- | -------- |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| csrf | str | CSRF Token（位于cookie） | 非必要 | | | csrf | str | CSRF Token（位于cookie） | 非必要 | |
**json回复：** **json回复：**
@@ -42,13 +42,13 @@
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---------------- | | ---- | ---- | ----------- | ---------------- |
| 0 | num | 笔记ID | | | 0 | num | 笔记id | |
**示例：** **示例：**
查询视频`av970322090`/`BV1op4y167Uo`的笔记ID 查询视频`av970322090`/`BV1op4y167Uo`的笔记id
avID方式： avid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/note/list/archive' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/note/list/archive' \ 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相同不影响返回 | | aid | num | 稿件avid | 必要（可选）| avid与bvid任选一个，不与笔记所属稿件avid相同不影响返回 |
| bvid | str | 稿件bvID | 必要（可选）| avID与bvID任选一个，不与笔记所属稿件bvID相同不影响返回 | | bvid | str | 稿件bvid | 必要（可选）| avid与bvid任选一个，不与笔记所属稿件bvid相同不影响返回 |
| note_id | num | 笔记ID | 必要 | | | note_id | num | 笔记id | 必要 | |
**json回复：** **json回复：**
@@ -119,7 +119,7 @@ curl 'http://api.bilibili.com/x/note/list/archive' \
| tags | array | 笔记跳转标签列表 | | | tags | array | 笔记跳转标签列表 | |
| cid_count | num | 视频分P数 | | | cid_count | num | 视频分P数 | |
| audit_status | num | 0 | 作用暂不明确 | | audit_status | num | 0 | 作用暂不明确 |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
`data`中的`tags`数组： `data`中的`tags`数组：
@@ -143,7 +143,7 @@ curl 'http://api.bilibili.com/x/note/list/archive' \
查询视频`av583785685`/`BV1kz4y1X7XP`中笔记`7165769906913287`的内容 查询视频`av583785685`/`BV1kz4y1X7XP`中笔记`7165769906913287`的内容
avID方式： avid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/note/info' \ curl 'http://api.bilibili.com/x/note/info' \
@@ -152,7 +152,7 @@ curl 'http://api.bilibili.com/x/note/info' \
-b 'SESSDATA=xxx' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/note/info' \ curl 'http://api.bilibili.com/x/note/info' \
note/list.md
+3 -3
View File
@@ -52,15 +52,15 @@
| summary | str | 笔记预览文本 | | | summary | str | 笔记预览文本 | |
| mtime | str | 提交时间 | | | mtime | str | 提交时间 | |
| arc | obj | 视频信息 | | | arc | obj | 视频信息 | |
| note_id | num | 笔记ID | | | note_id | num | 笔记id | |
| audit_status | num | 0 | 作用尚不明确 | | audit_status | num | 0 | 作用尚不明确 |
`list`中的`arc`中的对象： `list`中的`arc`中的对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | ---------------------- | | ------ | ---- | ------------ | ---------------------- |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
| bvid | str | 稿件bvID | | | bvid | str | 稿件bvid | |
| pic | str | 稿件封面图片url | | | pic | str | 稿件封面图片url | |
| desc | str | 视频简介 | | | desc | str | 视频简介 | |
| status | num | 0 | | | status | num | 0 | |
other/API_auth.md
+2 -2
View File
@@ -15,8 +15,8 @@ Token有效期为1月，更改密码或过期失效
| cookie项 | 含义 | 备注 | | cookie项 | 含义 | 备注 |
| ----------------- | ----------------- | ------------------------------------------ | | ----------------- | ----------------- | ------------------------------------------ |
| DedeUserID | 当前用户UID | | | DedeUserID | 当前用户mid | |
| DedeUserID__ckMd5 | 用户UID md5校验值 | | | DedeUserID__ckMd5 | 用户mid md5校验值 | |
| SESSDATA | 登录Token | 用于用户识别与鉴权<br />作用同`access_key` | | SESSDATA | 登录Token | 用于用户识别与鉴权<br />作用同`access_key` |
| bili_jct | CSRF Token | 用于操作性接口 | | bili_jct | CSRF Token | 用于操作性接口 |
other/bvID.md → other/bvid_desc.md
+12 -16
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站东方要完？泪目~~ ~~暗示B站东方要完？泪目~~
## av->bv算法： ## 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 2. 以i为循环变量循环6次b[i]=(a/58^i)%58
3. 将b[i]中各个数字转换为以下码表中的字符 3. 将b[i]中各个数字转换为以下码表中的字符
@@ -112,14 +112,12 @@ const unsigned long long add = 8728348608; //固定加法值
const int s[] = {11, 10, 3, 8, 4, 6}; //位置编码表 const int s[] = {11, 10, 3, 8, 4, 6}; //位置编码表
//初始化反查码表 //初始化反查码表
void tr_init() void tr_init() {
{
for (int i = 0; i < 58; i++) for (int i = 0; i < 58; i++)
tr[table[i]] = 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 r = 0;
unsigned long long av; unsigned long long av;
for (int i = 0; i < 6; i++) for (int i = 0; i < 6; i++)
@@ -128,8 +126,7 @@ unsigned long long bv2av(char bv[])
return av; return av;
} }
char* av2bv(unsigned long long av) char* av2bv(unsigned long long av) {
{
char* result = (char*)malloc(13); char* result = (char*)malloc(13);
strcpy(result,"BV1 4 1 7 "); strcpy(result,"BV1 4 1 7 ");
av = (av ^ Xor) + add; av = (av ^ Xor) + add;
@@ -138,8 +135,7 @@ char* av2bv(unsigned long long av)
return result; return result;
} }
int main() int main() {
{
tr_init(); tr_init();
printf("%s\n",av2bv(170001)); printf("%s\n",av2bv(170001));
printf("%u\n",bv2av("BV17x411w7KC")); printf("%u\n",bv2av("BV17x411w7KC"));
ranking&dynamic/dynamic.md
+2 -2
View File
@@ -16,7 +16,7 @@
| ------ | ---- | ----------- | ------ | ------- | | ------ | ---- | ----------- | ------ | ------- |
| pn | num | 页码 | 非必要 | 默认为1 | | pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为5 | | ps | num | 每页项数 | 非必要 | 默认为5 |
| rid | num | 目标分区tID | 必要 | | | rid | num | 目标分区tid | 必要 | |
**json回复：** **json回复：**
@@ -58,7 +58,7 @@
**示例：** **示例：**
获取`tID=21`（生活->日常）分区中的2条最新动态视频信息 获取`tid=21`（生活->日常）分区中的2条最新动态视频信息
```shell ```shell
curl -G 'http://api.bilibili.com/x/web-interface/dynamic/region' \ curl -G 'http://api.bilibili.com/x/web-interface/dynamic/region' \
ranking&dynamic/ranking.md
+2 -2
View File
@@ -20,7 +20,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ------------------------------------- | | ------ | ---- | ----------- | ------ | ------------------------------------- |
| day | num | 页码 | 非必要 | 3：三日榜<br />7：一周榜<br />默认为3 | | day | num | 页码 | 非必要 | 3：三日榜<br />7：一周榜<br />默认为3 |
| rid | num | 目标分区tID | 必要 | | | rid | num | 目标分区tid | 必要 | |
**json回复：** **json回复：**
@@ -48,7 +48,7 @@
**示例：** **示例：**
获取`tID=1`（动画）分区中的三日视频排行榜 获取`tid=1`（动画）分区中的三日视频排行榜
```shell ```shell
curl -G 'http://api.bilibili.com/x/web-interface/ranking/region' \ curl -G 'http://api.bilibili.com/x/web-interface/ranking/region' \
search/hot.md
+4 -4
View File
@@ -28,13 +28,13 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | --------------- | -------------- | | ---------- | ---- | --------------- | -------------- |
| seid | str | 搜索seID | | | seid | str | 搜索seid | |
| id | num | 默认搜索ID | | | id | num | 默认搜索id | |
| type | num | 0 | | | type | num | 0 | |
| show_name | str | 显示文字 | | | show_name | str | 显示文字 | |
| name | str | 空 | | | name | str | 空 | |
| goto_type | num | 跳转类型 | 1：视频 | | goto_type | num | 跳转类型 | 1：视频 |
| goto_value | str | 搜索目标ID | 视频：稿件avID | | goto_value | str | 搜索目标id | 视频：稿件avid |
| url | str | 搜索目标跳转url | | | url | str | 搜索目标跳转url | |
**示例：** **示例：**
@@ -85,7 +85,7 @@ curl 'http://api.bilibili.com/x/web-interface/search/default'
| exp_str | str | ？？？ | | | exp_str | str | ？？？ | |
| code | num | 返回值 | 0：成功 | | code | num | 返回值 | 0：成功 |
| cost | obj | 详细搜索用时 | 大概是吧？ | | cost | obj | 详细搜索用时 | 大概是吧？ |
| seid | str | 搜索seID | | | seid | str | 搜索seid | |
| timestamp | num | 榜单统计时间 | 时间戳 | | timestamp | num | 榜单统计时间 | 时间戳 |
| message | str | 错误信息 | 默认为success | | message | str | 错误信息 | 默认为success |
| list | array | 热搜列表 | | | list | array | 热搜列表 | |
search/search_request.md
+2 -2
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 | | order_sort | num | 用户粉丝数及等级排序顺序 | 非必要 | 仅用于搜索用户<br />默认为0<br />由高到低：0<br/>由低到高：1 |
| user_type | num | 用户分类筛选 | 非必要 | 仅用于搜索用户<br />默认为0<br />全部用户：0<br/>up主：1<br/>普通用户：2<br/>认证用户：3 | | 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 | | 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 | | 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 | | 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 | 当前页码 | | | page | num | 当前页码 | |
| pagesize | num | 每页条数 | 固定20 | | pagesize | num | 每页条数 | 固定20 |
| numResults | num | 总条数 | 最大值为1000 | | numResults | num | 总条数 | 最大值为1000 |
search/search_response.md
+23 -23
View File
@@ -20,14 +20,14 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------------- | ----- | -------------- | ----------------------------------------- | | -------------- | ----- | -------------- | ----------------------------------------- |
| type | str | 结果类型 | 固定为video | | type | str | 结果类型 | 固定为video |
| id | num | 结果ID | 为稿件avID | | id | num | 结果 | 为稿件avid |
| author | str | UP主昵称 | | | author | str | UP主昵称 | |
| mid | num | UP主UID | | | mid | num | UP主mid | |
| typeid | str | 视频分区tID | | | typeid | str | 视频分区tid | |
| typename | str | 视频子分区名 | | | typename | str | 视频子分区名 | |
| arcurl | str | 视频重定向url | | | arcurl | str | 视频重定向url | |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
| bvid | str | 稿件bvID | | | bvid | str | 稿件bvid | |
| title | str | 视频标题 | 关键字用xml标签`<em class="keyword">`标注 | | title | str | 视频标题 | 关键字用xml标签`<em class="keyword">`标注 |
| description | str | 视频简介 | | | description | str | 视频简介 | |
| arcrank | str | 0 | **作用尚不明确** | | arcrank | str | 0 | **作用尚不明确** |
@@ -107,8 +107,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------------- | ------------------------------- | ---------------------------- | ------------------------------------------------------------ | | ---------------- | ------------------------------- | ---------------------------- | ------------------------------------------------------------ |
| type | str | 结果类型 | media_bangumi：番剧<br />media_ft：影视 | | type | str | 结果类型 | media_bangumi：番剧<br />media_ft：影视 |
| media_id | num | 剧集mdID | | | media_id | num | 剧集mdid | |
| season_id | num | 剧集ssID | | | season_id | num | 剧集ssid | |
| title | str | 剧集标题 | 关键字用xml标签`<em class="keyword">`标注 | | title | str | 剧集标题 | 关键字用xml标签`<em class="keyword">`标注 |
| org_title | str | 剧集原名 | 关键字用xml标签`<em class="keyword">`标注<br />可为空 | | org_title | str | 剧集原名 | 关键字用xml标签`<em class="keyword">`标注<br />可为空 |
| cover | str | 剧集封面url | | | cover | str | 剧集封面url | |
@@ -133,8 +133,8 @@
| angle_title | str | 角标内容 | | | angle_title | str | 角标内容 | |
| angle_color | num | 角标颜色 | 0：红色<br />2：橙色 | | angle_color | num | 角标颜色 | 0：红色<br />2：橙色 |
| display_info | array | 剧集标志信息 | | | display_info | array | 剧集标志信息 | |
| hit_epids | str | 关键字匹配分集标题的分集epID | 多个用`,`分隔 | | hit_epids | str | 关键字匹配分集标题的分集epid | 多个用`,`分隔 |
| pgc_season_id | num | 剧集ssID | | | pgc_season_id | num | 剧集ssid | |
| season_type | num | 剧集类型 | 1：番剧<br />2：电影<br />3：纪录片<br />4：国创<br />5：电视剧<br />7：综艺 | | season_type | num | 剧集类型 | 1：番剧<br />2：电影<br />3：纪录片<br />4：国创<br />5：电视剧<br />7：综艺 |
| season_type_name | str | 剧集类型文字 | | | season_type_name | str | 剧集类型文字 | |
| selection_style | str | 分集选择按钮风格 | horizontal：横排式<br />grid：按钮式 | | selection_style | str | 分集选择按钮风格 | horizontal：横排式<br />grid：按钮式 |
@@ -192,7 +192,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | ------------- | ---- | | ------------ | ----- | ------------- | ---- |
| id | num | 分集epID | | | id | num | 分集epid | |
| cover | str | 分集封面url | | | cover | str | 分集封面url | |
| title | str | 完整标题 | | | title | str | 完整标题 | |
| url | str | 分集重定向url | | | url | str | 分集重定向url | |
@@ -337,7 +337,7 @@
| ----------- | ----- | -------------- | ----------------------------------------- | | ----------- | ----- | -------------- | ----------------------------------------- |
| type | str | 结果类型 | 固定为live_room | | type | str | 结果类型 | 固定为live_room |
| rank_offset | num | 搜索结果排名值 | | | rank_offset | num | 搜索结果排名值 | |
| uid | num | 主播UID | | | uid | num | 主播mid | |
| tas | str | 直播间TAG | 多个用`,`分隔 | | tas | str | 直播间TAG | 多个用`,`分隔 |
| hit_columns | array | 关键字匹配类型 | | | hit_columns | array | 关键字匹配类型 | |
| live_time | str | 开播时间 | YYYY-MM-DD HH:MM:SS | | live_time | str | 开播时间 | YYYY-MM-DD HH:MM:SS |
@@ -353,7 +353,7 @@
| online | num | 在线人数 | | | online | num | 在线人数 | |
| rank_index | num | 0 | **作用尚不明确** | | rank_index | num | 0 | **作用尚不明确** |
| rank_score | num | 结果排序量化值 | | | rank_score | num | 结果排序量化值 | |
| roomid | num | 直播间ID | | | roomid | num | 直播间id | |
| attentions | num | 主播粉丝数 | | | attentions | num | 主播粉丝数 | |
`直播间条目`中的`hit_columns`数组： `直播间条目`中的`hit_columns`数组：
@@ -405,7 +405,7 @@
| ----------- | ----- | -------------- | ------------------------------------------------------ | | ----------- | ----- | -------------- | ------------------------------------------------------ |
| type | str | 结果类型 | 固定为live_user | | type | str | 结果类型 | 固定为live_user |
| rank_offset | num | 搜索结果排名值 | | | rank_offset | num | 搜索结果排名值 | |
| uid | num | 主播UID | | | uid | num | 主播mid | |
| tas | str | 直播间TAG | 多个用`,`分隔 | | tas | str | 直播间TAG | 多个用`,`分隔 |
| live_time | str | 开播时间 | YYYY-MM-DD HH:MM:SS<br />如未开播为0000-00-00 00:00:00 | | live_time | str | 开播时间 | YYYY-MM-DD HH:MM:SS<br />如未开播为0000-00-00 00:00:00 |
| hit_columns | array | 关键字匹配类型 | | | hit_columns | array | 关键字匹配类型 | |
@@ -464,16 +464,16 @@
| pub_time | num | 投稿时间 | 时间戳 | | pub_time | num | 投稿时间 | 时间戳 |
| like | num | 获赞数 | | | like | num | 获赞数 | |
| title | str | 标题 | | | title | str | 标题 | |
| mid | num | UP主UID | | | mid | num | UP主mid | |
| image_urls | array | 封面图组 | | | image_urls | array | 封面图组 | |
| template_id | num | ？？？ | **作用尚不明确** | | template_id | num | ？？？ | **作用尚不明确** |
| category_id | num | 专栏分区ID | | | category_id | num | 专栏分区 | |
| view | num | 阅读数 | | | view | num | 阅读数 | |
| reply | num | 评论数 | | | reply | num | 评论数 | |
| rank_index | num | 0 | **作用尚不明确** | | rank_index | num | 0 | **作用尚不明确** |
| desc | str | 文章预览 | | | desc | str | 文章预览 | |
| rank_score | num | 结果排序量化值 | | | rank_score | num | 结果排序量化值 | |
| id | num | 专栏cvID | | | id | num | 专栏cvid | |
| category_name | str | 子分区名 | | | category_name | str | 子分区名 | |
`专栏条目`中的`covers`数组： `专栏条目`中的`covers`数组：
@@ -532,7 +532,7 @@
| click | num | ？？？ | **作用尚不明确** | | click | num | ？？？ | **作用尚不明确** |
| tp_type | num | ？？？ | **作用尚不明确** | | tp_type | num | ？？？ | **作用尚不明确** |
| keyword | str | 空 | **作用尚不明确** | | keyword | str | 空 | **作用尚不明确** |
| tp_id | num | 话题tpID | | | tp_id | num | 话题tp | |
| rank_index | num | 0 | **作用尚不明确** | | rank_index | num | 0 | **作用尚不明确** |
| author | str | UP主昵称 | | | author | str | UP主昵称 | |
| arcurl | str | 话题页面重定向url | | | arcurl | str | 话题页面重定向url | |
@@ -584,7 +584,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ----- | -------------- | ----------------------------- | | --------------- | ----- | -------------- | ----------------------------- |
| type | str | 结果类型 | 固定为bili_user | | type | str | 结果类型 | 固定为bili_user |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| uname | str | 用户昵称 | | | uname | str | 用户昵称 | |
| usign | str | 用户签名 | | | usign | str | 用户签名 | |
| fans | num | 用户粉丝数 | | | fans | num | 用户粉丝数 | |
@@ -595,7 +595,7 @@
| gender | num | 用户性别 | 1：男<br />2：女<br />3：私密 | | gender | num | 用户性别 | 1：男<br />2：女<br />3：私密 |
| is_upuser | num | 是否为UP主 | 0：否<br />1：是 | | is_upuser | num | 是否为UP主 | 0：否<br />1：是 |
| is_live | num | 是否正在直播 | 0：否<br />1：是 | | is_live | num | 是否正在直播 | 0：否<br />1：是 |
| room_id | num | 用户直播间ID | | | room_id | num | 用户直播间id | |
| res | array | 用户投稿内容 | | | res | array | 用户投稿内容 | |
| official_verify | obj | 用户认证信息 | | | official_verify | obj | 用户认证信息 | |
| hit_columns | array | 关键字匹配类型 | | | hit_columns | array | 关键字匹配类型 | |
@@ -612,8 +612,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ----------------- | ---------------- | | -------------- | ---- | ----------------- | ---------------- |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
| bvid | str | 稿件bvID | | | bvid | str | 稿件bvid | |
| title | str | 视频标题 | | | title | str | 视频标题 | |
| pubdate | num | 视频投稿时间 | 时间戳 | | pubdate | num | 视频投稿时间 | 时间戳 |
| arcurl | str | 视频页面重定向url | | | arcurl | str | 视频页面重定向url | |
@@ -735,11 +735,11 @@
| hit_columns | array | 关键字匹配类型 | | | hit_columns | array | 关键字匹配类型 | |
| rank_offset | num | 搜索结果排名值 | | | rank_offset | num | 搜索结果排名值 | |
| cover | str | 相簿封面url | | | cover | str | 相簿封面url | |
| mid | num | UP主UID | | | mid | num | UP主mid | |
| uname | str | UP主昵称 | | | uname | str | UP主昵称 | |
| rank_index | num | 0 | **作用尚不明确** | | rank_index | num | 0 | **作用尚不明确** |
| view | num | 观看次数 | | | view | num | 观看次数 | |
| id | num | 相簿ID | | | id | num | 相簿id | |
| rank_score | num | 结果排序量化值 | | | rank_score | num | 结果排序量化值 | |
`相簿条目`中的`hit_columns`数组： `相簿条目`中的`hit_columns`数组：
user/info.md
+8 -8
View File
@@ -20,7 +20,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- | | ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | | | mid | num | 目标用户mid | 必要 | |
**json回复：** **json回复：**
@@ -37,7 +37,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ------------------------------------------------------------ | | ----------- | ---- | ---------------- | ------------------------------------------------------------ |
| mid | num | UID | | | mid | num | mid | |
| name | str | 昵称 | | | name | str | 昵称 | |
| sex | str | 性别 | 男/女/保密 | | sex | str | 性别 | 男/女/保密 |
| face | 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 | 提示文案 | | | content | str | 提示文案 | |
| url | str | 提示信息页面url | | | url | str | 提示信息页面url | |
| notice_type | num | ？ | 作用尚不明确<br />此字段非必须 | | notice_type | num | ？ | 作用尚不明确<br />此字段非必须 |
@@ -131,13 +131,13 @@
| title | str | 直播间标题 | | | title | str | 直播间标题 | |
| cover | str | 直播间封面url | | | cover | str | 直播间封面url | |
| online | num | 直播间人气 | 值为上次直播时刷新 | | online | num | 直播间人气 | 值为上次直播时刷新 |
| roomid | num | 直播间ID（短号） | | | roomid | num | 直播间id（短号） | |
| roundStatus | num | 轮播状态 | 0：未轮播<br />1：轮播 | | roundStatus | num | 轮播状态 | 0：未轮播<br />1：轮播 |
| broadcast_type | num | 0 | | | broadcast_type | num | 0 | |
**示例：** **示例：**
查询用户`UID=2`的详细信息 查询用户`mid=2`的详细信息
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/acc/info' \ 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：否 | | photo | bool | 是否请求用户主页头图 | 非必要 | true：是<br />false：否 |
**json回复：** **json回复：**
@@ -303,7 +303,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ----- | -------------- | ------------------------------------------------------------ | | --------------- | ----- | -------------- | ------------------------------------------------------------ |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| approve | bool | false | **作用尚不明确** | | approve | bool | false | **作用尚不明确** |
| name | str | 用户昵称 | | | name | str | 用户昵称 | |
| sex | str | 用户性别 | 男 女 保密 | | sex | str | 用户性别 | 男 女 保密 |
@@ -507,7 +507,7 @@ curl -G 'api.bilibili.com/x/web-interface/card' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | ------------------------ | | --------------- | ---- | ------------ | ------------------------ |
| mid | num | UID | | | mid | num | mid | |
| name | str | 昵称 | | | name | str | 昵称 | |
| sex | str | 性别 | 男 女 保密 | | sex | str | 性别 | 男 女 保密 |
| face | str | 头像图片url | | | face | str | 头像图片url | |
user/relation.md
+83 -83
View File
@@ -15,7 +15,7 @@
- [查询关注分组列表](#查询关注分组列表) - [查询关注分组列表](#查询关注分组列表)
- [查询关注分组明细](#查询关注分组明细) - [查询关注分组明细](#查询关注分组明细)
- [查询目标用户所在的分组](#查询目标用户所在的分组 ) - [查询目标用户所在的分组](#查询目标用户所在的分组 )
- [查询所有特别关注的UID](#查询所有特别关注的UID) - [查询所有特别关注的mid](#查询所有特别关注的mid)
- [创建分组](#创建分组) - [创建分组](#创建分组)
- [重命名分组](#重命名分组) - [重命名分组](#重命名分组)
- [删除分组](#删除分组) - [删除分组](#删除分组)
@@ -42,7 +42,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---------------------------------- | | ---------- | ---- | ------------ | ----------- | ---------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| vmid | num | 目标用户UID | 必要 | | | vmid | num | 目标用户mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 | | ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 | | pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 |
@@ -77,7 +77,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | --------------------------------------- | | --------------- | ---- | ------------ | --------------------------------------- |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 | | attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 成为粉丝时间 | 时间戳<br />互关后刷新 | | mtime | num | 成为粉丝时间 | 时间戳<br />互关后刷新 |
| tag | null | | | | tag | null | | |
@@ -116,7 +116,7 @@
**示例：** **示例：**
获取用户`UID=293793435`的粉丝明细 获取用户`mid=293793435`的粉丝明细
```shell ```shell
curl -G 'http://api.bilibili.com/x/relation/followers' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| vmid | num | 目标用户UID | 必要 | | | vmid | num | 目标用户mid | 必要 | |
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention | | order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
| ps | num | 每页项数 | 非必要 | 默认为50 | | ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 | | pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 |
@@ -247,10 +247,10 @@ data 对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---------------------------------------- | ------------ | --------------------------------------- | | --------------- | ---------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 | | attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 | | mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | | | tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 | | special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | | | uname | str | 用户昵称 | |
| face | str | 用户头像url | | | face | str | 用户头像url | |
@@ -262,8 +262,8 @@ data 对象：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- | | ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | | | 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组ID | | | n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… | | …… | num | …… | …… |
`list`中的对象中的`official_verify`对象： `list`中的对象中的`official_verify`对象：
@@ -294,7 +294,7 @@ data 对象：
**示例：** **示例：**
获取用户`UID=293793435`的关注明细，按照关注顺序 获取用户`mid=293793435`的关注明细，按照关注顺序
```shell ```shell
curl -G 'http://api.bilibili.com/x/relation/ollowings' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| vmid | str | 目标用户UID | 必要 | | | vmid | str | 目标用户mid | 必要 | |
| name | str | 搜索关键词 | 必要 | | | name | str | 搜索关键词 | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 | | ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 | | pn | num | 页码 | 非必要 | 默认为1 |
@@ -413,10 +413,10 @@ data 对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- | | --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 | | attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 | | mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | | | tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 | | special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | | | uname | str | 用户昵称 | |
| face | str | 用户头像url | | | face | str | 用户头像url | |
@@ -428,8 +428,8 @@ data 对象：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- | | ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | | | 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组ID | | | n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… | | …… | num | …… | …… |
`list`中的对象中的`official_verify`对象： `list`中的对象中的`official_verify`对象：
@@ -533,7 +533,7 @@ curl -G 'http://api.bilibili.com/x/relation/followings/search' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- | | ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| vmid | num | 目标用户UID | 必要 | | | vmid | num | 目标用户mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 | | ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 | | pn | num | 页码 | 非必要 | 默认为1 |
@@ -568,10 +568,10 @@ data 对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- | | --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 | | attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 | | mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | | | tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 | | special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | | | uname | str | 用户昵称 | |
| face | str | 用户头像url | | | face | str | 用户头像url | |
@@ -583,8 +583,8 @@ data 对象：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- | | ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | | | 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组ID | | | n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… | | …… | num | …… | …… |
`list`中的对象中的`official_verify`对象： `list`中的对象中的`official_verify`对象：
@@ -615,7 +615,7 @@ data 对象：
**示例：** **示例：**
获取自己与用户`UID=2`的共同关注明细 获取自己与用户`mid=2`的共同关注明细
```shell ```shell
curl -G 'http://api.bilibili.com/x/relation/same/followings' \ 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：已互粉 | | attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 | | mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | | | tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 | | special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | | | uname | str | 用户昵称 | |
| face | str | 用户头像url | | | face | str | 用户头像url | |
@@ -761,8 +761,8 @@ data 对象：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- | | ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | | | 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组ID | | | n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… | | …… | num | …… | …… |
`list`中的对象中的`official_verify`对象： `list`中的对象中的`official_verify`对象：
@@ -894,7 +894,7 @@ data 对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | ---------------------- | | --------------- | ---- | ------------ | ---------------------- |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| attribute | num | 关注属性 | 128：已拉黑 | | attribute | num | 关注属性 | 128：已拉黑 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 | | mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | null | | | | tag | null | | |
@@ -1029,7 +1029,7 @@ curl -G 'http://api.bilibili.com/x/relation/blacks' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------------------- | | ---------- | ---- | ------------------------ | -------------- | -------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| fid | num | 目标用户UID | 必要 | | | fid | num | 目标用户mid | 必要 | |
| act | num | 操作代码 | 必要 | **操作代码见下表** | | act | num | 操作代码 | 必要 | **操作代码见下表** |
| re_src | num | 关注来源代码 | 必要 | 空间：11<br />视频：14<br />文章：115<br />活动页面：222 | | re_src | num | 关注来源代码 | 必要 | 空间：11<br />视频：14<br />文章：115<br />活动页面：222 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@@ -1058,7 +1058,7 @@ curl -G 'http://api.bilibili.com/x/relation/blacks' \
**示例：** **示例：**
关注`UID=14082`的用户 关注`mid=14082`的用户
```shell ```shell
curl 'http://api.bilibili.com/x/relation/modify' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 目标用户UID | 必要 | 每个ID之间用`,`间隔 | | fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
| act | num | 操作代码 | 必要 | 同上<br />仅可为1或5，故只能进行批量关注和拉黑 | | act | num | 操作代码 | 必要 | 同上<br />仅可为1或5，故只能进行批量关注和拉黑 |
| re_src | num | 关注来源代码 | 必要 | 同上 | | re_src | num | 关注来源代码 | 必要 | 同上 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | 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`数组： `data`中的`failed_fids`数组：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------------- | ---- | | ---- | ---- | -------------------- | ---- |
| 0 | num | 操作失败的UID 1 | | | 0 | num | 操作失败的mid 1 | |
| n | num | 操作失败的UID（n+1） | | | n | num | 操作失败的mid（n+1） | |
| …… | num | …… | …… | | …… | num | …… | …… |
**示例：** **示例：**
批量关注`UID=1,2,3,4,5`的用户 批量关注`mid=1,2,3,4,5`的用户
```shell ```shell
curl 'http://http://api.bilibili.com/x/relation/batch/modify' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| fid | num | 目标用户UID | 必要 | | | fid | num | 目标用户mid | 必要 | |
**json回复：** **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：拉黑 | | attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
| mtime | num | 关注对方时间 | 时间戳<br />未关注为0 | | mtime | num | 关注对方时间 | 时间戳<br />未关注为0 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | | | tag | null默认分组<br />array存在至少一个分组 | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 | | special | num | 特别关注标志 | 0：否<br />1：是 |
`tag`数组： `tag`数组：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- | | ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | | | 0 | num | 位于分组1的分组 | |
| n | num | 位于分组（n+1）的分组ID | | | n | num | 位于分组（n+1）的分组 | |
| …… | num | …… | …… | | …… | num | …… | …… |
**示例：** **示例：**
可得对于`UID=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于ID为`-10`分组中 可得对于`mid=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于为`-10`分组中
```shell ```shell
curl -G 'http://http://api.bilibili.com/x/relation' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| mid | num | 目标用户UID | 必要 | | | mid | num | 目标用户mid | 必要 | |
**json回复：** **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：拉黑 | | attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
| mtime | num | 关注对方时间 | 互关后刷新时间 | | mtime | num | 关注对方时间 | 互关后刷新时间 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | | | tag | null默认分组<br />array存在至少一个分组 | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 | | special | num | 特别关注标志 | 0：否<br />1：是 |
`data`中的`be_relation`对象： `data`中的`be_relation`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ---------------------------------------- | ------------ | -------------- | | --------- | ---------------------------------------- | ------------ | -------------- |
| mid | num | 自己的UID | | | mid | num | 自己的mid | |
| attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 | | attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
| mtime | num | 成为粉丝时间 | 互关后刷新时间 | | mtime | num | 成为粉丝时间 | 互关后刷新时间 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | | | tag | null默认分组<br />array存在至少一个分组 | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 | | special | num | 特别关注标志 | 0：否<br />1：是 |
`be_relation`与`relation`中的`tag`数组： `be_relation`与`relation`中的`tag`数组：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- | | ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | | | 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组ID | | | n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… | | …… | 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 ```shell
curl -G 'http://api.bilibili.com/x/space/acc/relation' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 目标用户UID | 必要 | 每个ID之间用`,`间隔 | | fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
**json回复：** **json回复：**
@@ -1359,30 +1359,30 @@ curl -G 'http://api.bilibili.com/x/space/acc/relation' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ---------- | ---- | | --------- | ---- | ---------- | ---- |
| {用户UID} | obj | 关注的用户 | 下同 | | {用户mid} | obj | 关注的用户 | 下同 |
| …… | obj | …… | | | …… | obj | …… | |
`{用户UID}`对象： `{用户mid}`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | --------------------------------------- | ------------ | ------------------------------------------------------------ | | --------- | --------------------------------------- | ------------ | ------------------------------------------------------------ |
| mid | num | 目标用户UID | | | mid | num | 目标用户mid | |
| attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 | | attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
| mtime | num | 关注对方时间 | 时间戳<br />未关注为0 | | mtime | num | 关注对方时间 | 时间戳<br />未关注为0 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | | | tag | null默认分组<br />array存在至少一个分组 | 分组id | |
| special | num | 特别关注标志 | 0：否<br />1：是 | | special | num | 特别关注标志 | 0：否<br />1：是 |
`tag`数组： `tag`数组：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- | | ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | | | 0 | num | 位于分组1的分组id | |
| n | num | 位于分组（n+1）的分组ID | | | n | num | 位于分组（n+1）的分组id | |
| …… | num | …… | …… | | …… | num | …… | …… |
**示例：** **示例：**
批量查询`UID=1,2,3,4,5`的关系 批量查询`mid=1,2,3,4,5`的关系
```shell ```shell
curl -G 'http://http://api.bilibili.com/x/relation/relations' \ 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 | 分组名称 | | | name | str | 分组名称 | |
| count | num | 分组成员数 | | | count | num | 分组成员数 | |
**示例：** **示例：**
查询所有的分组的名字以及ID 查询所有的分组的名字以及id
```shell ```shell
curl 'http://api.bilibili.com/x/relation/tags' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组ID | 必要 | 特别关注恒为-10<br />默认分组恒为0 | | tagid | num | 分组id | 必要 | 特别关注恒为-10<br />默认分组恒为0 |
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention | | order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
| ps | num | 每页项数 | 非必要 | 默认为50 | | ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页数 | 非必要 | 默认为1 | | pn | num | 页数 | 非必要 | 默认为1 |
@@ -1541,7 +1541,7 @@ curl 'http://api.bilibili.com/x/relation/tags' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------- | ---- | | --------------- | ---- | ----------- | ---- |
| mid | num | 用户UID | | | mid | num | 用户mid | |
| uname | str | 用户昵称 | | | uname | str | 用户昵称 | |
| face | str | 用户头像url | | | face | str | 用户头像url | |
| sign | str | 用户签名 | | | sign | str | 用户签名 | |
@@ -1576,7 +1576,7 @@ curl 'http://api.bilibili.com/x/relation/tags' \
**示例：** **示例：**
以每页2项的方式获取了ID为`207542`分组的第1页的粉丝明细，按照关注顺序 以每页2项的方式获取了id为`207542`分组的第1页的粉丝明细，按照关注顺序
```shell ```shell
curl -G 'http://api.bilibili.com/x/relation/tag' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| fid | num | 目标用户UID | 必要 | | | fid | num | 目标用户mid | 必要 | |
**json回复：** **json回复：**
@@ -1673,13 +1673,13 @@ curl -G 'http://api.bilibili.com/x/relation/tag' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | --------- | ---- | | ------------------- | ---- | --------- | ---- |
| ｛加入的分组ID 1｝ | str | 分组1名称 | | | {加入的分组id 1} | str | 分组1名称 | |
| ｛加入的分组ID n｝ | str | 分组n名称 | | | {加入的分组id n} | str | 分组n名称 | |
| …… | str | …… | | | …… | str | …… | |
**示例：** **示例：**
查询用户`UID=319214221`存在的所有分组ID和名称 查询用户`mid=319214221`存在的所有分组和名称
```shell ```shell
curl -G 'http://api.bilibili.com/x/relation/tag/user' \ 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> </details>
### 查询所有特别关注的UID ### 查询所有特别关注的mid
> http://api.bilibili.com/x/relation/tag/special > 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 | | | 0 | num | 成员1mid | |
| n | num | 成员（n+1）UID | | | n | num | 成员（n+1）mid | |
| …… | num | …… | …… | | …… | 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 ```shell
curl 'http://api.bilibili.com/x/relation/tag/create' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组ID | 必要 | | | tagid | num | 分组id | 必要 | |
| name | str | 新名称 | 必要 | 最长16字符 | | name | str | 新名称 | 必要 | 最长16字符 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@@ -1868,7 +1868,7 @@ curl 'http://api.bilibili.com/x/relation/tag/create' \
**示例：** **示例：**
把ID为`194112`的分组更名为`膜法师` 把id为`194112`的分组更名为`膜法师`
```shell ```shell
curl 'http://api.bilibili.com/x/relation/tag/update' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组ID | 必要 | | | tagid | num | 分组id | 必要 | |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：** **json回复：**
@@ -1921,7 +1921,7 @@ curl 'http://api.bilibili.com/x/relation/tag/update' \
示例： 示例：
删除分组ID为`216699`的分组 删除分组id为`216699`的分组
```shell ```shell
curl 'http://api.bilibili.com/x/relation/tag/del' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 目标用户UID | 必要 | 每个ID之间用`,`间隔 | | fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
| tagids | nums | 分组ID | 必要 | 每个ID之间用`,`间隔 | | tagids | nums | 分组id | 必要 | 每个之间用`,`间隔 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：** **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 ```shell
curl 'http://api.bilibili.com/x/relation/tags/addUsers' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 待复制的用户UID | 必要 | 每个ID之间用`,`间隔 | | fids | nums | 待复制的用户mid | 必要 | 每个之间用`,`间隔 |
| tagids | nums | 目标分组ID | 必要 | 每个ID之间用`,`间隔 | | tagids | nums | 目标分组id | 必要 | 每个之间用`,`间隔 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：** **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 ```shell
curl 'http://api.bilibili.com/x/relation/tags/copyUsers' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| beforeTagids | nums | 原分组ID | 必要 | 每个ID之间用`,`间隔 | | beforeTagids | nums | 原分组id | 必要 | 每个之间用`,`间隔 |
| afterTagids | nums | 新分组ID | 必要 | 每个ID之间用`,`间隔 | | afterTagids | nums | 新分组id | 必要 | 每个之间用`,`间隔 |
| fids | nums | 待移动的用户UID | 必要 | 每个ID之间用`,`间隔 | | fids | nums | 待移动的用户mid | 必要 | 每个之间用`,`间隔 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：** **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 ```shell
curl 'http://api.bilibili.com/x/relation/tags/moveUsers' \ curl 'http://api.bilibili.com/x/relation/tags/moveUsers' \
user/space.md
+95 -95
View File
@@ -65,7 +65,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- | | ------ | ---- | ----------- | ------ | ---- |
| vmid | num | 目标用户UID | 必要 | | | vmid | num | 目标用户mid | 必要 | |
**json回复：** **json回复：**
@@ -82,9 +82,9 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------------------ | ------------------------------------------------------------ | | ----------- | ---- | ------------------------------ | ------------------------------------------------------------ |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
| videos | num | 视频分P总数 | 默认为1 | | videos | num | 视频分P总数 | 默认为1 |
| tid | num | 分区tID | | | tid | num | 分区tid | |
| tname | str | 子分区名称 | | | tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1：原创<br />2：转载 | | copyright | num | 是否转载 | 1：原创<br />2：转载 |
| pic | str | 视频封面图片url | | | pic | str | 视频封面图片url | |
@@ -99,15 +99,15 @@
| owner | obj | 视频UP主信息 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`owner`对象 | | owner | obj | 视频UP主信息 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`owner`对象 |
| stat | obj | 视频状态数 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`stat`对象 | | stat | obj | 视频状态数 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`stat`对象 |
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 | | dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| cid | num | 视频1P CID | | | cid | num | 视频1P cid | |
| dimension | obj | 视频1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 | | dimension | obj | 视频1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 |
| bvid | str | 稿件bvID | | | bvid | str | 稿件bvid | |
| reason | str | 置顶视频备注 | | | reason | str | 置顶视频备注 | |
| inter_video | bool | 是否为合作视频 | false：否<br />true：是 | | inter_video | bool | 是否为合作视频 | false：否<br />true：是 |
**示例：** **示例：**
查询用户`UID=23215368`的置顶视频 查询用户`mid=23215368`的置顶视频
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/top/arc' \ 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任选一个 | | aid | num | 置顶目标稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 置顶目标稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 置顶目标稿件bvid | 必要（可选） | avid与bvid任选一个 |
| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符<br />默认为空 | | reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符<br />默认为空 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
@@ -215,7 +215,7 @@ curl -G 'http://api.bilibili.com/x/space/top/arc' \
置顶视频`av98948772`/`BV1n741127LD` 置顶视频`av98948772`/`BV1n741127LD`
avID方式： avid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/space/top/arc/set' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/space/top/arc/set' \ 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回复：** **json回复：**
@@ -332,7 +332,7 @@ curl 'http://api.bilibili.com/x/space/top/arc/cancel' \
**示例：** **示例：**
查询用户`UID=23215368`的代表作视频列表 查询用户`mid=23215368`的代表作视频列表
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/masterpiece' \ 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任选一个 | | aid | num | 置顶目标稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 置顶目标稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 置顶目标稿件bvid | 必要（可选） | avid与bvid任选一个 |
| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符<br />默认为空 | | reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符<br />默认为空 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
@@ -555,7 +555,7 @@ curl -G 'http://api.bilibili.com/x/space/masterpiece' \
添加视频`av94916552`/`BV1ZE411K7ux`到代表作列表 添加视频`av94916552`/`BV1ZE411K7ux`到代表作列表
avID方式： avid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/space/masterpiece/add' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/space/masterpiece/add' \ 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任选一个 | | aid | num | 要删除的目标稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 要删除的目标稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 要删除的目标稿件bvid | 必要（可选） | avid与bvid任选一个 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
@@ -616,7 +616,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/add' \
删除置顶视频`av59765630`/`BV1Yt41137T6` 删除置顶视频`av59765630`/`BV1Yt41137T6`
avID方式： avid方式：
```shell ```shell
curl 'api.bilibili.com/x/space/masterpiece/cancel' \ curl 'api.bilibili.com/x/space/masterpiece/cancel' \
@@ -625,7 +625,7 @@ curl 'api.bilibili.com/x/space/masterpiece/cancel' \
-b 'SESSDATA=xxx' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \ 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回复：** **json回复：**
@@ -673,7 +673,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ----- | ----------- | ---- | | ---- | ----- | ----------- | ---- |
| mid | num | 目标用户UID | | | mid | num | 目标用户mid | |
| tags | array | TAG名称 | | | tags | array | TAG名称 | |
`data`数组中的对象中的`tags`数组： `data`数组中的对象中的`tags`数组：
@@ -687,7 +687,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \
**示例：** **示例：**
查看用户`UID=53456`的个人TAG 查看用户`mid=53456`的个人TAG
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/acc/tags' \ 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回复：** **json回复：**
@@ -797,7 +797,7 @@ curl 'http://api.bilibili.com/x/space/acc/tags/set' \
**示例：** **示例：**
查看用户`UID=53456`的空间公告 查看用户`mid=53456`的空间公告
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/notice' \ 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回复：** **json回复：**
@@ -950,7 +950,7 @@ curl 'http://api.bilibili.com/x/space/notice/set' \
**示例：** **示例：**
查看`UID=2`的空间设置 查看`mid=2`的空间设置
```shell ```shell
curl -G 'http://space.bilibili.com/ajax/settings/getSettings' \ 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回复：** **json回复：**
@@ -1227,7 +1227,7 @@ curl 'http://space.bilibili.com/ajax/settings/setPrivacy' \
**示例：** **示例：**
查询`UID=2`的最近玩过的游戏 查询`mid=2`的最近玩过的游戏
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/lastplaygame' \ 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回复：** **json回复：**
@@ -1315,7 +1315,7 @@ curl -G 'http://api.bilibili.com/x/space/lastplaygame' \
**示例：** **示例：**
查看用户`UID=15858903`的最近投币视频 查看用户`mid=15858903`的最近投币视频
```shell ```shell
curl -G 'http://space.bilibili.com/x/space/coin/video' \ 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 | | 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主视频稿件 | | keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
| pn | num | 页码 | 必要 | | | pn | num | 页码 | 必要 | |
| ps | num | 每页项数 | 必要 | | | ps | num | 每页项数 | 必要 | |
@@ -1568,16 +1568,16 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------ | --------------------- | | ----- | ---- | ------------ | --------------------- |
| {tID} | obj | 该分区的详情 | 字段名为存在的分区tID | | {tid} | obj | 该分区的详情 | 字段名为存在的分区tid |
| …… | obj | …… | 向下扩展 | | …… | obj | …… | 向下扩展 |
`tlist`中的`{tID}`对象： `tlist`中的`{tid}`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------------- | ---- | | ----- | ---- | -------------------- | ---- |
| count | num | 投稿至该分区的视频数 | | | count | num | 投稿至该分区的视频数 | |
| name | str | 该分区名称 | | | name | str | 该分区名称 | |
| tid | num | 该分区tID | | | tid | num | 该分区tid | |
`list`中的`vlist`数组： `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主 | 不一定为目标用户（合作视频） | | author | str | 视频UP主 | 不一定为目标用户（合作视频） |
| bvid | str | 稿件bvID | | | bvid | str | 稿件bvid | |
| comment | num | 视频评论数 | | | comment | num | 视频评论数 | |
| copyright | str | 空 | 作用尚不明确 | | copyright | str | 空 | 作用尚不明确 |
| created | num | 投稿时间 | 时间戳 | | created | num | 投稿时间 | 时间戳 |
@@ -1602,13 +1602,13 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
| is_pay | num | 0 | 作用尚不明确 | | is_pay | num | 0 | 作用尚不明确 |
| is_union_video | num | 是否为合作视频 | 0：否<br />1：是 | | is_union_video | num | 是否为合作视频 | 0：否<br />1：是 |
| length | str | 视频长度 | MM:SS | | length | str | 视频长度 | MM:SS |
| mid | num | 视频UP主UID | 不一定为目标用户（合作视频） | | mid | num | 视频UP主mid | 不一定为目标用户（合作视频） |
| pic | str | 视频封面 | | | pic | str | 视频封面 | |
| play | num | 视频播放次数 | | | play | num | 视频播放次数 | |
| review | num | 0 | 作用尚不明确 | | review | num | 0 | 作用尚不明确 |
| subtitle | str | 空 | 作用尚不明确 | | subtitle | str | 空 | 作用尚不明确 |
| title | str | 视频标题 | | | title | str | 视频标题 | |
| typeid | num | 视频分区tID | | | typeid | num | 视频分区tid | |
| video_review | num | 视频弹幕数 | | | video_review | num | 视频弹幕数 | |
`data`中的`page`对象： `data`中的`page`对象：
@@ -1630,7 +1630,7 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
`pn`（页码）和`ps`（每页项数）只改变`vlist`中成员的多少与内容 `pn`（页码）和`ps`（每页项数）只改变`vlist`中成员的多少与内容
以每页2项查询用户`UID=53456`的第1页投稿视频明细 以每页2项查询用户`mid=53456`的第1页投稿视频明细
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/arc/search' \ 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 | | ps | num | 获取的相簿量 | 非必要 | 默认为8 |
**json回复：** **json回复：**
@@ -1779,10 +1779,10 @@ curl -G 'http://api.bilibili.com/x/space/arc/search' \
| count | num | 总计图片数 | | | count | num | 总计图片数 | |
| ctime | num | 发布时间 | 时间戳 | | ctime | num | 发布时间 | 时间戳 |
| description | str | 简介 | | | description | str | 简介 | |
| doc_id | num | 相簿ID | 非动态ID！！！ | | doc_id | num | 相簿id | 非动态！！！ |
| like | num | 点赞数 | | | like | num | 点赞数 | |
| pictures | array | 图片内容 | | | pictures | array | 图片内容 | |
| poster_uid | num | 上传用户UID | | | poster_uid | num | 上传用户mid | |
| title | str | 标题 | 动态内容无 | | title | str | 标题 | 动态内容无 |
| view | num | 浏览数 | | | view | num | 浏览数 | |
@@ -1805,7 +1805,7 @@ curl -G 'http://api.bilibili.com/x/space/arc/search' \
**示例：** **示例：**
查询用户`UID=53456`的投稿相簿预览 查询用户`mid=53456`的投稿相簿预览
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/album/index' \ 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_num | num | 页码 | 非必要 | 默认为1 |
| page_size | num | 每页项数 | 非必要 | 默认为20 | | page_size | num | 每页项数 | 非必要 | 默认为20 |
| biz | str | 查询类型 | 非必要 | 全部：all<br />绘画：draw<br />摄影：photo<br />日常：daily<br />默认为all | | 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 | 总计图片数 | | | count | num | 总计图片数 | |
| ctime | num | 发布时间 | 时间戳 | | ctime | num | 发布时间 | 时间戳 |
| description | str | 简介 | | | description | str | 简介 | |
| doc_id | num | 相簿ID | 非动态ID！！！ | | doc_id | num | 相簿id | 非动态！！！ |
| like | num | 点赞数 | | | like | num | 点赞数 | |
| pictures | array | 图片内容 | | | pictures | array | 图片内容 | |
| poster_uid | num | 上传用户UID | | | poster_uid | num | 上传用户mid | |
| title | str | 标题 | 动态内容无 | | title | str | 标题 | 动态内容无 |
| view | num | 浏览数 | | | view | num | 浏览数 | |
@@ -1940,7 +1940,7 @@ curl -G 'http://api.bilibili.com/x/space/album/index' \
**示例：** **示例：**
查询用户`UID=53456`的投稿明细中的全部类型 查询用户`mid=53456`的投稿明细中的全部类型
```shell ```shell
curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \ 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回复：** **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 | 频道内含视频数 | | | count | num | 频道内含视频数 | |
| cover | str | 封面图片url | | | cover | str | 封面图片url | |
| intro | str | 简介 | 无则为空 | | intro | str | 简介 | 无则为空 |
| mid | num | 创建用户UID | | | mid | num | 创建用户mid | |
| mtime | num | 创建时间 | 时间戳 | | mtime | num | 创建时间 | 时间戳 |
| name | str | 标题 | | | name | str | 标题 | |
**示例：** **示例：**
查询用户`UID=53456`的频道列表 查询用户`mid=53456`的频道列表
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/channel/list' \ 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 | 必要 | | | mid | num | 目标用户mid | 必要 | |
| cid | num | 目标频道ID | 必要 | | | cid | num | 目标频道id | 必要 | |
| pn | num | 页码 | 非必要 | 默认为1 | | pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为100 | | ps | num | 每页项数 | 非必要 | 默认为100 |
@@ -2179,11 +2179,11 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ------ | -------------- | -------- | | -------- | ------ | -------------- | -------- |
| archives | array | 包含的视频列表 | | | archives | array | 包含的视频列表 | |
| cid | num | 频道ID | | | cid | num | 频道id | |
| count | num | 频道内含视频数 | | | count | num | 频道内含视频数 | |
| cover | str | 封面图片url | | | cover | str | 封面图片url | |
| intro | str | 简介 | 无则为空 | | intro | str | 简介 | 无则为空 |
| mid | num | 创建用户UID | | | mid | num | 创建用户mid | |
| mtime | num | 创建时间 | 时间戳 | | mtime | num | 创建时间 | 时间戳 |
| name | str | 标题 | | | name | str | 标题 | |
@@ -2197,7 +2197,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \
`list`中的`archives`数组中的对象： `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`对象： `data`中的`page`对象：
@@ -2209,7 +2209,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \
**示例：** **示例：**
查询用户`UID=53456`的频道`170`中的视频 查询用户`mid=53456`的频道`170`中的视频
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/channel/video' \ 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） 认证方式：Cookie（SESSDATA）
创建成功后会返回新建频道的ID 创建成功后会返回新建频道的id
**正文参数（ application/x-www-form-urlencoded ）：** **正文参数（ 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 | 频道名 | 必要 | | | name | str | 频道名 | 必要 | |
| intro | str | 频道简介 | 非必要 | | | intro | str | 频道简介 | 非必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | 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） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
@@ -2543,8 +2543,8 @@ curl 'http://api.bilibili.com/x/space/channel/del' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---------------------- | | ------ | ---- | ------------------------ | ------ | ---------------------- |
| cid | num | 频道ID | 必要 | | | cid | num | 频道id | 必要 | |
| aids | nums | 要添加的目标稿件avID | 必要 | 多个使用","（%2C）分隔 | | aids | nums | 要添加的目标稿件avid | 必要 | 多个使用","（%2C）分隔 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **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主） | | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />53003：本频道里的视频已满<br />53006：提交视频已失效或频道里有（非该视频UP主） |
| message | str | 错误信息 | 默认为0 | | message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | | | ttl | num | 1 | |
| data | array | 出错稿件avID列表 | | | data | array | 出错稿件avid列表 | |
`data`数组： `data`数组：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------- | ---- | | ---- | ---- | ------------------- | ---- |
| 0 | num | 出错稿件avID1 | | | 0 | num | 出错稿件avid1 | |
| n | num | 出错稿件avID（n+1） | | | n | num | 出错稿件avid（n+1） | |
| …… | num | …… | …… | | …… | num | …… | …… |
**示例：** **示例：**
@@ -2606,8 +2606,8 @@ curl 'http://api.bilibili.com/x/space/channel/video/add' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- | | ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 频道ID | 必要 | | | cid | num | 频道id | 必要 | |
| aid | num | 要删除的目标稿件avID | 必要 | | | aid | num | 要删除的目标稿件avid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
@@ -2657,8 +2657,8 @@ curl 'http://api.bilibili.com/x/space/channel/video/del' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ | | ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| cid | num | 频道ID | 必要 | | | cid | num | 频道id | 必要 | |
| aid | num | 要移动的目标稿件avID | 必要 | | | aid | num | 要移动的目标稿件avid | 必要 | |
| to | num | 视频排序倒数位置 | 非必要 | 默认为1<br />1为列表底部，视频总数为首端<br />与显示顺序恰好相反 | | to | num | 视频排序倒数位置 | 非必要 | 默认为1<br />1为列表底部，视频总数为首端<br />与显示顺序恰好相反 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | 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回复：** **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回复：** **json回复：**
@@ -2795,9 +2795,9 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | --------------- | | ----------- | ---- | ---------------- | --------------- |
| id | num | 收藏夹mlID | | | id | num | 收藏夹mlid | |
| fid | num | 原始收藏夹ID | 去除两位UID尾号 | | fid | num | 原始收藏夹mlid | 去除两位mid尾号 |
| mid | num | 创建用户UID | | | mid | num | 创建用户mid | |
| attr | num | 收藏夹属性位配置 | | | attr | num | 收藏夹属性位配置 | |
| title | str | 收藏夹标题 | | | title | str | 收藏夹标题 | |
| fav_state | num | 0 | 作用尚不明确 | | fav_state | num | 0 | 作用尚不明确 |
@@ -2813,7 +2813,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check
**示例：** **示例：**
查询用户`UID=7792521`的收藏夹列表 查询用户`mid=7792521`的收藏夹列表
```shell ```shell
curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \ 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 | 每页项数 | 必要 | | | ps | num | 每页项数 | 必要 | |
| pn | num | 页码 | 必要 | | | pn | num | 页码 | 必要 | |
| up_mid | num | 目标用户UID | 必要 | | | up_mid | num | 目标用户mid | 必要 | |
**json回复：** **json回复：**
@@ -2922,9 +2922,9 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------ | ----------------------------------------- | | ----------- | ---- | ------------------ | ----------------------------------------- |
| id | num | 收藏夹mlID | | | id | num | 收藏夹ml | |
| fid | num | 原始收藏夹ID | 去除两位UID尾号 | | fid | num | 原始收藏夹mlid | 去除两位mid尾号 |
| mid | num | 创建用户UID | | | mid | num | 创建用户mid | |
| attr | num | 收藏夹属性 | 转换成8-bit二进制处理<br />详细说明见下表 | | attr | num | 收藏夹属性 | 转换成8-bit二进制处理<br />详细说明见下表 |
| title | str | 收藏夹标题 | | | title | str | 收藏夹标题 | |
| cover | str | 收藏夹封面图片url | | | 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 | 创建人昵称 | | | name | str | 创建人昵称 | |
| face | str | 空 | 作用尚不明确 | | face | str | 空 | 作用尚不明确 |
**示例：** **示例：**
查询用户`UID=293793435`的收藏夹收藏列表 查询用户`mid=293793435`的收藏夹收藏列表
```shell ```shell
curl -G 'http://api.bilibili.com/x/v3/fav/folder/collected/list' \ 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 | | pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为20 | | ps | num | 每页项数 | 非必要 | 默认为20 |
@@ -3080,14 +3080,14 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/collected/list' \
| link | str | 课程页面url | 手机版页面url | | link | str | 课程页面url | 手机版页面url |
| page | num | 1 | 作用尚不明确 | | page | num | 1 | 作用尚不明确 |
| play | num | 课程播放数 | | | play | num | 课程播放数 | |
| season_id | num | 课程ssID | | | season_id | num | 课程ssid | |
| status | str | 更新状态说明 | | | status | str | 更新状态说明 | |
| subtitle | str | 课程副标题 | | | subtitle | str | 课程副标题 | |
| title | str | 课程标题 | | | title | str | 课程标题 | |
**示例：** **示例：**
查询用户`UID=33683045`的课程发布列表 查询用户`mid=33683045`的课程发布列表
```shell ```shell
curl -G 'http://api.bilibili.com/pugv/app/web/season/page' \ 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回复：** **json回复：**
@@ -3232,14 +3232,14 @@ curl -G 'http://api.bilibili.com/pugv/app/web/season/page' \
| is_finish | num | 是否已完结 | 0：未完结<br />1：已完结 | | is_finish | num | 是否已完结 | 0：未完结<br />1：已完结 |
| last_ep_index | num | 0 | 作用尚不明确 | | last_ep_index | num | 0 | 作用尚不明确 |
| newest_ep_index | num | 最新一话 | 可能为0 | | newest_ep_index | num | 最新一话 | 可能为0 |
| season_id | str | 番剧ssID | | | season_id | str | 番剧ssid | |
| share_url | str | 播放页面链接url | | | share_url | str | 播放页面链接url | |
| title | str | 标题 | | | title | str | 标题 | |
| total_count | num | 总计集数 | 未完结：-1<br />已完结：非0正整数 | | total_count | num | 总计集数 | 未完结：-1<br />已完结：非0正整数 |
**示例：** **示例：**
查看用户`UID=14082`的追番预览列表 查看用户`mid=14082`的追番预览列表
```shell ```shell
curl -G 'http://space.bilibili.com/ajax/Bangumi/getList' \ 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 | | pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为15 | | ps | num | 每页项数 | 非必要 | 默认为15 |
| type | num | 查询类型 | 必要 | 1：追番<br />2：追剧 | | type | num | 查询类型 | 必要 | 1：追番<br />2：追剧 |
@@ -3342,7 +3342,7 @@ curl -G 'http://space.bilibili.com/ajax/Bangumi/getList' \
**示例：** **示例：**
查看用户`UID=14082`的追番明细 查看用户`mid=14082`的追番明细
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/bangumi/follow/list' \ 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回复：** **json回复：**
@@ -3606,12 +3606,12 @@ curl -G 'http://api.bilibili.com/x/space/bangumi/follow/list' \
| cover | str | TAG图片url | 无则为空 | | cover | str | TAG图片url | 无则为空 |
| name | str | TAG名 | | | name | str | TAG名 | |
| notify | num | 1 | 作用尚不明确 | | notify | num | 1 | 作用尚不明确 |
| tag_id | num | TAGID | | | tag_id | num | tag_id | |
| updated_ts | str | 1970-01-01 08:00:00 | 作用尚不明确 | | updated_ts | str | 1970-01-01 08:00:00 | 作用尚不明确 |
**示例：** **示例：**
查询用户`UID=2`的关注TAG 查询用户`mid=2`的关注TAG
```shell ```shell
curl -G 'http://space.bilibili.com/ajax/tags/getSubList' \ curl -G 'http://space.bilibili.com/ajax/tags/getSubList' \
user/status_number.md
+9 -9
View File
@@ -19,7 +19,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- | | ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| vmid | num | 目标用户UID | 必要 | | | vmid | num | 目标用户mid | 必要 | |
**json回复：** **json回复：**
@@ -36,7 +36,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ----------- | ------------------------------------------------ | | --------- | ---- | ----------- | ------------------------------------------------ |
| mid | num | 目标用户UID | | | mid | num | 目标用户mid | |
| following | num | 关注数 | | | following | num | 关注数 | |
| whisper | num | 悄悄关注数 | 需要登录(Cooklie或APP) <br />未登录或非自己恒为0 | | whisper | num | 悄悄关注数 | 需要登录(Cooklie或APP) <br />未登录或非自己恒为0 |
| black | num | 黑名单数 | 需要登录(Cooklie或APP) <br />未登录或非自己恒为0 | | black | num | 黑名单数 | 需要登录(Cooklie或APP) <br />未登录或非自己恒为0 |
@@ -44,7 +44,7 @@
**示例：** **示例：**
查询用户`UID=332704117`的关系状态数 查询用户`mid=332704117`的关系状态数
```shell ```shell
curl -G 'http://api.bilibili.com/x/relation/stat' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| mid | num | 目标用户UID | 必要 | | | mid | num | 目标用户mid | 必要 | |
**json回复：** **json回复：**
@@ -122,7 +122,7 @@ curl -G 'http://api.bilibili.com/x/relation/stat' \
**示例：** **示例：**
查询用户`UID=456664753`的UP主状态数 查询用户`mid=456664753`的UP主状态数
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/upstat' \ 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回复：** **json回复：**
@@ -209,7 +209,7 @@ curl -G 'http://api.bilibili.com/x/space/upstat' \
**示例：** **示例：**
查询用户`UID=239202390`的订阅&投稿状态数 查询用户`mid=239202390`的订阅&投稿状态数
```shell ```shell
curl -G 'http://api.bilibili.com/x/space/navnum' \ 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回复：** **json回复：**
@@ -284,7 +284,7 @@ curl -G 'http://api.bilibili.com/x/space/navnum' \
**示例：** **示例：**
查询用户`UID=53456`的投稿相簿数 查询用户`mid=53456`的投稿相簿数
```shell ```shell
curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/upload_count' \ curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/upload_count' \
video/attribute_data.md
+71
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 | 用户删除 | |
video/info.md
+121 -140
View File
@@ -2,28 +2,28 @@
<img src="/imgs/ploading.gif" width="100" height="100"/> <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 > http://api.bilibili.com/x/web-interface/view
*请求方式：GET* *请求方式：GET*
认证方式：Cookie（SESSDATA） 认证方式：Cookie(SESSDATA)
限制游客访问的视频需要登录 限制游客访问的视频需要登录
**url参数：** **url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ | | ------ | ---- | -------- | ---------- | ------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要(可选) | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要(可选) | avid与bvid任选一个 |
**json回复：** **json回复：**
@@ -38,102 +38,51 @@
`data`对象： `data`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------------------------- | ------- | ------------------------------ | ------------------------------------------------------------ | | ----------------------- | ------- | ------------------------------ | ------------------------------------------------------------ |
| bvid | str | 稿件bvID | | | bvid | str | 稿件bvid | |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
| videos | num | 稿件分P总数 | 默认为1 | | videos | num | 稿件分P总数 | 默认为1 |
| tid | num | 分区tID | | | tid | num | 分区tid | |
| tname | str | 子分区名称 | | | tname | str | 子分区名称 | |
| copyright | num | 视频类型 | 1：原创<br />2：转载 | | copyright | num | 视频类型 | 1：原创<br />2：转载 |
| pic | str | 稿件封面图片url | | | pic | str | 稿件封面图片url | |
| title | str | 稿件标题 | | | title | str | 稿件标题 | |
| pubdate | num | 稿件发布时间 | 时间戳 | | pubdate | num | 稿件发布时间 | 时间戳 |
| ctime | num | 用户投稿时间 | 时间戳 | | ctime | num | 用户投稿时间 | 时间戳 |
| desc | str | 视频简介 | | | desc | str | 视频简介 | |
| state | num | 视频状态 | **详情见下表** | | desc_v2 | array | 新版视频简介 | |
| ~~attribute~~（已经弃用） | ~~num~~ | ~~稿件属性位配置~~ | **详情见下表**| | state | num | 视频状态 | 详情见[属性数据文档](attribute_data.md#attribute字段值(稿件属性位)) |
| duration | num | 稿件总时长（所有分P） | 单位为秒 | | ~~attribute~~(已经弃用) | ~~num~~ | ~~稿件属性位配置~~ | 详情见[属性数据文档](attribute_data.md#state字段值(稿件状态)) |
| forward | num | 撞车视频跳转avid | 仅撞车视频存在此字段 | | duration | num | 稿件总时长(所有分P) | 单位为秒 |
| mission_id | num | 稿件参与的活动ID | | | forward | num | 撞车视频跳转avid | 仅撞车视频存在此字段 |
| redirect_url | str | 重定向url | 仅番剧或影视视频存在此字段<br />用于番剧&影视的av/bv->ep | | mission_id | num | 稿件参与的活动id | |
| rights | obj | 视频属性标志 | | | redirect_url | str | 重定向url | 仅番剧或影视视频存在此字段<br />用于番剧&影视的av/bv->ep |
| owner | obj | 视频UP主信息 | | | rights | obj | 视频属性标志 | |
| stat | obj | 视频状态数 | | | owner | obj | 视频UP主信息 | |
| dynamic | str | 视频同步发布的的动态的文字内容 | | | stat | obj | 视频状态数 | |
| cid | num | 视频1P CID | | | dynamic | str | 视频同步发布的的动态的文字内容 | |
| dimension | obj | 视频1P分辨率 | | | cid | num | 视频1P cid | |
| no_cache | bool | true | 作用尚不明确 | | dimension | obj | 视频1P分辨率 | |
| pages | array | 视频分P列表 | | | no_cache | bool | true | 作用尚不明确 |
| subtitle | obj | 视频CC字幕信息 | | | pages | array | 视频分P列表 | |
| staff | array | 合作成员列表 | 非合作视频无此项 | | subtitle | obj | 视频CC字幕信息 | |
| user_garb | obj | 用户装扮信息 | | | staff | array | 合作成员列表 | 非合作视频无此项 |
| user_garb | obj | 用户装扮信息 | |
`attribute`字段属性位二进制值表： `data`中的`desc_v2`数组：
（PS：以下部分内容来源不明，有待验证，下表只做历史保留，无实际作用） | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ---- |
| 0 | obj | 新版简介内容 | |
| 位 | 内容 | 备注 | `desc_v2`数组中的对象：
| ---- | ---------------------- | --------------------------------------------- |
| 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`字段值： | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ---- |
（PS：以下部分内容来源不明，且部分值前端不可见，有待验证） | raw_text | num | 简介内容 | |
| type | num | ? | |
| 值 | 内容 | 备注 | | biz_id | num | ? | |
| ---- | ------------ | ---------- |
| 1 | 橙色通过 | |
| 0 | 开放浏览 | |
| -1 | 待审 | |
| -2 | 被打回 | |
| -3 | 网警锁定 | |
| -4 | 被锁定 | 视频撞车了 |
| -5 | 管理员锁定 | |
| -6 | 修复待审 | |
| -7 | 暂缓审核 | |
| -8 | 补档待审 | |
| -9 | 等待转码 | |
| -10 | 延迟审核 | |
| -11 | 视频源待修 | |
| -12 | 转储失败 | |
| -13 | 允许评论待审 | |
| -14 | 临时回收站 | |
| -15 | 分发中 | |
| -16 | 转码失败 | |
| -20 | 创建未提交 | |
| -30 | 创建已提交 | |
| -40 | 定时发布 | |
| -100 | 用户删除 | |
`data`中的`rights`对象： `data`中的`rights`对象：
@@ -157,7 +106,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- | | ---- | ---- | -------- | ---- |
| mid | num | UP主UID | | | mid | num | UP主mid | |
| name | str | UP主昵称 | | | name | str | UP主昵称 | |
| face | str | UP主头像 | | | face | str | UP主头像 | |
@@ -165,7 +114,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------ | ------- | | ---------- | ---- | ------------ | ------- |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
| view | num | 播放数 | | | view | num | 播放数 | |
| danmaku | num | 弹幕数 | | | danmaku | num | 弹幕数 | |
| reply | num | 评论数 | | | reply | num | 评论数 | |
@@ -191,7 +140,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | --------------- | --------------------------------------------------------- | | --------- | ---- | --------------- | --------------------------------------------------------- |
| cid | num | 当前分P CID | | | cid | num | 当前分P cid | |
| page | num | 当前分P | | | page | num | 当前分P | |
| from | str | 视频来源 | vupload：普通上传（B站）<br />hunan：芒果TV<br />qq：腾讯 | | from | str | 视频来源 | vupload：普通上传（B站）<br />hunan：芒果TV<br />qq：腾讯 |
| part | str | 当前分P标题 | | | part | str | 当前分P标题 | |
@@ -227,11 +176,11 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------- | ---- | | ------------ | ---- | ------------------- | ---- |
| id | num | 字幕ID | | | id | num | 字幕id | |
| lan | str | 字幕语言 | | | lan | str | 字幕语言 | |
| lan_doc | str | 字幕语言名称 | | | lan_doc | str | 字幕语言名称 | |
| is_lock | bool | 是否锁定 | | | is_lock | bool | 是否锁定 | |
| author_mid | num | 字幕上传者UID | | | author_mid | num | 字幕上传者mid | |
| subtitle_url | str | json格式字幕文件url | | | subtitle_url | str | json格式字幕文件url | |
| author | obj | 字幕上传者信息 | | | author | obj | 字幕上传者信息 | |
@@ -239,7 +188,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------------- | ------------ | | --------------- | ---- | ----------------- | ------------ |
| mid | num | 字幕上传者UID | | | mid | num | 字幕上传者mid | |
| name | str | 字幕上传者昵称 | | | name | str | 字幕上传者昵称 | |
| sex | str | 字幕上传者性别 | 男 女 保密 | | sex | str | 字幕上传者性别 | 男 女 保密 |
| face | str | 字幕上传者头像url | | | face | str | 字幕上传者头像url | |
@@ -261,7 +210,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------------- | ---- | | -------- | ---- | -------------- | ---- |
| mid | num | 成员UID | | | mid | num | 成员mid | |
| title | str | 成员名称 | | | title | str | 成员名称 | |
| name | str | 成员昵称 | | | name | str | 成员昵称 | |
| face | str | 成员头像url | | | face | str | 成员头像url | |
@@ -288,8 +237,6 @@
`data`中的`user_garb`对象： `data`中的`user_garb`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | ------- | ---- | | ----------------- | ---- | ------- | ---- |
| url_image_ani_cut | str | 某url？ | | | url_image_ani_cut | str | 某url？ | |
@@ -298,14 +245,14 @@
获取视频`av85440373`/`BV117411r7R1`的基本信息 获取视频`av85440373`/`BV117411r7R1`的基本信息
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/web-interface/view' \ curl -G 'http://api.bilibili.com/x/web-interface/view' \
--data-urlencode 'aid=85440373' --data-urlencode 'aid=85440373'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/web-interface/view' \ 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, "pubdate": 1580377255,
"ctime": 1580212263, "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": "【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, "state": 0,
"duration": 486, "duration": 486,
"mission_id": 11838, "mission_id": 11838,
@@ -358,15 +312,15 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
}, },
"stat": { "stat": {
"aid": 85440373, "aid": 85440373,
"view": 1936852, "view": 2087084,
"danmaku": 11189, "danmaku": 11495,
"reply": 2626, "reply": 2669,
"favorite": 56572, "favorite": 58113,
"coin": 66857, "coin": 68710,
"share": 9032, "share": 9190,
"now_rank": 0, "now_rank": 0,
"his_rank": 55, "his_rank": 55,
"like": 142449, "like": 148621,
"dislike": 0, "dislike": 0,
"evaluation": "", "evaluation": "",
"argue_msg": "" "argue_msg": ""
@@ -408,8 +362,22 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
"vip": { "vip": {
"type": 2, "type": 2,
"status": 1, "status": 1,
"vip_pay_type": 0, "due_date": 1642694400000,
"theme_type": 0 "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": { "official": {
"role": 2, "role": 2,
@@ -417,7 +385,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
"desc": "", "desc": "",
"type": 0 "type": 0
}, },
"follower": 628808, "follower": 662460,
"label_style": 0 "label_style": 0
}, },
{ {
@@ -428,8 +396,22 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
"vip": { "vip": {
"type": 2, "type": 2,
"status": 1, "status": 1,
"due_date": 1637424000000,
"vip_pay_type": 0, "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": { "official": {
"role": 1, "role": 1,
@@ -437,7 +419,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
"desc": "", "desc": "",
"type": 0 "type": 0
}, },
"follower": 2268492, "follower": 2655737,
"label_style": 0 "label_style": 0
} }
], ],
@@ -452,7 +434,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
视频标题为：`当我给拜年祭的快板加了电音配乐…` 视频标题为：`当我给拜年祭的快板加了电音配乐…`
视频分区为：`tid=28（音乐->原创音乐）` 视频分区为：`tid=28(音乐->原创音乐)`
视频时长：`486s` 视频时长：`486s`
@@ -462,15 +444,15 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
视频分P为：`1` 视频分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`、`联合投稿视频` 视频属性为： `显示“禁止转载“标志`、`高清`、`禁止其他人添加TAG`、`联合投稿视频`
@@ -492,8 +474,8 @@ http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ | | ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
**json回复：** **json回复：**
@@ -508,16 +490,16 @@ http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg
**示例：** **示例：**
查看视频（教主的咕鸽）`av39330059`/`BV1Bt411z799`的简介 查看视频(教主的咕鸽)`av39330059`/`BV1Bt411z799`的简介
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/archive/desc' \ curl -G 'http://api.bilibili.com/x/archive/desc' \
--data-urlencode 'aid=39330059' --data-urlencode 'aid=39330059'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/archive/desc' \ curl -G 'http://api.bilibili.com/x/archive/desc' \
@@ -538,7 +520,7 @@ curl -G 'http://api.bilibili.com/x/archive/desc' \
</details> </details>
## 查询视频分P列表 (avID/bvID转CID) ## 查询视频分P列表 (avid/bvid转cid)
> http://api.bilibili.com/x/player/pagelist > 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任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
**json回复：** **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 | | | page | num | 当前分P | |
| from | str | 视频来源 | vupload：普通上传（B站）<br />hunan：芒果TV<br />qq：腾讯 | | from | str | 视频来源 | vupload：普通上传（B站）<br />hunan：芒果TV<br />qq：腾讯 |
| part | str | 当前分P标题 | | | part | str | 当前分P标题 | |
@@ -595,14 +577,14 @@ curl -G 'http://api.bilibili.com/x/archive/desc' \
查询视频`av13502509`/`BV1ex411J7GE`的分P列表 查询视频`av13502509`/`BV1ex411J7GE`的分P列表
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/player/pagelist' \ curl -G 'http://api.bilibili.com/x/player/pagelist' \
--data-urlencode 'aid=13502509' --data-urlencode 'aid=13502509'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/player/pagelist' \ curl -G 'http://api.bilibili.com/x/player/pagelist' \
@@ -677,4 +659,3 @@ curl -G 'http://api.bilibili.com/x/player/pagelist' \
</details> </details>
video/interact_video.md
+12 -12
View File
@@ -20,9 +20,9 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | -------- | ------------ | ------------------ | | ------------- | ---- | -------- | ------------ | ------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| graph_version | num | 剧情图ID | 必要 | 位于`player.so`中 | | graph_version | num | 剧情图id | 必要 | 位于`player.so`中 |
| edge_id | num | 模块编号 | 非必要 | 0或留空为起始模块 | | edge_id | num | 模块编号 | 非必要 | 0或留空为起始模块 |
**json回复：** **json回复：**
@@ -41,7 +41,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ----- | ------------------- | ------------------------------------------------ | | --------------- | ----- | ------------------- | ------------------------------------------------ |
| title | str | 视频模块（分P）标题 | | | title | str | 视频模块（分P）标题 | |
| edge_id | num | 当前模块ID | | | edge_id | num | 当前模块id | |
| story_list | array | 进度回溯信息 | 未登录仅有起始模块 | | story_list | array | 进度回溯信息 | 未登录仅有起始模块 |
| edges | obj | 当前模块信息 | | | edges | obj | 当前模块信息 | |
| preload | obj | 预加载的分P | | | preload | obj | 预加载的分P | |
@@ -66,7 +66,7 @@
| node_id | num | 模块编号 | | | node_id | num | 模块编号 | |
| edge_id | num | **同上** | | | edge_id | num | **同上** | |
| title | str | 模块（分P）标题 | | | title | str | 模块（分P）标题 | |
| cid | num | 模块（分P）CID | | | cid | num | 模块（分P）cid | |
| start_pos | num | 记录播放开始位置 | 单位为毫秒 | | start_pos | num | 记录播放开始位置 | 单位为毫秒 |
| cover | str | 分P封面url | | | cover | str | 分P封面url | |
| is_current | num | 是否为当前模块 | 1：是<br />仅为当前模块时存在 | | is_current | num | 是否为当前模块 | 1：是<br />仅为当前模块时存在 |
@@ -121,11 +121,11 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | -------------------- | ------------------------------------- | | --------------- | ---- | -------------------- | ------------------------------------- |
| id | num | 选项所跳转的模块ID | | | id | num | 选项所跳转的模块id | |
| platform_action | str | 跳转信息文字 | JUMP+{所跳转的模块编号}+{所跳转的CID} | | platform_action | str | 跳转信息文字 | JUMP+{所跳转的模块编号}+{所跳转的cid} |
| native_action | str | 点击后对变量运算语句 | 每项间用分号隔开<br />无为空 | | native_action | str | 点击后对变量运算语句 | 每项间用分号隔开<br />无为空 |
| condition | str | 选项出现条件判断语句 | 无为空 | | condition | str | 选项出现条件判断语句 | 无为空 |
| cid | num | 选项所跳转分P的CID | | | cid | num | 选项所跳转分P的cid | |
| x | num | 选项出现的x坐标 | 仅坐标模式有此项 | | x | num | 选项出现的x坐标 | 仅坐标模式有此项 |
| y | num | 选项出现的y坐标 | 仅坐标模式有此项 | | y | num | 选项出现的y坐标 | 仅坐标模式有此项 |
| text_align | num | 选项文本对齐方式 | | | text_align | num | 选项文本对齐方式 | |
@@ -166,8 +166,8 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- | | ---- | ---- | -------- | ---- |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
| cid | num | 分P CID | | | cid | num | 分P cid | |
`data`中的`hidden_vars`数组： `data`中的`hidden_vars`数组：
@@ -193,7 +193,7 @@
查询互动视频`av73267982`下剧情图`155446`模块`5556092`的信息 查询互动视频`av73267982`下剧情图`155446`模块`5556092`的信息
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/stein/edgeinfo_v2' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/stein/edgeinfo_v2' \ curl -G 'http://api.bilibili.com/x/stein/edgeinfo_v2' \
video/like_coin_fav.md
+31 -31
View File
@@ -35,8 +35,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ---------------------- | | ------ | ---- | ------------------------ | ------------ | ---------------------- |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| like | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 | | like | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
@@ -54,7 +54,7 @@
点赞视频`av79677524`/`BV1uJ411r7hL` 点赞视频`av79677524`/`BV1uJ411r7hL`
avID方式： avid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/web-interface/archive/like' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/web-interface/archive/like' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avID | 必要 | | | aid | num | 稿件avid | 必要 | |
| like | num | 操作方式 | 必要 | 0：点赞<br />1：取消赞 | | like | num | 操作方式 | 必要 | 0：点赞<br />1：取消赞 |
**json回复：** **json回复：**
@@ -160,8 +160,8 @@ curl 'http://app.bilibili.com/x/v2/view/like' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ------------ | ------------------ | | ---------- | ---- | ------------ | ------------ | ------------------ |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
**json回复：** **json回复：**
@@ -178,7 +178,7 @@ curl 'http://app.bilibili.com/x/v2/view/like' \
视频`av39330059`/`BV1Bt411z799`的状态为已点赞 视频`av39330059`/`BV1Bt411z799`的状态为已点赞
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/web-interface/archive/has/like' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'api.bilibili.com/x/web-interface/archive/has/like' \ 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任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| multiply | num | 投币数量 | 必要 | 上限为2 | | multiply | num | 投币数量 | 必要 | 上限为2 |
| select_like | num | 是否附加点赞 | 非必要 | 0：不点赞<br />1：同时点赞<br />默认为0 | | select_like | num | 是否附加点赞 | 非必要 | 0：不点赞<br />1：同时点赞<br />默认为0 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
@@ -252,7 +252,7 @@ data 对象：
为视频`av90671873`/`BV1N7411A7wC`投币2枚 为视频`av90671873`/`BV1N7411A7wC`投币2枚
avID方式： avid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/web-interface/coin/add' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/web-interface/coin/add' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avID | 必要 | | | aid | num | 稿件avid | 必要 | |
| multiply | num | 投币数量 | 必要 | 上限为2 | | multiply | num | 投币数量 | 必要 | 上限为2 |
| select_like | num | 附加点赞 | 非必要 | 0：不点赞<br />1：同时点赞<br />默认为0 | | 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
**json回复：** **json回复：**
@@ -387,7 +387,7 @@ curl 'http://app.bilibili.com/x/v2/view/coin/add' \
视频`av37896701`/`BV18t411q7zz`的投币数为2枚 视频`av37896701`/`BV18t411q7zz`的投币数为2枚
avID方式： avid方式：
```shell ```shell
curl -G 'api.bilibili.com/x/web-interface/archive/coins' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'api.bilibili.com/x/web-interface/archive/coins' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| rid | num | 稿件avID | 必要 | | | rid | num | 稿件avid | 必要 | |
| type | num | 必须为2 | 必要 | | | type | num | 必须为2 | 必要 | |
| add_media_ids | nums | 需要加入的收藏夹ID | 非必要 | 同时添加多个，用`,`（%2C）分隔 | | add_media_ids | nums | 需要加入的收藏夹mlid | 非必要 | 同时添加多个，用`,`（%2C）分隔 |
| del_media_ids | nums | 需要取消的收藏夹ID | 非必要 | 同时取消多个，用`,`（%2C）分隔 | | del_media_ids | nums | 需要取消的收藏夹mlid | 非必要 | 同时取消多个，用`,`（%2C）分隔 |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
**json回复：** **json回复：**
@@ -518,7 +518,7 @@ curl 'http://api.bilibili.com/medialist/gateway/coll/resource/deal' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | -------- | ------------------ | ----------- | ---- | | ---------- | -------- | ------------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| aid | num或str | 稿件avID或稿件bvID | 必要 | | | aid | num或str | 稿件avid或稿件bvid | 必要 | |
**json回复：** **json回复：**
@@ -542,7 +542,7 @@ data 对象：
视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏 视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \ 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任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
@@ -621,7 +621,7 @@ curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \
将视频`av91003840`/`BV1Wj411f79U`一键三连 将视频`av91003840`/`BV1Wj411f79U`一键三连
avID方式： avid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/web-interface/archive/like/triple' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl 'http://api.bilibili.com/x/web-interface/archive/like/triple' \ 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方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avID | 必要 | | | aid | num | 稿件avid | 必要 | |
**json回复：** **json回复：**
@@ -738,8 +738,8 @@ curl 'http://app.bilibili.com/x/v2/view/like/triple' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------------ | ------------------ | | ------ | ---- | ------------------------ | ------------ | ------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
video/pbp.md
+4 -4
View File
@@ -20,9 +20,9 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- | | ------ | ---- | -------- | ------ | ---- |
| cid | num | 视频CID | 必要 | | | cid | num | 视频cid | 必要 | |
| aid | num | 稿件avID | 非必要 | | | aid | num | 稿件avid | 非必要 | |
| bvid | num | 稿件bvID | 非必要 | | | bvid | num | 稿件bvid | 非必要 | |
**json回复：** **json回复：**
@@ -51,7 +51,7 @@
**示例：** **示例：**
获取视频`CID=3724723`的获取弹幕趋势顶点列表 获取视频`cid=3724723`的获取弹幕趋势顶点列表
```shell ```shell
curl -G 'http://api.bilibili.com/pbp/data' \ curl -G 'http://api.bilibili.com/pbp/data' \
video/recommend.md
+4 -4
View File
@@ -16,8 +16,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ | | ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
**json回复：** **json回复：**
@@ -47,14 +47,14 @@
查询视频`av7`/`BV1xx411c7m9`的推荐视频列表 查询视频`av7`/`BV1xx411c7m9`的推荐视频列表
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/web-interface/archive/related' \ curl -G 'http://api.bilibili.com/x/web-interface/archive/related' \
--data-urlencode 'aid=7' --data-urlencode 'aid=7'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/web-interface/archive/related' \ curl -G 'http://api.bilibili.com/x/web-interface/archive/related' \
video/report.md
+9 -9
View File
@@ -18,8 +18,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | --------------------- | | ---------- | ---- | ------------------------ | -------------- | --------------------- |
| access_key | str | APP登录Token | APP方式必要 | | | access_key | str | APP登录Token | APP方式必要 | |
| aid | num | 稿件avID | 必要 | | | aid | num | 稿件avid | 必要 | |
| cid | num | 视频CID | 必要 | 用于识别分P | | cid | num | 视频cid | 必要 | 用于识别分P |
| progress | num | 观看进度 | 非必要 | 单位为秒<br />默认为0 | | progress | num | 观看进度 | 非必要 | 单位为秒<br />默认为0 |
| platform | str | 平台标识 | 非必要 | 可为android | | platform | str | 平台标识 | 非必要 | 可为android |
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
@@ -36,7 +36,7 @@
**示例：** **示例：**
记录视频`av13662970`（`CID=126654047`）的观看记录位于`1248`秒 记录视频`av13662970`（`cid=126654047`）的观看记录位于`1248`秒
Cookie方式： Cookie方式：
@@ -91,12 +91,12 @@ curl 'http://api.bilibili.com/x/v2/history/report' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------------ | ------------ | ------------------------------------------------------------ | | ----------- | ---- | ------------------------ | ------------ | ------------------------------------------------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| cid | num | 视频CID | 非必要 | 用于识别分P | | cid | num | 视频cid | 非必要 | 用于识别分P |
| epid | num | 番剧epID | 非必要 | | | epid | num | 番剧epid | 非必要 | |
| sid | num | 番剧ssID | 非必要 | | | sid | num | 番剧ssid | 非必要 | |
| mid | num | 当前用户UID | 非必要 | | | mid | num | 当前用户mid | 非必要 | |
| played_time | num | 视频播放进度 | 非必要 | 单位为秒<br />默认为0 | | played_time | num | 视频播放进度 | 非必要 | 单位为秒<br />默认为0 |
| realtime | num | 总计播放时间 | 非必要 | 单位为秒 | | realtime | num | 总计播放时间 | 非必要 | 单位为秒 |
| start_ts | num | 开始播放时刻 | 非必要 | 时间戳 | | start_ts | num | 开始播放时刻 | 非必要 | 时间戳 |
video/snapshot.md
+9 -9
View File
@@ -25,9 +25,9 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------ | ------------ | ----------------------------------- | | ------ | ---- | ------------------ | ------------ | ----------------------------------- |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| cid | num | 分P CID | 非必要 | 默认为1P | | cid | num | 分P cid | 非必要 | 默认为1P |
| index | num | json数组截取时间表 | 非必要 | 1：需要<br />0：不需要<br />默认为0 | | index | num | json数组截取时间表 | 非必要 | 1：需要<br />0：不需要<br />默认为0 |
**json回复：** **json回复：**
@@ -74,7 +74,7 @@
获取视频`av26273789`/`BV1os411H7wm`的快照 获取视频`av26273789`/`BV1os411H7wm`的快照
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/player/videoshot' \ 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' --data-urlencode 'index=1'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/player/videoshot' \ 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方式必要 | | | appkey | str | APP密钥 | APP方式必要 | |
| aid | num | 稿件avID | 必要 | | | aid | num | 稿件avid | 必要 | |
| cid | num | 分P CID | 必要 | | | cid | num | 分P cid | 必要 | |
| ts | num | 当前时间戳 | APP方式必要 | | | ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | 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 ```shell
curl -G 'http://app.bilibili.com/x/v2/view/video/shot' \ 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回复：** **json回复：**
video/status_number.md
+13 -13
View File
@@ -1,11 +1,11 @@
# 视频状态数 # 视频状态数
- [视频状态数（仅avID）](#视频状态数（仅avID）) - [视频状态数（仅avid）](#视频状态数（仅avid）)
- [视频状态数（bvID/avID）](#视频状态数（bvID/avID）) - [视频状态数（bvid/avid）](#视频状态数（bvid/avid）)
--- ---
## 视频状态数（仅avID） ## 视频状态数（仅avid）
> http://api.bilibili.com/archive_stat/stat > http://api.bilibili.com/archive_stat/stat
*请求方式：GET* *请求方式：GET*
@@ -14,7 +14,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- | | ------ | ---- | -------- | ------ | ---- |
| aid | num | 稿件avID | 必要 | | | aid | num | 稿件avid | 必要 | |
**json回复：** **json回复：**
@@ -31,7 +31,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ------------------------ | ------------------------------ | -------------------- | | ---------- | ------------------------ | ------------------------------ | -------------------- |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
| view | 正常：num<br />屏蔽：str | 正常：播放次数<br />屏蔽："--" | | | view | 正常：num<br />屏蔽：str | 正常：播放次数<br />屏蔽："--" | |
| danmaku | num | 弹幕条数 | | | danmaku | num | 弹幕条数 | |
| reply | num | 评论条数 | | | reply | num | 评论条数 | |
@@ -49,7 +49,7 @@
查询视频`av91572143`的状态数 查询视频`av91572143`的状态数
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/archive_stat/stat' \ curl -G 'http://api.bilibili.com/archive_stat/stat' \
@@ -84,7 +84,7 @@ curl -G 'http://api.bilibili.com/archive_stat/stat' \
</details> </details>
## 视频状态数（bvID/avID） ## 视频状态数（bvid/avid）
> http://api.bilibili.com/x/web-interface/archive/stat > 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任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
**json回复：** **json回复：**
@@ -114,8 +114,8 @@ curl -G 'http://api.bilibili.com/archive_stat/stat' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ------------------------ | ------------------------------ | -------------------- | | ---------- | ------------------------ | ------------------------------ | -------------------- |
| aid | num | 稿件avID | | | aid | num | 稿件avid | |
| bvid | str | 稿件bvID | | | bvid | str | 稿件bvid | |
| view | 正常：num<br />屏蔽：str | 正常：播放次数<br />屏蔽："--" | | | view | 正常：num<br />屏蔽：str | 正常：播放次数<br />屏蔽："--" | |
| danmaku | num | 弹幕条数 | | | danmaku | num | 弹幕条数 | |
| reply | num | 评论条数 | | | reply | num | 评论条数 | |
@@ -135,14 +135,14 @@ curl -G 'http://api.bilibili.com/archive_stat/stat' \
查询视频`av2271112`/`BV1es411D7sW`的状态数 查询视频`av2271112`/`BV1es411D7sW`的状态数
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/web-interface/archive/stat' \ curl -G 'http://api.bilibili.com/x/web-interface/archive/stat' \
--data-urlencode 'aid=2271112' --data-urlencode 'aid=2271112'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/web-interface/archive/stat' \ curl -G 'http://api.bilibili.com/x/web-interface/archive/stat' \
video/tags.md
+9 -9
View File
@@ -18,8 +18,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | ------------------ | | ------ | ---- | -------- | ------------ | ------------------ |
| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
**json回复：** **json回复：**
@@ -44,7 +44,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | -------------- | ------------------------------------------------------------ | | ------------- | ---- | -------------- | ------------------------------------------------------------ |
| tag_id | num | TAGID | | | tag_id | num | tag_id | |
| tag_name | str | TAG名称 | | | tag_name | str | TAG名称 | |
| cover | str | TAG图片url | | | cover | str | TAG图片url | |
| head_cover | str | TAG页面头图url | | | head_cover | str | TAG页面头图url | |
@@ -73,7 +73,7 @@
查询视频`av89772773`/`BV1M741177Kg`的TAG 查询视频`av89772773`/`BV1M741177Kg`的TAG
avID方式： avid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/tag/archive/tags' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/tag/archive/tags' \ 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 | 必要 | | | aid | num | 稿件avid | 必要 | |
| tag_id | num | TAGID | 必要 | | | tag_id | num | tag_id | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
@@ -275,8 +275,8 @@ curl 'http://api.bilibili.com/x/tag/archive/like2' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- | | ------ | ---- | ------------------------ | ------ | ---- |
| aid | num | 稿件avID | 必要 | | | aid | num | 稿件avid | 必要 | |
| tag_id | num | TAGID | 必要 | | | tag_id | num | tag_id | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：** **json回复：**
video/video_zone.md
+22 -22
View File
@@ -1,6 +1,6 @@
# 视频分区一览 # 视频分区一览
用于通过稿件avID判断所在的分区，或推荐分区视频等....... 用于通过稿件avid判断所在的分区，或推荐分区视频等.......
亦可用于更深♂入了解B站的分区 亦可用于更深♂入了解B站的分区
@@ -8,7 +8,7 @@
<img src="/imgs/zone/douga.svg" width="100" height="100"/> <img src="/imgs/zone/douga.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | --------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | -------------- | --------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 动画（主分区） | douga | 1 | | [/v/douga](https://www.bilibili.com/v/douga) | | 动画（主分区） | douga | 1 | | [/v/douga](https://www.bilibili.com/v/douga) |
| MAD·AMV | mad | 24 | 具有一定制作程度的动画或静画的二次创作视频 | [/v/douga/mad](https://www.bilibili.com/v/douga/mad) | | 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"/> <img src="/imgs/zone/anime.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ----------- | ---- | -------------------------------------------------- | ------------------------------------------------------------ | | -------------- | ----------- | ---- | -------------------------------------------------- | ------------------------------------------------------------ |
| 番剧（主分区） | anime | 13 | | [/anime](https://www.bilibili.com/anime) | | 番剧（主分区） | anime | 13 | | [/anime](https://www.bilibili.com/anime) |
| 连载动画 | serial | 33 | 当季连载的动画番剧 | [/v/anime/serial](https://www.bilibili.com/v/anime/serial) | | 连载动画 | 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"/> <img src="/imgs/zone/guochuang.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ----------- | ---- | ----------------- | ------------------------------------------------------------ | | -------------- | ----------- | ---- | ----------------- | ------------------------------------------------------------ |
| 国创（主分区） | guochuang | 167 | | [/guochuang](https://www.bilibili.com/guochuang) | | 国创（主分区） | guochuang | 167 | | [/guochuang](https://www.bilibili.com/guochuang) |
| 国产动画 | chinese | 153 | 我国出品的PGC动画 | [/v/guochuang/chinese](https://www.bilibili.com/v/guochuang/chinese) | | 国产动画 | 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"/> <img src="/imgs/zone/music.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ---------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | -------------- | ---------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 音乐（主分区） | music | 3 | | [/v/music](https://www.bilibili.com/v/music) | | 音乐（主分区） | music | 3 | | [/v/music](https://www.bilibili.com/v/music) |
| 原创音乐 | original | 28 | 个人或团队制作以音乐为主要原创因素的歌曲或纯音乐 | [/v/music/original](https://www.bilibili.com/v/music/original) | | 原创音乐 | 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"/> <img src="/imgs/zone/dance.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | -------------- | ------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 舞蹈（主分区） | dance | 129 | | [/v/dance](https://www.bilibili.com/v/dance) | | 舞蹈（主分区） | dance | 129 | | [/v/dance](https://www.bilibili.com/v/dance) |
| 宅舞 | otaku | 20 | 与ACG相关的翻跳、原创舞蹈 | [/v/dance/otaku](https://www.bilibili.com/v/dance/otaku) | | 宅舞 | 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"/> <img src="/imgs/zone/game.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ----------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | -------------- | ----------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 游戏（主分区） | game | 4 | | [/v/game](https://www.bilibili.com/v/game) | | 游戏（主分区） | 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) | | 单机游戏 | 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"/> <img src="/imgs/zone/knowledge.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| ---------------------------------------------- | ----------------- | ------ | ------------------------------------------------------ | ------------------------------------------------------------ | | ---------------------------------------------- | ----------------- | ------ | ------------------------------------------------------ | ------------------------------------------------------------ |
| 知识(主分区) | knowledge | 36 | | [/v/knowledge](https://www.bilibili.com/v/knowledge) | | 知识(主分区) | knowledge | 36 | | [/v/knowledge](https://www.bilibili.com/v/knowledge) |
| 科学科普 | science | 201 | 回答你的十万个为什么 | [/v/knowledge/science](https://www.bilibili.com/v/knowledge/science) | | 科学科普 | 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"/> 旧：<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) | | 科技(主分区) | tech | 188 | | [/v/tech](https://www.bilibili.com/v/tech) |
| 数码(~~原手机平板~~) | digital | 95 | 科技数码产品大全，一起来做发烧友 | [/v/tech/digital](https://www.bilibili.com/v/tech/digital) | | 数码(~~原手机平板~~) | 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"/> <img src="/imgs/zone/car.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | -------- | ---- | ------------------------------------------------------------ | ---------------------------------------------------------- | | -------------- | -------- | ---- | ------------------------------------------------------------ | ---------------------------------------------------------- |
| 汽车（主分区） | car | 223 | | [/v/car](https://www.bilibili.com/v/car) | | 汽车（主分区） | car | 223 | | [/v/car](https://www.bilibili.com/v/car) |
| 汽车生活 | life | 176 | 分享汽车及出行相关的生活体验类视频 | [/v/car/life](https://www.bilibili.com/v/car/life) | | 汽车生活 | 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"/> <img src="/imgs/zone/life.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------------- | -------------- | ------- | ------------------------------------------------ | ------------------------------------------------------------ | | -------------------- | -------------- | ------- | ------------------------------------------------ | ------------------------------------------------------------ |
| 生活（主分区） | life | 160 | | [/v/life](https://www.bilibili.com/v/life) | | 生活（主分区） | life | 160 | | [/v/life](https://www.bilibili.com/v/life) |
| 搞笑 | funny | 138 | 各种沙雕有趣的搞笑剪辑，挑战，表演，配音等视频 | [/v/life/funny](https://www.bilibili.com/v/life/funny) | | 搞笑 | 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"/> <img src="/imgs/zone/food.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| ------------------------------ | ----------- | ---- | -------------------------------- | ------------------------------------------------------------ | | ------------------------------ | ----------- | ---- | -------------------------------- | ------------------------------------------------------------ |
| 美食（主分区） | food | 211 | | [/v/food](https://www.bilibili.com/v/food) | | 美食（主分区） | food | 211 | | [/v/food](https://www.bilibili.com/v/food) |
| 美食制作（原[生活]->[美食圈]） | make | 76 | 学做人间美味，展示精湛厨艺 | [/v/food/make](https://www.bilibili.com/v/food/make) | | 美食制作（原[生活]->[美食圈]） | 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"/> <img src="/imgs/zone/animal.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------- | ---------------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | -------- | ---------------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 动物圈 | animal（主分区） | 217 | | [/v/animal](https://www.bilibili.com/v/animal) | | 动物圈 | animal（主分区） | 217 | | [/v/animal](https://www.bilibili.com/v/animal) |
| 喵星人 | cat | 218 | 喵喵喵喵喵 | [/v/animal/cat](https://www.bilibili.com/v/animal/cat) | | 喵星人 | 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"/> <img src="/imgs/zone/kichiku.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | --------------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | -------------- | --------------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 鬼畜（主分区） | kichiku | 119 | | [/v/kichiku](https://www.bilibili.com/v/kichiku) | | 鬼畜（主分区） | kichiku | 119 | | [/v/kichiku](https://www.bilibili.com/v/kichiku) |
| 鬼畜调教 | guide | 22 | 使用素材在音频、画面上做一定处理，达到与BGM一定的同步感 | [/v/kichiku/guide](https://www.bilibili.com/v/kichiku/guide) | | 鬼畜调教 | 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"/> <img src="/imgs/zone/fashion.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | -------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | -------------- | -------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 时尚（主分区） | fashion | 155 | | [/v/fashion](https://www.bilibili.com/v/fashion) | | 时尚（主分区） | fashion | 155 | | [/v/fashion](https://www.bilibili.com/v/fashion) |
| 美妆 | makeup | 157 | 涵盖妆容、发型、美甲等教程，彩妆、护肤相关产品测评、分享等 | [/v/fashion/makeup](https://www.bilibili.com/v/fashion/makeup) | | 美妆 | 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"/> <img src="/imgs/zone/information.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ----------- | ---- | -------------------------------------------- | ------------------------------------------------------------ | | -------------- | ----------- | ---- | -------------------------------------------- | ------------------------------------------------------------ |
| 资讯（主分区） | information | 202 | | [/v/information](https://www.bilibili.com/v/information) | | 资讯（主分区） | information | 202 | | [/v/information](https://www.bilibili.com/v/information) |
| 热点 | hotspot | 203 | 全民关注的时政热门资讯 | [/v/information/hotspot](https://www.bilibili.com/v/information/hotspot) | | 热点 | 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"/> <img src="/imgs/zone/ad.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| ------------------ | ------ | ------- | ---- | ------------ | | ------------------ | ------ | ------- | ---- | ------------ |
| ~~广告（主分区）~~ | ~~ad~~ | ~~165~~ | | ~~/v/ad~~ | | ~~广告（主分区）~~ | ~~ad~~ | ~~165~~ | | ~~/v/ad~~ |
| ~~广告~~ | ~~ad~~ | ~~166~~ | | ~~/v/ad/ad~~ | | ~~广告~~ | ~~ad~~ | ~~166~~ | | ~~/v/ad/ad~~ |
@@ -249,7 +249,7 @@
<img src="/imgs/zone/ent.svg" width="100" height="100"/> <img src="/imgs/zone/ent.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| ----------------------- | --------- | ------- | ----------------------------------- | -------------------------------------------------------- | | ----------------------- | --------- | ------- | ----------------------------------- | -------------------------------------------------------- |
| 娱乐（主分区） | ent | 5 | | [/v/ent](https://www.bilibili.com/v/ent) | | 娱乐（主分区） | ent | 5 | | [/v/ent](https://www.bilibili.com/v/ent) |
| 综艺 | variety | 71 | 国内外有趣的综艺和综艺相关精彩剪辑 | [/v/ent/variety](https://www.bilibili.com/v/ent/variety) | | 综艺 | 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"/> <img src="/imgs/zone/cinephile.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ------------ | ---- | -------------------------------- | ------------------------------------------------------------ | | -------------- | ------------ | ---- | -------------------------------- | ------------------------------------------------------------ |
| 影视（主分区） | cinephile | 181 | | [/v/cinephile](https://www.bilibili.com/v/cinephile) | | 影视（主分区） | cinephile | 181 | | [/v/cinephile](https://www.bilibili.com/v/cinephile) |
| 影视杂谈 | cinecism | 182 | 影视评论、解说、吐槽、科普等 | [/v/cinephile/cinecism](https://www.bilibili.com/v/cinephile/cinecism) | | 影视杂谈 | 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"/> <img src="/imgs/zone/documentary.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| ---------------- | ----------- | ---- | ---- | ------------------------------------------------------------ | | ---------------- | ----------- | ---- | ---- | ------------------------------------------------------------ |
| 纪录片（主分区） | documentary | 177 | | [/documentary](https://www.bilibili.com/documentary) | | 纪录片（主分区） | documentary | 177 | | [/documentary](https://www.bilibili.com/documentary) |
| 人文·历史 | history | 37 | | [/v/documentary/history](https://www.bilibili.com/v/documentary/history) | | 人文·历史 | 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"/> <img src="/imgs/zone/movie.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| -------------- | ------- | ---- | ---- | ------------------------------------------------------------ | | -------------- | ------- | ---- | ---- | ------------------------------------------------------------ |
| 电影（主分区） | movie | 23 | | [/movie](https://www.bilibili.com/movie) | | 电影（主分区） | movie | 23 | | [/movie](https://www.bilibili.com/movie) |
| 华语电影 | chinese | 147 | | [/v/movie/chinese](https://www.bilibili.com/v/movie/chinese) | | 华语电影 | 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"/> <img src="/imgs/zone/teleplay.svg" width="100" height="100"/>
| 名称 | 代号 | tID | 简介 | url路由 | | 名称 | 代号 | tid | 简介 | url路由 |
| ---------------- | -------- | ---- | ---- | -------------------------------------------------------- | | ---------------- | -------- | ---- | ---- | -------------------------------------------------------- |
| 电视剧（主分区） | tv | 11 | | [/tv](https://www.bilibili.com/tv) | | 电视剧（主分区） | tv | 11 | | [/tv](https://www.bilibili.com/tv) |
| 国产剧 | mainland | 185 | | [/v/tv/mainland](https://www.bilibili.com/v/tv/mainland) | | 国产剧 | mainland | 185 | | [/v/tv/mainland](https://www.bilibili.com/v/tv/mainland) |
video/videostream_url.md
+10 -10
View File
@@ -83,15 +83,15 @@ B站的视频为http流媒体，需要对应的api以视频id获取取流url，
**部分视频**会有**分段**，需要特别注意 **部分视频**会有**分段**，需要特别注意
若视频有分P，仅为单P的视频的url，换P则需更换CID重新获取 若视频有分P，仅为单P的视频的url，换P则需更换cid重新获取
**url参数：** **url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------------- | ------------ | ------------------------------------------------------------ | | ------ | ---- | ---------------- | ------------ | ------------------------------------------------------------ |
| avid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | | avid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| cid | num | 视频CID | 必要 | | | cid | num | 视频cid | 必要 | |
| qn | num | 视频清晰度选择 | 非必要 | 未登录默认32（480P）<br />登录默认64（720P）<br />**值含义见上表**<br />注：dash方式无效 | | 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） | | fnval | num | 视频获取方式选择 | 非必要 | 默认为0<br />0 2：flv方式（可能会有分段）<br />1：低清mp4方式（仅240P与360P，且限速65K/s）<br />16 80：dash方式（音视频分流，支持H.265） |
| fnver | num | 0 | 非必要 | 固定为0 | | 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 ```shell
curl -G 'http://api.bilibili.com/x/player/playurl' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/player/playurl' \ 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 ```shell
curl -G 'http://api.bilibili.com/x/player/playurl' \ 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' -b 'SESSDATA=xxx'
``` ```
bvID方式： bvid方式：
```shell ```shell
curl -G 'http://api.bilibili.com/x/player/playurl' \ curl -G 'http://api.bilibili.com/x/player/playurl' \