* feat: 添加各分区轮播图与封面主色调获取API

* fix: 删除新增的主色调API代码，导向至图片格式化

2025-08-06 20:09:43 +08:00

4.0 KiB

Raw Blame History

横幅轮播图

获取各分区的轮播图_web端

https://api.bilibili.com/x/web-show/region/banner

请求方式: GET

需要请求头参数 User-Agent

鉴权方式：Wbi 签名 (可选)

URL参数:

字段	类型	内容	必要性	备注
region_id	num	目标分区id	必要	参见视频分区一览v2
w_rid	str	Wbi 签名	非必要	详见 Wbi 签名
wts	num	当前时间戳	非必要	详见 Wbi 签名

JSON回复:

根对象:

字段	类型	内容	备注
code	num	返回值	0: 成功
message	str	错误信息	默认为 0
ttl	str	1
data	obj	信息本体

data 对象:

字段	类型	内容	备注
region_banner_list	array	存储轮播图的对象

data 对象里的 region_banner_list 数组:

项	类型	内容
0	obj	第一个轮播图对象
n	obj	第 (n+1) 轮播图对象
……	obj	……

region_banner_list 数组里的对象:

字段	类型	内容	备注
image	str	封面资源路径
title	str	封面标题
sub_title	str	封面子标题	空
url	str	点击封面后指向的链接	可能为视频地址，也有可能是活动地址
rid	num	分区参见视频分区一览v2

示例:

获取 音乐区 时刻为 Wed, 06 Aug 2025 01:41:35 GMT 的 B 站轮播图音乐区地址

curl -G "https://api.bilibili.com/x/web-show/region/banner" \
      --data-urlencode "region_id=1003" \
      -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko Chrome/58.0.3029.110 Safari/537.36"

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "region_banner_list": [
      {
        "image": "http://i0.hdslb.com/bfs/app/61e4bf3bba74f7d975342ae9d6ec7b0a2ea7c83f.jpg",
        "title": "舞力全开派对首测共创活动上线啦！",
        "sub_title": "",
        "url": "https://www.bilibili.com/blackboard/era/wzjckpevcdCgf4Rv.html",
        "rid": 1003
      },
      {
        "image": "http://i0.hdslb.com/bfs/app/a7d63dc78d10f769bd80c6c27ba6cc337b00d9d9.jpg",
        "title": "玛莎拉达带着他的一系列爆款术曲来了！",
        "sub_title": "",
        "url": "https://www.bilibili.com/video/BV1Tbtjz1Ehv",
        "rid": 1003
      },
      {
        "image": "http://i0.hdslb.com/bfs/app/01beb60c493f98eea6844cc2efcbde7315ce6224.jpg",
        "title": "陶喆Alin合作曲MV首播！",
        "sub_title": "",
        "url": "https://www.bilibili.com/video/BV1w1tnznEMw/?spm_id_from=333.337.search-card.all.click",
        "rid": 1003
      },
      {
        "image": "http://i0.hdslb.com/bfs/app/64060527172b03292b860e43532ff56faabdbe2d.jpg",
        "title": "四种语言版《AMANI》：愿世界和平",
        "sub_title": "",
        "url": "https://www.bilibili.com/video/BV1WTgVzHE2S/",
        "rid": 1003
      },
      {
        "image": "http://i0.hdslb.com/bfs/app/cbc4469b10c041702c49e847552301afeea323cd.jpg",
        "title": "孙亦航来B站啦！",
        "sub_title": "",
        "url": "https://www.bilibili.com/video/BV1RHtFzLEUA",
        "rid": 1003
      },
      {
        "image": "http://i0.hdslb.com/bfs/app/134cede692acbbe3080dc2a2ecc920db1f4f7498.jpg",
        "title": "潘玮柏狂爱《Yes I Do》",
        "sub_title": "",
        "url": "https://www.bilibili.com/video/BV1RAtcz7EJX/?spm_id_from=333.337.search-card.all.click",
        "rid": 1003
      }
    ]
  }
}

Tip: 可以使用图片格式化中获取主色调的方式获取轮播图封面的主色调

4.0 KiB Raw Blame History Unescape Escape

横幅轮播图

获取各分区的轮播图_web端

4.0 KiB

Raw Blame History