Skip to content

Latest commit

 

History

History
567 lines (521 loc) · 26.2 KB

splash.md

File metadata and controls

567 lines (521 loc) · 26.2 KB
Raw

APP端开屏图片

获取APP端开屏图片列表

https://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：成功
-3：API校验密匙错误
-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 'https://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的图片为：

获取APP端开屏幕广告信息

https://app.bilibili.com/x/v2/splash/list

请求方式: GET

参数名 类型 内容 必要性 备注
build int 客户端内部版本号 必要
mobi_app str android, iphone, ipad 必要
platform str android, ios 必要
height int 屏幕高度 必要
width int 屏幕宽度 必要
birth str 生日日期(四位数，例 0101) 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-3：API校验密匙错误
-400：请求错误
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象：

字段 类型 内容 备注
splash_request_id 当前请求id 长度为33, 前13位是当前秒级时间戳
max_time int 最长显示时间？
min_interval int 最少显示时间？ 千分之一秒单位
pull_interval int 显示时间？
keep_ids int 显示时间？
list list 广告 list

list数组中的对象：

字段 类型 内容 备注
id int 广告id
type int 1
card_type int 39
duration int 持续时间？
begin_time int 开始展示时间 秒级时间戳
end_time int 停止展示时间 毫秒级时间戳
thumb url 广告图片
hash str 作用尚不明确
logo_url str 空值
logo_hash str 空值
skip int 是否跳转？
uri str 跳转的url
video_url str 视频url
video_hash str 视频hash
video_width num 视频宽度
video_height num 视频高度
uri_title str 空值
source int 929
cm_mark int 1
ad_cb str 作用尚不明确
resource_id int 926
request_id str 作用尚不明确
client_ip str 客户端IP
is_ad bool 作用尚不明确
is_ad_loc bool 作用尚不明确
schema_title str 滑动进入第三方应用
schema_callup_white_list array 跳转的 APP 的白名单
extra obj 显示信息？
enable_pre_download bool 是否可以当场下载 APP?
enable_background_download bool 是否可以静默下载 APP?
interact_type int 是否可以跳转(互动)？
interact_url str 跳转(互动) url
interact_distance int 作用尚不明确
guide_button_list array 所有的按钮
mark_with_skip_style num 作用尚不明确
skip_button_height num 作用尚不明确

extra对象：

字段 类型 内容 备注
use_ad_web_v2 bool
show_urls array
click_urls array
show_1s_urls array
download_whitelist array
open_whitelist array
card obj
report_time num
sales_type num
special_industry bool
preload_landingpage num
share_info obj
upzone_entrance_type num
upzone_entrance_report_id num
topview_pic_url str
topview_video_url str
click_area num
shop_id num
up_mid num
track_id str
enable_store_direct_launch int
enable_double_jump bool
store_callup_card bool
enable_h5_alert bool
special_industry_style num
macro_replace_priority num
feedback_panel_style num
ad_content_type num
enable_h5_pre_load num
hot_activity_id num
product_id num
landingpage_download_style num

guide_button_list 中的对象：

字段 类型 内容 备注
id int
x int
y int
bg_color str
bg_color_night str
text_color str
text_color_night str
guide_instructions str
guide_instructions_new str 空值
width str
jump_url str
schema_package_name str
schema_title str
schema_title_new str 空值
height str
slide_threshold_value str
slide_border_color str
guide_image_url str
guide_image_md5 str
interact_style str
jump_image_url str
jump_image_md5 str
schema_image_url str
schema_image_md5 str
click_expand_ratio str
logo_image_url str
logo_image_md5 str
related_ids array 空
schema_list array 空
font_ratio num
seq num
degrade_type num
twist_angle num
twist_speed num
secondary_guide_instructions str
secondary_font_ratio num
secondary_text_color str
secondary_text_color_night str
activity_time num 秒级时间戳
time_show_type num

示例：

curl -X GET 'https://app.bilibili.com/x/v2/splash/list' \
    --data-urlencode 'build=999999999' \
    --data-urlencode 'mobi_app=android' \
    --data-urlencode 'platform=android' \
    --data-urlencode 'height=1920' \
    --data-urlencode 'width=1080' \
    --data-urlencode 'birth=0101'
查看响应示例： 
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "max_time": 4,
        "min_interval": 14400,
        "pull_interval": 900,
        "keep_ids": null,
        "list": [
            {
                "id": 9460,
                "type": 1,
                "card_type": 39,
                "duration": 5,
                "begin_time": 1663689600,
                "end_time": 1663775999,
                "thumb": "https://i0.hdslb.com/bfs/sycp/creative_img/202208/cb001c291c6011940e29531dcce6b1e8.webp",
                "hash": "712d3df973f99fdcd30c2419d19630dc",
                "logo_url": "",
                "logo_hash": "",
                "skip": 1,
                "uri": "https://market.m.taobao.com/app/mwdk-industry/mwdk-shopping-base/pages/peppa.html?disableNav=YES&merchantCode=HM&pageId=105240&path=%2Fact%2Frax%2Fmanual1455861656935693595&renderChannelCode=HM&siteCode=HM_8_7dd8299642994fa196f9a9aae4fd4391_3&spma=a225z&usePayment=alipayMiniApp&utm_campaign=dwlx&utm_source=1234&targetShopId=199273419",
                "video_url": "http://upos-sz-static.bilivideo.com/ssaxcode/89/jl/n220831a21uql976d44zun4y0ykmjl89-1-SPLASH.mp4",
                "video_hash": "ae10333c160452cc2755d079db10b597",
                "video_width": 1080,
                "video_height": 1920,
                "uri_title": "",
                "source": 929,
                "cm_mark": 1,
                "ad_cb": "COfrARC7jxUY9EkgADDWwCE4oQdCIDE2NjM2NDY2MzY1ODhxMTcyYTI2YTE5MmE5NnE1NDE0SKy0xMi1MFIG5aSp5rSlaP///////////wFw////////////AYABS4gB5+sBsgEg8mQFw0bBxGOGYE8OBhMOd3DE8OGFZXhookrFX4s3UrrwAruPFdgD9Ek=",
                "resource_id": 926,
                "request_id": "1663646636588q172a26a192a96q5414",
                "client_ip": "117.14.146.37",
                "is_ad": true,
                "is_ad_loc": true,
                "schema_title": "滑动进入第三方应用",
                "schema_callup_white_list": [
                    "tmall",
                    "taobao",
                    "openapp.jdmobile",
                    "weixin",
                    "alipays",
                    "tbopen",
                    "eleme",
                    "qqmusic",
                    "pddopen",
                    "upwallet",
                    "yocial://plaza/?tab=0",
                    "hiapplink",
                    "meiju",
                    "midea-meiju",
                    "uclink",
                    "qklink",
                    "taobaolite",
                    "lazyaudio",
                    "meituanwaimai",
                    "baiduboxapp://",
                    "baiduboxapp",
                    "fleamarket",
                    "dewuapp",
                    "duappmoblink",
                    "cmblife",
                    "imeituan",
                    "vmall",
                    "music",
                    "pinduoduo"
                ],
                "extra": {
                    "use_ad_web_v2": true,
                    "show_urls": [
                        "https://g.cn.miaozhen.com/x/k=2315612&p=8EUuC&dx=__IPDX__&rt=2&pro=s&ns=__IP__&ni=__IESID__&v=__LOC__&xa=__ADPLATFORM__&tr=__REQUESTID__&vg=__AUTOPLAY__&nh=__AUTOREFRESH__&mo=__OS__&m0=__OPENUDID__&m0a=__DUID__&m1=__ANDROIDID1__&m1a=__ANDROIDID__&m2=__IMEI__&m4=__AAID__&m5=__IDFA__&m6=__MAC1__&m6a=__MAC__&m11=__OAID__&m14=__CAID__&m5a=__IDFV__&mn=__ANAME__&m5b=__IDFA1__&m11a=__OAID1__&m14a=__CAID1__&o="
                    ],
                    "click_urls": [
                        "https://e.cn.miaozhen.com/r/k=2315612&p=8EUuC&dx=__IPDX__&rt=2&pro=s&ns=__IP__&ni=__IESID__&v=__LOC__&xa=__ADPLATFORM__&tr=__REQUESTID__&mo=__OS__&m0=__OPENUDID__&m0a=__DUID__&m1=__ANDROIDID1__&m1a=__ANDROIDID__&m2=__IMEI__&m4=__AAID__&m5=__IDFA__&m6=__MAC1__&m6a=__MAC__&m11=__OAID__&m14=__CAID__&m5a=__IDFV__&mn=__ANAME__&m5b=__IDFA1__&m11a=__OAID1__&m14a=__CAID1__&o="
                    ],
                    "show_1s_urls": [],
                    "download_whitelist": [],
                    "open_whitelist": [
                        "tmall",
                        "taobao",
                        "openapp.jdmobile",
                        "weixin",
                        "alipays",
                        "tbopen",
                        "eleme",
                        "qqmusic",
                        "pddopen",
                        "upwallet",
                        "yocial://plaza/?tab=0",
                        "hiapplink",
                        "meiju",
                        "midea-meiju",
                        "uclink",
                        "qklink",
                        "taobaolite",
                        "lazyaudio",
                        "meituanwaimai",
                        "baiduboxapp://",
                        "baiduboxapp",
                        "fleamarket",
                        "dewuapp",
                        "duappmoblink",
                        "cmblife",
                        "imeituan",
                        "vmall",
                        "music",
                        "pinduoduo"
                    ],
                    "card": {
                        "card_type": 0,
                        "extreme_team_status": false,
                        "support_transition": false,
                        "under_player_interaction_style": 0,
                        "grade_denominator": 0,
                        "star_level": 0,
                        "live_booking_population_threshold": 0,
                        "ori_mark_hidden": 0,
                        "use_multi_cover": false,
                        "fold_time": 0,
                        "live_room_popularity": 0,
                        "live_tag_show": false,
                        "grade_level": 0
                    },
                    "report_time": 0,
                    "sales_type": 75,
                    "special_industry": false,
                    "preload_landingpage": 0,
                    "share_info": {},
                    "upzone_entrance_type": 0,
                    "upzone_entrance_report_id": 0,
                    "topview_pic_url": "",
                    "topview_video_url": "",
                    "click_area": 0,
                    "shop_id": 0,
                    "up_mid": 0,
                    "track_id": "pbaes.Y5ATuPVlG6ysPF6cvl6W8B-BYexhSJzrKH3NYfC3KIHDb9W5cxPA4_FTEPWYDED5DjfRwb3tcrLppYAqQ87SSg==",
                    "enable_store_direct_launch": 0,
                    "enable_double_jump": false,
                    "store_callup_card": false,
                    "enable_h5_alert": false,
                    "special_industry_style": 0,
                    "macro_replace_priority": 1,
                    "feedback_panel_style": 0,
                    "ad_content_type": 0,
                    "enable_h5_pre_load": 0,
                    "hot_activity_id": 0,
                    "product_id": 0,
                    "landingpage_download_style": 2
                },
                "enable_pre_download": true,
                "enable_background_download": true,
                "interact_type": 1,
                "interact_url": "https://market.m.taobao.com/app/mwdk-industry/mwdk-shopping-base/pages/peppa.html?disableNav=YES&merchantCode=HM&pageId=105240&path=%2Fact%2Frax%2Fmanual1455861656935693595&renderChannelCode=HM&siteCode=HM_8_7dd8299642994fa196f9a9aae4fd4391_3&spma=a225z&usePayment=alipayMiniApp&utm_campaign=dwlx&utm_source=1234&targetShopId=199273419",
                "interact_distance": 60,
                "guide_button_list": [
                    {
                        "id": 49037,
                        "x": 50,
                        "y": 78,
                        "bg_color": "#80000000",
                        "bg_color_night": "#80000000",
                        "text_color": "#FFFFFFFF",
                        "text_color_night": "#FFFFFFFF",
                        "guide_instructions": "点击进入活动页",
                        "guide_instructions_new": "",
                        "width": 70,
                        "jump_url": "https://market.m.taobao.com/app/mwdk-industry/mwdk-shopping-base/pages/peppa.html?disableNav=YES&merchantCode=HM&pageId=105240&path=%2Fact%2Frax%2Fmanual1455861656935693595&renderChannelCode=HM&siteCode=HM_8_7dd8299642994fa196f9a9aae4fd4391_3&spma=a225z&usePayment=alipayMiniApp&utm_campaign=dwlx&utm_source=1234&targetShopId=199273419",
                        "schema_package_name": "",
                        "schema_title": "",
                        "schema_title_new": "",
                        "height": 7,
                        "slide_threshold_value": 5,
                        "slide_border_color": "#40FFFFFF",
                        "guide_image_url": "",
                        "guide_image_md5": "",
                        "interact_style": 6,
                        "jump_image_url": "https://i0.hdslb.com/bfs/sycp/creative_img/202208/f61a66cf54bc71d9bd1b81bde79c0140.json",
                        "jump_image_md5": "26d8b4b516f83a3f9b15fef643464cc6",
                        "schema_image_url": "https://i0.hdslb.com/bfs/sycp/creative_img/202208/f61a66cf54bc71d9bd1b81bde79c0140.json",
                        "schema_image_md5": "26d8b4b516f83a3f9b15fef643464cc6",
                        "click_expand_ratio": 100,
                        "logo_image_url": "https://i0.hdslb.com/bfs/sycp/mgk/img/202106/17006d50ec506813727b1cb5c6fc58b1.png",
                        "logo_image_md5": "86bc1b68ce4708d918cd4e01a975ca17",
                        "related_ids": [],
                        "schema_list": [],
                        "font_ratio": 0.23,
                        "seq": 0,
                        "degrade_type": 1,
                        "twist_angle": 0,
                        "twist_speed": -1,
                        "secondary_guide_instructions": "",
                        "secondary_font_ratio": 0,
                        "secondary_text_color": "",
                        "secondary_text_color_night": "",
                        "activity_time": 1662532059,
                        "time_show_type": 0
                    },
                    {
                        "id": 49040,
                        "x": 50,
                        "y": 83,
                        "bg_color": "#80000000",
                        "bg_color_night": "#80000000",
                        "text_color": "#FFFFFFFF",
                        "text_color_night": "#FFFFFFFF",
                        "guide_instructions": "即可前往 开吃新品",
                        "guide_instructions_new": "",
                        "width": 64,
                        "jump_url": "https://market.m.taobao.com/app/mwdk-industry/mwdk-shopping-base/pages/peppa.html?disableNav=YES&merchantCode=HM&pageId=105240&path=%2Fact%2Frax%2Fmanual1455861656935693595&renderChannelCode=HM&siteCode=HM_8_7dd8299642994fa196f9a9aae4fd4391_3&spma=a225z&usePayment=alipayMiniApp&utm_campaign=dwlx&utm_source=1234&targetShopId=199273419",
                        "schema_package_name": "",
                        "schema_title": "滑动进入第三方应用",
                        "schema_title_new": "",
                        "height": 3,
                        "slide_threshold_value": 5,
                        "slide_border_color": "#40FFFFFF",
                        "guide_image_url": "",
                        "guide_image_md5": "",
                        "interact_style": 3,
                        "jump_image_url": "https://i0.hdslb.com/bfs/sycp/creative_img/202208/f61a66cf54bc71d9bd1b81bde79c0140.json",
                        "jump_image_md5": "26d8b4b516f83a3f9b15fef643464cc6",
                        "schema_image_url": "https://i0.hdslb.com/bfs/sycp/creative_img/202208/f61a66cf54bc71d9bd1b81bde79c0140.json",
                        "schema_image_md5": "26d8b4b516f83a3f9b15fef643464cc6",
                        "click_expand_ratio": 100,
                        "logo_image_url": "https://i0.hdslb.com/bfs/sycp/mgk/img/202106/17006d50ec506813727b1cb5c6fc58b1.png",
                        "logo_image_md5": "86bc1b68ce4708d918cd4e01a975ca17",
                        "related_ids": [
                            49037
                        ],
                        "schema_list": [],
                        "font_ratio": 0.23,
                        "seq": 99,
                        "degrade_type": 0,
                        "twist_angle": 0,
                        "twist_speed": -1,
                        "secondary_guide_instructions": "",
                        "secondary_font_ratio": 0,
                        "secondary_text_color": "",
                        "secondary_text_color_night": "",
                        "activity_time": 1662532059,
                        "time_show_type": 0
                    }
                ],
                "mark_with_skip_style": 0,
                "skip_button_height": 0.0557
            }
        ],
        "splash_request_id": "1663646636605q172a24a57a232q5796"
    }
}