# 首页公告栏 | BAC Document
社区开源的第三方哔哩哔哩 API 文档

# 首页公告栏

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

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

示例:

    curl 'https://api.bilibili.com/x/dynamic/feed/dyn/banner?platform=1&position=web动态&web_location=333.1365'

查看响应示例:

    {
      "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
    }

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

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

请求方法: GET

URL 参数:

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

JSON 回复:

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

示例:

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

查看响应示例:

    {
      "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
          }
        ]
      }
    }