bilibili-API-collect/docs/dynamic/banner.md
2025-05-01 08:45:44 +08:00

3.2 KiB

首页公告栏

动态首页公告栏 (新版)

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