import{_ as t,c as n,a,o as l}from"./app-Dgsdh8A6.js";const e={};function o(p,s){return l(),n("div",null,s[0]||(s[0]=[a(`

首页公告栏

动态首页公告栏 (新版)

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

`,26)]))}const r=t(e,[["render",o]]),i=JSON.parse('{"path":"/docs/dynamic/banner.html","title":"首页公告栏","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1746060344000,"contributors":[{"name":"SessionHu","username":"SessionHu","email":"102411014+SessionHu@users.noreply.github.com","commits":2,"url":"https://github.com/SessionHu"}],"changelog":[{"hash":"8c6bb6be92e88f285b73f0d0b3f4f5831196c062","time":1746060344000,"email":"102411014+SessionHu@users.noreply.github.com","author":"SessionHu","message":"feat: 动态首页公告栏 (旧版)"},{"hash":"f9d238b0be29ff95f7584e58967afa007f8d6d6f","time":1746059860000,"email":"102411014+SessionHu@users.noreply.github.com","author":"SessionHu","message":"feat: 动态首页公告栏 (新版)"}]},"filePathRelative":"docs/dynamic/banner.md"}');export{r as comp,i as data};