对于图片(广告) API 的一些修复 (#381)

* 新增客户端图片(广告) API

* new: 添加了参数注释

* Update

* Update docs

* 修复了一些新增文稿的错误
This commit is contained in:
Nemo2011 2022-06-02 15:32:33 +08:00 committed by GitHub
parent f26768435b
commit 7639bc3d52
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 29 additions and 5 deletions

View File

@ -85,7 +85,10 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
<details>
<summary>查看响应示例:</summary>
<<<<<<< HEAD
=======
<!--
>>>>>>> d4f20b5a37730a3665341ec41a48b333bd133ac0
```json
{
"code": 0,
@ -149,6 +152,10 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
*请求方式: GET*
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
<<<<<<< HEAD
| - | - | - | - | - |
=======
>>>>>>> d4f20b5a37730a3665341ec41a48b333bd133ac0
| build | int | 客户端内部版本号 | 必要 | |
| mobi_app | str | android, iphone, ipad | 必要 | |
| platform | str | android, ios | 必要 | |
@ -168,6 +175,10 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
`data` 字段:
| 字段 | 类型 | 内容 | 备注 |
<<<<<<< HEAD
| - | - | - | - |
=======
>>>>>>> d4f20b5a37730a3665341ec41a48b333bd133ac0
| splash_request_id | str | 不知道 | |
| max_time | int | 最长显示时间? | |
| min_interval | int | 最少显示时间? | 千分之一秒单位 |
@ -177,13 +188,14 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
`list` 中的对象 ~~(不得不说 bilibili 的广告准备真精良)~~
| 字段 | 类型 | 内容 | 备注 |
| - | - | - | - |
| id | int | 不知道 | |
| type | int | 不知道 | |
| card_type | int | 不知道 | |
| duration | int | 持续时间? | |
| begin_time | int | 开始时间? | 时间戳 |
| end_time | int | 停止时间? | 时间戳 |
| thumb | url | ![](https: //i0.hdslb.com/bfs/sycp/creative_img/202205/7743233596d9c4addf44289df7f32e3a.jpg) | 内容不用说了吧 |
| thumb | url | 广告图片 | [举个例子](#example) |
| hash | str | 不知道 | |
| logo_url | str | 不知道 | 空的 |
| logo_hash | str | 不知道 | 也是空的 |
@ -207,8 +219,6 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
| interact_distance | int | 暂不明确 | |
| guide_button_list | list | 所有的按钮 | |
~~ 真不知道这种 API 有什么解析的作用。。。~~
**示例:**
```shell
@ -221,7 +231,7 @@ curl -G 'http://app.bilibili.com/x/v2/splash/list' \
--data-urlencode="birth=0101"
```
<details>
<summary>查看响应示例(慎点,广告多的要命,我的 IDE 加载时都卡了,即使缩减了) ~~救命,卡死了~~ </summary>
<summary>点我发现 bilibili 广告的新大陆:</summary>
``` python
# Python 格式的 dict, 将就看一下,提取了 data
@ -454,3 +464,16 @@ dct = {
"splash_request_id": "1653661460572q172a27a3a3q2165",
}
```
</details>
<span id="example">
<details>
<summary>
一张广告图片(慎点)
</summary>
![](https://i0.hdslb.com/bfs/sycp/creative_img/202205/7743233596d9c4addf44289df7f32e3a.jpg)
</details>
</span>

View File

@ -207,11 +207,12 @@ PS所有 rest api 均可使用 https文档中为了统一写作`http`
- [x] [分区当日投稿数](web_widget/zone_upload.md)
- [x] [404 页漫画收集](web_widget/404_manga.md)
- [ ] [APP端组件](APP_widget)
- [x] [开屏图片](APP_widget/splash.md)
- [x] [开屏图片 + 恰饭珍贵录像](APP_widget/splash.md)
- [ ] [个性装扮](garb)
- [x] [APP 主题](garb/skin.md)
- [x] [主题色](garb/color.md)
B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/readlist/rl207146)系列(更新状态:咕咕......~~欢迎关注~~
**--Project_by [社会易姐QwQ](https://space.bilibili.com/293793435)**