bilibili-API-collect/APP_widget/splash.md

4.7 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'
查看响应示例:
{
    "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
            }
        ]
    }
}

如id=11的图片为