Skip to content

Commit 268b4cf

Browse files
authored
feat: 添加各分区轮播图 (#1372)
* feat: 添加各分区轮播图与封面主色调获取API * fix: 删除新增的主色调API代码,导向至图片格式化
1 parent 344d010 commit 268b4cf

File tree

2 files changed

+125
-0
lines changed

2 files changed

+125
-0
lines changed

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -295,6 +295,7 @@ B站 API 采用 C/S 结构,大多数接口为 REST API 和 gRPC,少部分接
295295
- [x] [分区当日投稿数](docs/web_widget/zone_upload.md)
296296
- [x] [404 页漫画收集](docs/web_widget/404_manga.md)
297297
- [ ] [首页横幅头图](docs/web_widget/header.md)
298+
- [ ] [分区横幅轮播图](docs/web_widget/banner.md)
298299
- [ ] [APP 端组件](docs/APP_widget)
299300
- [x] [开屏图片 + 恰饭珍贵录像](docs/APP_widget/splash.md)
300301
- [ ] [获取最新 APP 版本](docs/APP_widget/ver.md)

docs/web_widget/banner.md

Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
# 横幅轮播图
2+
3+
## 获取各分区的轮播图_web端
4+
5+
> https://api.bilibili.com/x/web-show/region/banner
6+
7+
*请求方式: GET*
8+
9+
需要请求头参数 User-Agent
10+
11+
鉴权方式:Wbi 签名 (可选)
12+
13+
**URL参数:**
14+
15+
| 字段 | 类型 | 内容 | 必要性 | 备注 |
16+
| ------- | ---- | -------- | ------- | -------------- |
17+
| region_id | num | 目标分区id | 必要 | 参见[视频分区一览v2](../video/video_zone_v2.md) |
18+
| w_rid | str | Wbi 签名 | 非必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
19+
| wts | num | 当前时间戳 | 非必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
20+
21+
**JSON回复:**
22+
23+
根对象:
24+
25+
| 字段 | 类型 | 内容 | 备注 |
26+
| -- | -- | -- | -- |
27+
| code | num | 返回值 | 0: 成功 |
28+
| message | str | 错误信息 | 默认为 0 |
29+
| ttl | str | 1 | |
30+
| data | obj | 信息本体 | |
31+
32+
`data` 对象:
33+
34+
| 字段 | 类型 | 内容 | 备注 |
35+
| -- | -- | -- | -- |
36+
| region_banner_list | array | 存储轮播图的对象 | |
37+
38+
`data` 对象里的 `region_banner_list` 数组:
39+
40+
|| 类型 | 内容 | 备注 |
41+
| -- | -- | -- | -- |
42+
| 0 | obj | 第一个轮播图对象 | |
43+
| n | obj | 第 (n+1) 轮播图对象 | |
44+
| …… | obj | …… | |
45+
46+
`region_banner_list` 数组里的对象:
47+
48+
| 字段 | 类型 | 内容 | 备注 |
49+
| -- | -- | -- | -- |
50+
| image | str | 封面资源路径 | |
51+
| title | str | 封面标题 | |
52+
| sub_title | str | 封面子标题 ||
53+
| url | str | 点击封面后指向的链接 | 可能为视频地址,也有可能是活动地址 |
54+
| rid | num | 分区参见[视频分区一览v2](../video/video_zone_v2.md) | |
55+
56+
**示例:**
57+
58+
获取 `音乐区` 时刻为 `Wed, 06 Aug 2025 01:41:35 GMT` 的 B 站轮播图 [音乐区地址](https://www.bilibili.com/c/music/)
59+
60+
```shell
61+
curl -G "https://api.bilibili.com/x/web-show/region/banner" \
62+
--data-urlencode "region_id=1003" \
63+
-H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko Chrome/58.0.3029.110 Safari/537.36"
64+
```
65+
66+
<details>
67+
<summary>查看响应示例:</summary>
68+
69+
```json
70+
{
71+
"code": 0,
72+
"message": "0",
73+
"ttl": 1,
74+
"data": {
75+
"region_banner_list": [
76+
{
77+
"image": "http://i0.hdslb.com/bfs/app/61e4bf3bba74f7d975342ae9d6ec7b0a2ea7c83f.jpg",
78+
"title": "舞力全开派对首测共创活动上线啦!",
79+
"sub_title": "",
80+
"url": "https://www.bilibili.com/blackboard/era/wzjckpevcdCgf4Rv.html",
81+
"rid": 1003
82+
},
83+
{
84+
"image": "http://i0.hdslb.com/bfs/app/a7d63dc78d10f769bd80c6c27ba6cc337b00d9d9.jpg",
85+
"title": "玛莎拉达带着他的一系列爆款术曲来了!",
86+
"sub_title": "",
87+
"url": "https://www.bilibili.com/video/BV1Tbtjz1Ehv",
88+
"rid": 1003
89+
},
90+
{
91+
"image": "http://i0.hdslb.com/bfs/app/01beb60c493f98eea6844cc2efcbde7315ce6224.jpg",
92+
"title": "陶喆Alin合作曲MV首播!",
93+
"sub_title": "",
94+
"url": "https://www.bilibili.com/video/BV1w1tnznEMw/?spm_id_from=333.337.search-card.all.click",
95+
"rid": 1003
96+
},
97+
{
98+
"image": "http://i0.hdslb.com/bfs/app/64060527172b03292b860e43532ff56faabdbe2d.jpg",
99+
"title": "四种语言版《AMANI》:愿世界和平",
100+
"sub_title": "",
101+
"url": "https://www.bilibili.com/video/BV1WTgVzHE2S/",
102+
"rid": 1003
103+
},
104+
{
105+
"image": "http://i0.hdslb.com/bfs/app/cbc4469b10c041702c49e847552301afeea323cd.jpg",
106+
"title": "孙亦航来B站啦!",
107+
"sub_title": "",
108+
"url": "https://www.bilibili.com/video/BV1RHtFzLEUA",
109+
"rid": 1003
110+
},
111+
{
112+
"image": "http://i0.hdslb.com/bfs/app/134cede692acbbe3080dc2a2ecc920db1f4f7498.jpg",
113+
"title": "潘玮柏狂爱《Yes I Do》",
114+
"sub_title": "",
115+
"url": "https://www.bilibili.com/video/BV1RAtcz7EJX/?spm_id_from=333.337.search-card.all.click",
116+
"rid": 1003
117+
}
118+
]
119+
}
120+
}
121+
```
122+
</details>
123+
124+
* Tip: 可以使用 [图片格式化](../misc/picture.md)中 获取主色调的方式获取轮播图封面的主色调

0 commit comments

Comments
 (0)