返回提交历史
Modified
README.md
+1
-0
Added
docs/video/collection.md
+92
-0
XFEstudio/bilibili-API-collect
新增视频合集查询接口信息 (#965)
* 新增关于视频合集内容请求方式 * 完善描述 * 增加页面到主目录
0bf2125
代码差异
2 个文件
+93
-0
@@ -119,6 +119,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
119
119
- [x] [视频AI摘要](docs/video/summary.md)
120
120
- [ ] [稿件投诉](docs/video/appeal.md)
121
121
- [ ] [视频状态数](docs/video/status_number.md)
122
- [ ] [视频合集](docs/video/collection.md)
122
123
- [ ] [剧集 (番剧、影视)](docs/bangumi)
123
124
- [ ] [基本信息](docs/bangumi/info.md)
124
125
- [ ] [播放&下载地址（视频流）](docs/bangumi/videostream_url.md)
@@ -0,0 +1,92 @@
1
# 视频合集信息
2
3
## 获取视频合集信息
4
5
> https://api.bilibili.com/x/polymer/web-space/seasons_archives_list
6
7
*请求方式：GET*
8
9
**url参数：**
10
11
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
12
|--------|-----|------|--------|-----|
13
| mid | num | UP 主 ID | 必要 | |
14
| season_id | num | 视频合集 ID | 必要 | |
15
| sort_reverse | bool | 未知 | 可选 | |
16
| page_num | num | 页码索引 | 可选 | |
17
| page_size | num | 单页内容数量 | 可选 | |
18
19
**json回复：**
20
21
根对象：
22
23
| 字段 | 类型 | 内容 | 备注 |
24
|---------|-----|------|------------------------------------------------------------------------------------|
25
| code | num | 返回值 | 0：成功 |
26
| message | str | 错误信息 | 默认为0 |
27
| ttl | num | 1 | |
28
| data | obj | 信息本体 | |
29
30
`data`对象：
31
32
| 字段 | 类型 | 内容 | 备注 |
33
| ----------------------- | ------- | ------------------------------ | ----------------------------------------------------------- |
34
| aids | array | 稿件avid | 对应下方数组中内容 aid |
35
| archives | array | 合集中的视频 | |
36
| meta | obj | 合集元数据 | |
37
| page | obj | 分页信息 | |
38
39
`data`中的`archives`数组：
40
41
| 项 | 类型 | 内容 | 备注 |
42
|-----|-----|----------|---------|
43
| 0 | obj | 合集内容 | |
44
| n | obj | (n+1)P内容 | |
45
| …… | obj | …… | …… |
46
47
`archives`数组中的对象：
48
49
| 字段 | 类型 | 内容 | 备注 |
50
|----------|-----|------|-----|
51
| aid | num | 稿件avid ||
52
| bvid | str | 稿件bvid ||
53
| ctime | num | 创建时间 | Unix 时间戳 |
54
| duration | num | 视频时长 | 单位为秒 |
55
| enable_vt | bool | false ||
56
| interactive_video | bool | false ||
57
| pic | str | 封面 URL ||
58
| playback_position | num || 会随着播放时间增长，播放完成后为 -1 。单位未知 |
59
| pubdate | num | 发布日期 | Unix 时间戳 |
60
| stat | obj | 稿件信息 ||
61
| state | num | 0 ||
62
| title | str | 稿件标题||
63
| ugc_pay | num | 0 ||
64
| vt_display | str |||
65
66
`archives`中的`stat`对象：
67
68
| 字段 | 类型 | 内容 | 备注 |
69
|----------|-----|------|-----|
70
| view | num | 稿件播放量 ||
71
| vt | num | 0 ||
72
73
`data`中的`meta`对象：
74
75
| 字段 | 类型 | 内容 | 备注 |
76
|-----------------|-----|--------------|--------|
77
| category | num | 0 | |
78
| covr | str | 合集封面 URL | |
79
| description | str | 合集描述 | |
80
| mid | num | UP 主 ID | |
81
| name | num | 合集标题 | |
82
| ptime | num | 发布时间 | Unix 时间戳 |
83
| season_id | num | 合集 ID | |
84
| total | num | 合集内视频数量 | |
85
86
`data`中的`page`对象：
87
88
| 字段 | 类型 | 内容 | 备注 |
89
|-----------------|-----|--------------|--------|
90
| page_num | num | 分页页码 | |
91
| page_size | num | 单页个数 | |
92
| total | num | 合集内视频数量 | |