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

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

View File

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

View File

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