mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2025-01-06 09:50:07 +08:00
139 lines
4.7 KiB
Markdown
139 lines
4.7 KiB
Markdown
# APP端开屏图片
|
||
|
||
## 获取APP端开屏图片列表
|
||
|
||
> http://app.bilibili.com/x/v2/splash/brand/list
|
||
|
||
*请求方式：GET*
|
||
|
||
鉴权方式：APP
|
||
|
||
**url参数：**
|
||
|
||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||
| ------ | ---- | ---------- | ----------- | ---- |
|
||
| appkey | str | APP密钥 | APP方式必要 | |
|
||
| ts | num | 当前时间戳 | APP方式必要 | |
|
||
| sign | str | APP签名 | APP方式必要 | |
|
||
|
||
**json回复：**
|
||
|
||
根对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | ---------------------------------------------------- |
|
||
| code | num | 返回值 | 0：成功<br />-3：API校验密匙错误<br />-400：请求错误 |
|
||
| message | str | 错误信息 | 默认为0 |
|
||
| ttl | num | 1 | |
|
||
| data | obj | 信息本体 | |
|
||
|
||
`data`对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------- | ----- | ------------ | ------------ |
|
||
| pull_interval | num | 1800 | 作用尚不明确 |
|
||
| forcibly | bool | false | 作用尚不明确 |
|
||
| rule | str | order | 作用尚不明确 |
|
||
| list | array | 开屏图片列表 | |
|
||
| show | array | 默认显示项 | |
|
||
|
||
`data`中的`list`数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ------------- | ---- |
|
||
| 0 | obj | 开屏图片1 | |
|
||
| n | obj | 开屏图片(n+1) | |
|
||
| …… | obj | …… | …… |
|
||
|
||
`list`数组中的对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------- | ---- | --------------------- | ---- |
|
||
| id | num | 开屏图片ID | |
|
||
| thumb | str | 开屏图片url | |
|
||
| logo_url | str | “bilibili”logo图片url | |
|
||
|
||
`data`中的`show`数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ---------- | ---- |
|
||
| 0 | obj | 套了个娃？ | |
|
||
|
||
`show`数组中的对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----------- | ---- | ---------- | ------------ |
|
||
| id | num | 开屏图片ID | |
|
||
| begin_time | num | 起始时间？ | 时间戳 |
|
||
| end_time | num | 结束时间？ | 时间戳 |
|
||
| probability | num | 0 | 作用尚不明确 |
|
||
| duration | num | 显示时间？ | 单位为毫秒 |
|
||
|
||
**示例：**
|
||
|
||
```shell
|
||
curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
|
||
--data-urlencode 'appkey=1d8b6e7d45233436' \
|
||
--data-urlencode 'ts=0' \
|
||
--data-urlencode 'sign=78a89e153cd6231a4a4d55013aa063ce'
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例：</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "0",
|
||
"ttl": 1,
|
||
"data": {
|
||
"pull_interval": 1800,
|
||
"forcibly": false,
|
||
"rule": "order",
|
||
"list": [
|
||
{
|
||
"id": 10,
|
||
"thumb": "http://i0.hdslb.com/bfs/archive/e2d2f57e08b511d1a47203859f7bddb4ef9d4e16.png",
|
||
"logo_url": "http://i0.hdslb.com/bfs/archive/ecc9b29bb4b803daf2a46fe5ef71bf530300162c.png"
|
||
},
|
||
{
|
||
"id": 11,
|
||
"thumb": "http://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png",
|
||
"logo_url": "http://i0.hdslb.com/bfs/archive/ecc9b29bb4b803daf2a46fe5ef71bf530300162c.png"
|
||
},
|
||
{
|
||
"id": 12,
|
||
"thumb": "http://i0.hdslb.com/bfs/archive/574469a4a20f41ba4dc9ecd41d15f94eea875ed9.png",
|
||
"logo_url": "http://i0.hdslb.com/bfs/archive/ecc9b29bb4b803daf2a46fe5ef71bf530300162c.png"
|
||
},
|
||
{
|
||
"id": 13,
|
||
"thumb": "http://i0.hdslb.com/bfs/archive/af0f4f611faa34340bd4f91def1973ccbfb8fbb3.png",
|
||
"logo_url": "http://i0.hdslb.com/bfs/archive/ecc9b29bb4b803daf2a46fe5ef71bf530300162c.png"
|
||
},
|
||
{
|
||
"id": 14,
|
||
"thumb": "http://i0.hdslb.com/bfs/archive/1d40e975b09d5c87b11b3ae0c9ce6c6b82f63d9e.png",
|
||
"logo_url": "http://i0.hdslb.com/bfs/archive/ecc9b29bb4b803daf2a46fe5ef71bf530300162c.png"
|
||
}
|
||
],
|
||
"show": [
|
||
{
|
||
"id": 12,
|
||
"begin_time": 1597564800,
|
||
"end_time": 1630753108,
|
||
"probability": 0,
|
||
"duration": 700
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|
||
|
||
如ID=11的图片为：
|
||
|
||
|
||
|