返回提交历史
Modified
README.md
+1
-0
Added
docs/dynamic/banner.md
+81
-0
XFEstudio/bilibili-API-collect
feat: 动态首页公告栏 (新版)
close #1255
f9d238b
代码差异
2 个文件
+82
-0
@@ -176,6 +176,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
176
176
- [x] [特定话题动态列表](docs/dynamic/tag_dynamics.md)
177
177
- [ ] [动态内容](docs/dynamic/get_dynamic_detail.md)
178
178
- [ ] [导航栏动态](docs/dynamic/nav.md)
179
- [ ] [首页公告栏](docs/dynamic/banner.md)
179
180
- [ ] [创作中心](docs/creativecenter)
180
181
- [ ] [投稿](docs/creativecenter/upload.md)
181
182
- [ ] [统计与数据](docs/creativecenter/statistics&data.md)
@@ -0,0 +1,81 @@
1
# 首页公告栏
2
3
## 动态首页公告栏 (新版)
4
5
> https://api.bilibili.com/x/dynamic/feed/dyn/banner
6
7
*请求方法: GET*
8
9
**URL 参数:**
10
11
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
12
| ------ | ---- | ---- | ------ | ---- |
13
| platform | number | 平台? | 不必要 | 默认为 `1`, 留空无 |
14
| position | string | 位置? | 不必要 | 默认为 `web动态`, 留空无 |
15
| web_location | string | `333.1365` | 不必要 | |
16
17
**JSON 回复:**
18
19
根对象:
20
21
| 字段 | 类型 | 内容 | 备注 |
22
| ---- | ---- | ---- | ---- |
23
| code | number | 返回值 | 0: 成功 |
24
| data | object | 数据本体 | |
25
| message | string | 错误信息 | 成功时为 `0` |
26
| ttl | number | `1` | |
27
28
`data` 对象:
29
30
| 字段 | 类型 | 内容 | 备注 |
31
| ---- | ---- | ---- | ---- |
32
| banners | object[] | 横幅们 | 套了个娃 |
33
34
`data.banners[]` 对象:
35
36
| 字段 | 类型 | 内容 | 备注 |
37
| ---- | ---- | ---- | ---- |
38
| banner_id | number | 横幅 id | 旧版接口无 |
39
| end_time | number | 结束时间 | UNIX 秒级时间戳 |
40
| img_url | string | 图片 URL | |
41
| link | string | 跳转链接 | |
42
| platform | number | 平台 | 与请求参数对应 |
43
| position | string | 位置 | 与请求参数对应 |
44
| start_time | number | 开始时间 | UNIX 秒级时间戳 |
45
| title | string | 标题 | |
46
| weight | number | 权重 | |
47
48
**示例:**
49
50
```shell
51
curl 'https://api.bilibili.com/x/dynamic/feed/dyn/banner?platform=1&position=web动态&web_location=333.1365'
52
```
53
54
<details>
55
<summary>查看响应示例:</summary>
56
57
```json
58
{
59
"code": 0,
60
"data": {
61
"banners": [
62
{
63
"banner_id": 20,
64
"end_time": 2056204800,
65
"img_url": "https://i0.hdslb.com/bfs/vc/9c699f2acbcad00197e92c401b835d2c6aba8a55.png",
66
"link": "https://www.bilibili.com/blackboard/activity-5zJxM3spoS.html",
67
"platform": 1,
68
"position": "web动态",
69
"start_time": 1582862523,
70
"title": "点击进入",
71
"weight": 1
72
}
73
]
74
},
75
"message": "0",
76
"ttl": 1
77
}
78
```
79
</details>
80
81
<!-- Generated by json-apidoc-gen @ 2025-05-01T00:21:48.81113265Z -->