parent
53e79c6f6d
commit
f9d238b0be
@ -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)
|
||||
|
||||
81
docs/dynamic/banner.md
Normal file
81
docs/dynamic/banner.md
Normal file
@ -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'
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>查看响应示例:</summary>
|
||||
|
||||
```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
|
||||
}
|
||||
```
|
||||
</details>
|
||||
|
||||
<!-- Generated by json-apidoc-gen @ 2025-05-01T00:21:48.81113265Z -->
|
||||
Loading…
Reference in New Issue
Block a user