bilibili-API-collect/APP_widget/splash.md
Nemo2011 d4f20b5a37
新增客户端图片(广告) API (#378)
* 新增客户端图片(广告) API

* new: 添加了参数注释

* Update
2022-05-28 13:36:26 +08:00

19 KiB
Raw Blame History

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成功
-3API校验密匙错误
-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 显示时间? 单位为毫秒

示例:

curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
--data-urlencode 'appkey=1d8b6e7d45233436' \
--data-urlencode 'ts=0' \
--data-urlencode 'sign=78a89e153cd6231a4a4d55013aa063ce'
查看响应示例: