From 0bf212535e54b3e4c3670175547be6fc400d8507 Mon Sep 17 00:00:00 2001 From: HIM~ <67405384+HIM049@users.noreply.github.com> Date: Tue, 13 Feb 2024 18:33:29 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E8=A7=86=E9=A2=91=E5=90=88?= =?UTF-8?q?=E9=9B=86=E6=9F=A5=E8=AF=A2=E6=8E=A5=E5=8F=A3=E4=BF=A1=E6=81=AF?= =?UTF-8?q?=20(#965)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * 新增关于视频合集内容请求方式 * 完善描述 * 增加页面到主目录 --- README.md | 1 + docs/video/collection.md | 92 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 93 insertions(+) create mode 100644 docs/video/collection.md diff --git a/README.md b/README.md index 37d14f7..45861ad 100644 --- a/README.md +++ b/README.md @@ -119,6 +119,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接 - [x] [视频AI摘要](docs/video/summary.md) - [ ] [稿件投诉](docs/video/appeal.md) - [ ] [视频状态数](docs/video/status_number.md) + - [ ] [视频合集](docs/video/collection.md) - [ ] [剧集 (番剧、影视)](docs/bangumi) - [ ] [基本信息](docs/bangumi/info.md) - [ ] [播放&下载地址（视频流）](docs/bangumi/videostream_url.md) diff --git a/docs/video/collection.md b/docs/video/collection.md new file mode 100644 index 0000000..1dbea2f --- /dev/null +++ b/docs/video/collection.md @@ -0,0 +1,92 @@ +# 视频合集信息 + +## 获取视频合集信息 + +> https://api.bilibili.com/x/polymer/web-space/seasons_archives_list + +*请求方式：GET* + +**url参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +|--------|-----|------|--------|-----| +| mid | num | UP 主 ID | 必要 | | +| season_id | num | 视频合集 ID | 必要 | | +| sort_reverse | bool | 未知 | 可选 | | +| page_num | num | 页码索引 | 可选 | | +| page_size | num | 单页内容数量 | 可选 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|------------------------------------------------------------------------------------| +| code | num | 返回值 | 0：成功 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------------------- | ------- | ------------------------------ | ----------------------------------------------------------- | +| aids | array | 稿件avid | 对应下方数组中内容 aid | +| archives | array | 合集中的视频 | | +| meta | obj | 合集元数据 | | +| page | obj | 分页信息 | | + +`data`中的`archives`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|----------|---------| +| 0 | obj | 合集内容 | | +| n | obj | (n+1)P内容 | | +| …… | obj | …… | …… | + +`archives`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|----------|-----|------|-----| +| aid | num | 稿件avid || +| bvid | str | 稿件bvid || +| ctime | num | 创建时间 | Unix 时间戳 | +| duration | num | 视频时长 | 单位为秒 | +| enable_vt | bool | false || +| interactive_video | bool | false || +| pic | str | 封面 URL || +| playback_position | num || 会随着播放时间增长，播放完成后为 -1 。单位未知 | +| pubdate | num | 发布日期 | Unix 时间戳 | +| stat | obj | 稿件信息 || +| state | num | 0 || +| title | str | 稿件标题|| +| ugc_pay | num | 0 || +| vt_display | str ||| + +`archives`中的`stat`对象： + +| 字段 | 类型 | 内容 | 备注 | +|----------|-----|------|-----| +| view | num | 稿件播放量 || +| vt | num | 0 || + +`data`中的`meta`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-----------------|-----|--------------|--------| +| category | num | 0 | | +| covr | str | 合集封面 URL | | +| description | str | 合集描述 | | +| mid | num | UP 主 ID | | +| name | num | 合集标题 | | +| ptime | num | 发布时间 | Unix 时间戳 | +| season_id | num | 合集 ID | | +| total | num | 合集内视频数量 | | + +`data`中的`page`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-----------------|-----|--------------|--------| +| page_num | num | 分页页码 | | +| page_size | num | 单页个数 | | +| total | num | 合集内视频数量 | |