# 首页公告栏

## 动态首页公告栏 (新版)

> 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 -->

## 动态首页公告栏 (旧版)

> https://api.vc.bilibili.com/banner_svr/v1/banner_svr/show


*请求方法: GET*

**URL 参数:**

| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---- | ------ | ---- |
| platform | number | 平台? | 不必要 | 默认为 `1`  |
| position | string | 位置? | 不必要 | 默认为 `web动态` |

**JSON 回复:**

与 [动态首页公告栏 (新版)](#动态首页公告栏-新版) 相同, 除了少了个 `data.banners[].banner_id`

**示例:**

```shell
curl 'https://api.vc.bilibili.com/banner_svr/v1/banner_svr/show'
```

<details>
<summary>查看响应示例:</summary>

```json
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "banners": [
      {
        "img_url": "https://i0.hdslb.com/bfs/vc/9c699f2acbcad00197e92c401b835d2c6aba8a55.png",
        "title": "点击进入",
        "link": "https://www.bilibili.com/blackboard/activity-5zJxM3spoS.html",
        "platform": 1,
        "weight": 1,
        "position": "web动态",
        "start_time": 1582862523,
        "end_time": 2056204800
      }
    ]
  }
}
```

</details>
