|
| 1 | +# 横幅轮播图 |
| 2 | + |
| 3 | +## 获取各分区的轮播图_web端 |
| 4 | + |
| 5 | +> https://api.bilibili.com/x/web-show/region/banner |
| 6 | +
|
| 7 | +*请求方式: GET* |
| 8 | + |
| 9 | +需要请求头参数 User-Agent |
| 10 | + |
| 11 | +鉴权方式:Wbi 签名 (可选) |
| 12 | + |
| 13 | +**URL参数:** |
| 14 | + |
| 15 | +| 字段 | 类型 | 内容 | 必要性 | 备注 | |
| 16 | +| ------- | ---- | -------- | ------- | -------------- | |
| 17 | +| region_id | num | 目标分区id | 必要 | 参见[视频分区一览v2](../video/video_zone_v2.md) | |
| 18 | +| w_rid | str | Wbi 签名 | 非必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) | |
| 19 | +| wts | num | 当前时间戳 | 非必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) | |
| 20 | + |
| 21 | +**JSON回复:** |
| 22 | + |
| 23 | +根对象: |
| 24 | + |
| 25 | +| 字段 | 类型 | 内容 | 备注 | |
| 26 | +| -- | -- | -- | -- | |
| 27 | +| code | num | 返回值 | 0: 成功 | |
| 28 | +| message | str | 错误信息 | 默认为 0 | |
| 29 | +| ttl | str | 1 | | |
| 30 | +| data | obj | 信息本体 | | |
| 31 | + |
| 32 | +`data` 对象: |
| 33 | + |
| 34 | +| 字段 | 类型 | 内容 | 备注 | |
| 35 | +| -- | -- | -- | -- | |
| 36 | +| region_banner_list | array | 存储轮播图的对象 | | |
| 37 | + |
| 38 | +`data` 对象里的 `region_banner_list` 数组: |
| 39 | + |
| 40 | +| 项 | 类型 | 内容 | 备注 | |
| 41 | +| -- | -- | -- | -- | |
| 42 | +| 0 | obj | 第一个轮播图对象 | | |
| 43 | +| n | obj | 第 (n+1) 轮播图对象 | | |
| 44 | +| …… | obj | …… | | |
| 45 | + |
| 46 | +`region_banner_list` 数组里的对象: |
| 47 | + |
| 48 | +| 字段 | 类型 | 内容 | 备注 | |
| 49 | +| -- | -- | -- | -- | |
| 50 | +| image | str | 封面资源路径 | | |
| 51 | +| title | str | 封面标题 | | |
| 52 | +| sub_title | str | 封面子标题 | 空 | |
| 53 | +| url | str | 点击封面后指向的链接 | 可能为视频地址,也有可能是活动地址 | |
| 54 | +| rid | num | 分区参见[视频分区一览v2](../video/video_zone_v2.md) | | |
| 55 | + |
| 56 | +**示例:** |
| 57 | + |
| 58 | +获取 `音乐区` 时刻为 `Wed, 06 Aug 2025 01:41:35 GMT` 的 B 站轮播图 [音乐区地址](https://www.bilibili.com/c/music/) |
| 59 | + |
| 60 | +```shell |
| 61 | +curl -G "https://api.bilibili.com/x/web-show/region/banner" \ |
| 62 | + --data-urlencode "region_id=1003" \ |
| 63 | + -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" |
| 64 | +``` |
| 65 | + |
| 66 | +<details> |
| 67 | +<summary>查看响应示例:</summary> |
| 68 | + |
| 69 | +```json |
| 70 | +{ |
| 71 | + "code": 0, |
| 72 | + "message": "0", |
| 73 | + "ttl": 1, |
| 74 | + "data": { |
| 75 | + "region_banner_list": [ |
| 76 | + { |
| 77 | + "image": "http://i0.hdslb.com/bfs/app/61e4bf3bba74f7d975342ae9d6ec7b0a2ea7c83f.jpg", |
| 78 | + "title": "舞力全开派对首测共创活动上线啦!", |
| 79 | + "sub_title": "", |
| 80 | + "url": "https://www.bilibili.com/blackboard/era/wzjckpevcdCgf4Rv.html", |
| 81 | + "rid": 1003 |
| 82 | + }, |
| 83 | + { |
| 84 | + "image": "http://i0.hdslb.com/bfs/app/a7d63dc78d10f769bd80c6c27ba6cc337b00d9d9.jpg", |
| 85 | + "title": "玛莎拉达带着他的一系列爆款术曲来了!", |
| 86 | + "sub_title": "", |
| 87 | + "url": "https://www.bilibili.com/video/BV1Tbtjz1Ehv", |
| 88 | + "rid": 1003 |
| 89 | + }, |
| 90 | + { |
| 91 | + "image": "http://i0.hdslb.com/bfs/app/01beb60c493f98eea6844cc2efcbde7315ce6224.jpg", |
| 92 | + "title": "陶喆Alin合作曲MV首播!", |
| 93 | + "sub_title": "", |
| 94 | + "url": "https://www.bilibili.com/video/BV1w1tnznEMw/?spm_id_from=333.337.search-card.all.click", |
| 95 | + "rid": 1003 |
| 96 | + }, |
| 97 | + { |
| 98 | + "image": "http://i0.hdslb.com/bfs/app/64060527172b03292b860e43532ff56faabdbe2d.jpg", |
| 99 | + "title": "四种语言版《AMANI》:愿世界和平", |
| 100 | + "sub_title": "", |
| 101 | + "url": "https://www.bilibili.com/video/BV1WTgVzHE2S/", |
| 102 | + "rid": 1003 |
| 103 | + }, |
| 104 | + { |
| 105 | + "image": "http://i0.hdslb.com/bfs/app/cbc4469b10c041702c49e847552301afeea323cd.jpg", |
| 106 | + "title": "孙亦航来B站啦!", |
| 107 | + "sub_title": "", |
| 108 | + "url": "https://www.bilibili.com/video/BV1RHtFzLEUA", |
| 109 | + "rid": 1003 |
| 110 | + }, |
| 111 | + { |
| 112 | + "image": "http://i0.hdslb.com/bfs/app/134cede692acbbe3080dc2a2ecc920db1f4f7498.jpg", |
| 113 | + "title": "潘玮柏狂爱《Yes I Do》", |
| 114 | + "sub_title": "", |
| 115 | + "url": "https://www.bilibili.com/video/BV1RAtcz7EJX/?spm_id_from=333.337.search-card.all.click", |
| 116 | + "rid": 1003 |
| 117 | + } |
| 118 | + ] |
| 119 | + } |
| 120 | +} |
| 121 | +``` |
| 122 | +</details> |
| 123 | + |
| 124 | +* Tip: 可以使用 [图片格式化](../misc/picture.md)中 获取主色调的方式获取轮播图封面的主色调 |
0 commit comments