From f9d238b0be29ff95f7584e58967afa007f8d6d6f Mon Sep 17 00:00:00 2001
From: SessionHu <102411014+SessionHu@users.noreply.github.com>
Date: Thu, 1 May 2025 08:37:40 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=8A=A8=E6=80=81=E9=A6=96=E9=A1=B5?=
 =?UTF-8?q?=E5=85=AC=E5=91=8A=E6=A0=8F=20(=E6=96=B0=E7=89=88)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

close #1255
---
 README.md              |  1 +
 docs/dynamic/banner.md | 81 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 82 insertions(+)
 create mode 100644 docs/dynamic/banner.md

diff --git a/README.md b/README.md
index f3dc19f..023546a 100644
--- a/README.md
+++ b/README.md
@@ -176,6 +176,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
         - [x] [特定话题动态列表](docs/dynamic/tag_dynamics.md)
     - [ ] [动态内容](docs/dynamic/get_dynamic_detail.md)
     - [ ] [导航栏动态](docs/dynamic/nav.md)
+    - [ ] [首页公告栏](docs/dynamic/banner.md)
 - [ ] [创作中心](docs/creativecenter)
     - [ ] [投稿](docs/creativecenter/upload.md)
     - [ ] [统计与数据](docs/creativecenter/statistics&data.md)
diff --git a/docs/dynamic/banner.md b/docs/dynamic/banner.md
new file mode 100644
index 0000000..d160928
--- /dev/null
+++ b/docs/dynamic/banner.md
@@ -0,0 +1,81 @@
+# 首页公告栏
+
+## 动态首页公告栏 (新版)
+
+> https://api.bilibili.com/x/dynamic/feed/dyn/banner
+
+*请求方法: GET*
+
+**URL 参数:**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ---- | ------ | ---- |
+| platform | number | 平台? | 不必要 | 默认为 `1`, 留空无 |
+| position | string | 位置? | 不必要 | 默认为 `web动态`, 留空无 |
+| web_location | string | `333.1365` | 不必要 |  |
+
+**JSON 回复:**
+
+根对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ---- | ---- |
+| code | number | 返回值 | 0: 成功 |
+| data | object | 数据本体 |  |
+| message | string | 错误信息 | 成功时为 `0` |
+| ttl | number | `1` |  |
+
+`data` 对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ---- | ---- |
+| banners | object[] | 横幅们 | 套了个娃 |
+
+`data.banners[]` 对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ---- | ---- |
+| banner_id | number | 横幅 id | 旧版接口无 |
+| end_time | number | 结束时间 | UNIX 秒级时间戳 |
+| img_url | string | 图片 URL |  |
+| link | string | 跳转链接 |  |
+| platform | number | 平台 | 与请求参数对应 |
+| position | string | 位置 | 与请求参数对应 |
+| start_time | number | 开始时间 | UNIX 秒级时间戳 |
+| title | string | 标题 |  |
+| weight | number | 权重 |  |
+
+**示例:**
+
+```shell
+curl 'https://api.bilibili.com/x/dynamic/feed/dyn/banner?platform=1&position=web动态&web_location=333.1365'
+```
+
+<details>
+<summary>查看响应示例:</summary>
+
+```json
+{
+  "code": 0,
+  "data": {
+    "banners": [
+      {
+        "banner_id": 20,
+        "end_time": 2056204800,
+        "img_url": "https://i0.hdslb.com/bfs/vc/9c699f2acbcad00197e92c401b835d2c6aba8a55.png",
+        "link": "https://www.bilibili.com/blackboard/activity-5zJxM3spoS.html",
+        "platform": 1,
+        "position": "web动态",
+        "start_time": 1582862523,
+        "title": "点击进入",
+        "weight": 1
+      }
+    ]
+  },
+  "message": "0",
+  "ttl": 1
+}
+```
+</details>
+
+<!-- Generated by json-apidoc-gen @ 2025-05-01T00:21:48.81113265Z -->