From c5dd5621e9c272a3b718a4e8c8b63aee6a3c80f0 Mon Sep 17 00:00:00 2001
From: TeAnLi <m1055965862@163.com>
Date: Wed, 6 Aug 2025 19:20:16 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=E5=90=84=E5=88=86?=
 =?UTF-8?q?=E5=8C=BA=E8=BD=AE=E6=92=AD=E5=9B=BE=E4=B8=8E=E5=B0=81=E9=9D=A2?=
 =?UTF-8?q?=E4=B8=BB=E8=89=B2=E8=B0=83=E8=8E=B7=E5=8F=96API?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                 |   1 +
 docs/web_widget/banner.md | 158 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 159 insertions(+)
 create mode 100644 docs/web_widget/banner.md

diff --git a/README.md b/README.md
index 26b90f5..1dca1ee 100644
--- a/README.md
+++ b/README.md
@@ -295,6 +295,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
     - [x] [分区当日投稿数](docs/web_widget/zone_upload.md)
     - [x] [404 页漫画收集](docs/web_widget/404_manga.md)
     - [ ] [首页横幅头图](docs/web_widget/header.md)
+    - [ ] [分区横幅轮播图](docs/web_widget/banner.md)
 - [ ] [APP 端组件](docs/APP_widget)
     - [x] [开屏图片 + 恰饭珍贵录像](docs/APP_widget/splash.md)
     - [ ] [获取最新 APP 版本](docs/APP_widget/ver.md)
diff --git a/docs/web_widget/banner.md b/docs/web_widget/banner.md
new file mode 100644
index 0000000..c59bba5
--- /dev/null
+++ b/docs/web_widget/banner.md
@@ -0,0 +1,158 @@
+# 横幅轮播图
+
+## 获取各分区的轮播图_web端
+
+> https://api.bilibili.com/x/web-show/region/banner
+
+*请求方式: GET*
+
+需要请求头参数 User-Agent
+
+鉴权方式：Wbi 签名 (可选)
+
+**URL参数:**
+
+| 字段      | 类型  | 内容      | 必要性   |  备注          |
+| -------   | ---- | --------  | ------- | -------------- |
+| region_id | num  | 目标分区id | 必要    | 参见[视频分区一览v2](../video/video_zone_v2.md) |
+| w_rid     | str  | Wbi 签名   | 非必要  | 详见 [Wbi 签名](../misc/sign/wbi.md) |
+| wts       | num  | 当前时间戳	 | 非必要  | 详见 [Wbi 签名](../misc/sign/wbi.md) |
+
+**JSON回复:**
+
+根对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| -- | -- | -- | -- |
+| code | num | 返回值 | 0: 成功 |
+| message | str | 错误信息 | 默认为 0 |
+| ttl | str | 1 | |
+| data | obj | 信息本体 | |
+
+`data` 对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| -- | -- | -- | -- |
+| region_banner_list | array | 存储轮播图的对象 | |
+
+`data` 对象里的 `region_banner_list` 数组:
+
+| 项 | 类型 | 内容 | 备注 |
+| -- | -- | -- | -- | 
+| 0 | obj | 第一个轮播图对象 | |
+| n | obj | 第 (n+1) 轮播图对象 | |
+| …… | obj | …… | |
+
+`region_banner_list` 数组里的对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| -- | -- | -- | -- |
+| image | str | 封面资源路径 | |
+| title | str | 封面标题 | |
+| sub_title | str | 封面子标题 | 空 |
+| url | str | 点击封面后指向的链接 | 可能为视频地址，也有可能是活动地址 |
+| rid | num | 分区参见[视频分区一览v2](../video/video_zone_v2.md) | |
+
+**示例:**
+
+获取 `音乐区` 时刻为 `Wed, 06 Aug 2025 01:41:35 GMT` 的 B 站轮播图 [音乐区地址](https://www.bilibili.com/c/music/)
+
+```shell
+curl -G "https://api.bilibili.com/x/web-show/region/banner" \
+      --data-urlencode "region_id=1003" \
+      -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"
+```
+
+<details>
+<summary>查看响应示例:</summary>
+
+```json
+{
+  "code": 0,
+  "message": "0",
+  "ttl": 1,
+  "data": {
+    "region_banner_list": [
+      {
+        "image": "http://i0.hdslb.com/bfs/app/61e4bf3bba74f7d975342ae9d6ec7b0a2ea7c83f.jpg",
+        "title": "舞力全开派对首测共创活动上线啦！",
+        "sub_title": "",
+        "url": "https://www.bilibili.com/blackboard/era/wzjckpevcdCgf4Rv.html",
+        "rid": 1003
+      },
+      {
+        "image": "http://i0.hdslb.com/bfs/app/a7d63dc78d10f769bd80c6c27ba6cc337b00d9d9.jpg",
+        "title": "玛莎拉达带着他的一系列爆款术曲来了！",
+        "sub_title": "",
+        "url": "https://www.bilibili.com/video/BV1Tbtjz1Ehv",
+        "rid": 1003
+      },
+      {
+        "image": "http://i0.hdslb.com/bfs/app/01beb60c493f98eea6844cc2efcbde7315ce6224.jpg",
+        "title": "陶喆Alin合作曲MV首播！",
+        "sub_title": "",
+        "url": "https://www.bilibili.com/video/BV1w1tnznEMw/?spm_id_from=333.337.search-card.all.click",
+        "rid": 1003
+      },
+      {
+        "image": "http://i0.hdslb.com/bfs/app/64060527172b03292b860e43532ff56faabdbe2d.jpg",
+        "title": "四种语言版《AMANI》：愿世界和平",
+        "sub_title": "",
+        "url": "https://www.bilibili.com/video/BV1WTgVzHE2S/",
+        "rid": 1003
+      },
+      {
+        "image": "http://i0.hdslb.com/bfs/app/cbc4469b10c041702c49e847552301afeea323cd.jpg",
+        "title": "孙亦航来B站啦！",
+        "sub_title": "",
+        "url": "https://www.bilibili.com/video/BV1RHtFzLEUA",
+        "rid": 1003
+      },
+      {
+        "image": "http://i0.hdslb.com/bfs/app/134cede692acbbe3080dc2a2ecc920db1f4f7498.jpg",
+        "title": "潘玮柏狂爱《Yes I Do》",
+        "sub_title": "",
+        "url": "https://www.bilibili.com/video/BV1RAtcz7EJX/?spm_id_from=333.337.search-card.all.click",
+        "rid": 1003
+      }
+    ]
+  }
+}
+```
+</details>
+
+## 图片主色调获取
+
+* 前提是基于`https://i0.hdslb.com/bfs/archive` host 下的图片
+
+### 使用方法
+
+*请求方式: GET*
+
+访问地址: 在所获取的图片地址中尾部加入`@.avg_color`
+
+>  https://i0.hdslb.com/bfs/archive/`图片地址`@.avg_color
+
+**JSON回复:**
+| 字段 | 类型 | 内容 |
+| -- | -- | -- |
+| RGB | str | 封面的主色调的RGB 16进制代码 |
+
+**示例:**
+获取图片 [潘玮柏狂爱《Yes I Do》](http://i0.hdslb.com/bfs/app/134cede692acbbe3080dc2a2ecc920db1f4f7498.jpg) 封面的主色调的RGB 16进制代码
+
+```shell
+curl -G "http://i0.hdslb.com/bfs/app/134cede692acbbe3080dc2a2ecc920db1f4f7498.jpg@.avg_color" \
+```
+
+
+<details>
+<summary>查看响应示例:</summary>
+
+```json
+{
+  "RGB": "#c6434a"
+}
+```
+
+</details>