diff --git a/README.md b/README.md index f3dc19f..023546a 100644 --- a/README.md +++ b/README.md @@ -176,6 +176,7 @@ B站 API 采用 C/S 结构,大多数接口为 REST API 和 gRPC,少部分接 - [x] [特定话题动态列表](docs/dynamic/tag_dynamics.md) - [ ] [动态内容](docs/dynamic/get_dynamic_detail.md) - [ ] [导航栏动态](docs/dynamic/nav.md) + - [ ] [首页公告栏](docs/dynamic/banner.md) - [ ] [创作中心](docs/creativecenter) - [ ] [投稿](docs/creativecenter/upload.md) - [ ] [统计与数据](docs/creativecenter/statistics&data.md) diff --git a/docs/dynamic/banner.md b/docs/dynamic/banner.md new file mode 100644 index 0000000..d160928 --- /dev/null +++ b/docs/dynamic/banner.md @@ -0,0 +1,81 @@ +# 首页公告栏 + +## 动态首页公告栏 (新版) + +> 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 | 权重 | | + +**示例:** + +```shell +curl 'https://api.bilibili.com/x/dynamic/feed/dyn/banner?platform=1&position=web动态&web_location=333.1365' +``` + +
+查看响应示例: + +```json +{ + "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 +} +``` +
+ +