XFE Git
XFE Studio Git
Git 首页 全局搜索
XFE 主站 文档 NuGet
公开
关注 0 Fork 0 Star 0
返回提交历史

XFEstudio/bilibili-API-collect

新增客户端图片（广告） API (#378)

* 新增客户端图片（广告） API * new: 添加了参数注释 * Update

d4f20b5
Nemo2011 <91071485+Nemo2011@users.noreply.github.com>
提交于
父提交 2a78655

代码差异

2 个文件 +316 -2
Modified APP_widget/splash.md +315 -1
@@ -1,6 +1,7 @@
1 1 # APP端开屏图片
2 2
3 3 - [获取APP端开屏图片列表](#获取APP端开屏图片列表)
4 - [获取其他的 ~~广告~~ 图片](#app-端的-广告-一些图片)
4 5
5 6 ---
6 7
@@ -84,7 +85,7 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
84 85
85 86 <details>
86 87 <summary>查看响应示例：</summary>
87
88 <!--
88 89 ```json
89 90 {
90 91 "code": 0,
@@ -140,3 +141,316 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \
140 141
141 142 ![]( http://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png )
142 143
144
145 ## APP 端的 ~~广告~~ 一些图片
146
147 > https://app.bilibili.com/x/v2/splash/list
148
149 *请求方式: GET*
150
151 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
152 | build | int | 客户端内部版本号 | 必要 | |
153 | mobi_app | str | android, iphone, ipad | 必要 | |
154 | platform | str | android, ios | 必要 | |
155 | height | int | 屏幕高度 | 必要 | |
156 | width | int | 屏幕宽度 | 必要 | |
157 | birth | str | 生日日期(四位数，例 0101) | 必要 | |
158
159 **json 回复**
160
161 | 字段 | 类型 | 内容 | 备注 |
162 | ------- | ---- | -------- | ---------------------------------------------------- |
163 | code | num | 返回值 | 0：成功<br />-3：API校验密匙错误<br />-400：请求错误 |
164 | message | str | 错误信息 | 默认为0 |
165 | ttl | num | 1 | |
166 | data | obj | 信息本体 | |
167
168 `data` 字段：
169
170 | 字段 | 类型 | 内容 | 备注 |
171 | splash_request_id | str | 不知道 | |
172 | max_time | int | 最长显示时间？ | |
173 | min_interval | int | 最少显示时间？ | 千分之一秒单位 |
174 | pull_interval | int | 显示时间？ | |
175 | list | list | 广告 list | |
176
177 `list` 中的对象 ~~(不得不说 bilibili 的广告准备真精良)~~：
178
179 | 字段 | 类型 | 内容 | 备注 |
180 | id | int | 不知道 | |
181 | type | int | 不知道 | |
182 | card_type | int | 不知道 | |
183 | duration | int | 持续时间？ | |
184 | begin_time | int | 开始时间? | 时间戳 |
185 | end_time | int | 停止时间？ | 时间戳 |
186 | thumb | url | ![](https: //i0.hdslb.com/bfs/sycp/creative_img/202205/7743233596d9c4addf44289df7f32e3a.jpg) | 内容不用说了吧 |
187 | hash | str | 不知道 | |
188 | logo_url | str | 不知道 | 空的 |
189 | logo_hash | str | 不知道 | 也是空的 |
190 | skip | int | 是否跳转？ | |
191 | uri | url | 跳转的 url | |
192 | url_title | str | 标题？ | |
193 | source | int | 不知道 | |
194 | cm_mark | int | 不知道 | |
195 | ad_cb | str | 不知道 | |
196 | resource_id | int | 不知道 | |
197 | request_id | str | 不知道 | |
198 | client_ip | ip_v4 | 客户端的 IP？| |
199 | is_ad | bool | 不知道 | |
200 | is_ad_loc | bool | 不知道 | |
201 | schema_callup_white_list | list | 跳转的 APP 的白名单 | |
202 | extra | dict | 显示信息？ | |
203 | enable_pre_download | bool | 是否可以当场下载 APP? | |
204 | enable_background_download | bool | 是否可以静默下载 APP? | |
205 | interact_type| int | 是否可以跳转(互动)？ | |
206 | interact_url | url | 跳转(互动) url | |
207 | interact_distance | int | 暂不明确 | |
208 | guide_button_list | list | 所有的按钮 | |
209
210 ~~ 真不知道这种 API 有什么解析的作用。。。~~
211
212 **示例：**
213
214 ```shell
215 curl -G 'http://app.bilibili.com/x/v2/splash/list' \
216 --data-urlencode="build=999999999" \
217 --data-urlencode="mobi_app=android" \
218 --data-urlencode="platform=android" \
219 --data-urlencode="height=1920" \
220 --data-urlencode="width=1080" \
221 --data-urlencode="birth=0101"
222 ```
223 <details>
224 <summary>查看响应示例(慎点，广告多的要命，我的 IDE 加载时都卡了，即使缩减了) ~~救命，卡死了~~ ：</summary>
225
226 ``` python
227 # Python 格式的 dict, 将就看一下，提取了 data
228 # 已缩减，一共有二十万行，全是广告，醉了
229 dct = {
230 "max_time": 4,
231 "min_interval": 14400,
232 "pull_interval": 900,
233 "list": [
234 {
235 "id": 7473,
236 "type": 1,
237 "card_type": 15,
238 "duration": 3,
239 "begin_time": 1653580800,
240 "end_time": 1653667199,
241 "thumb": "https: //i0.hdslb.com/bfs/sycp/creative_img/202205/7743233596d9c4addf44289df7f32e3a.jpg",
242 "hash": "58d1ffad328fc0dff3653ca4a8d81b9e",
243 "logo_url": "",
244 "logo_hash": "",
245 "skip": 1,
246 "uri": "https://gxb.mmstat.com/gxb.gif?t=https%3A%2F%2Fequity.tmall.com%2Ftm%3FagentId%3D1598070%26bc_fl_src%3Dtmall_market_llb_1_1762697%26llbPlatform%3D_pube%26llbOsd%3D1%26mm_unid%3D1_11094511_560501015e6d5757020607530b6f5353086656040b075e&v=644035c3dbd3&di=__IDFA__&dim=__IMEI__&oaid=__OAID__&bc_fl_src=tmall_market_llb_1_1762697&llbPlatform=_pubu&llbOsd=1&agentId=1598070",
247 "uri_title": "",
248 "source": 929,
249 "cm_mark": 1,
250 "ad_cb": "CM7OARCXzxIYsTogADCo1R04oQdCHzE2NTM2NjE0NjA1NjlxMTcyYTI3YTBhMTcycTE1MzdI2dCdr5AwUgnoi4/lt57luIJo////////////AXD///////////8BgAFLiAHOzgGyASCNv/lsldJA9UcshRdPX0KJuJjnmZZA0Hypp8HytKuiT/ACl88S2AOxOg==",
251 "resource_id": 926,
252 "request_id": "1653661460569q172a27a0a172q1537",
253 "client_ip": "153.34.54.14",
254 "is_ad": True,
255 "is_ad_loc": True,
256 "schema_callup_white_list": [
257 "tmall",
258 "taobao",
259 "openapp.jdmobile",
260 "weixin",
261 "alipays",
262 "tbopen",
263 "eleme",
264 "qqmusic",
265 "upwallet",
266 "yocial://plaza/?tab=0",
267 "hiapplink",
268 "meiju",
269 "midea-meiju",
270 "uclink",
271 "qklink",
272 "taobaolite",
273 "lazyaudio",
274 "meituanwaimai",
275 "baiduboxapp://",
276 "baiduboxapp",
277 "fleamarket",
278 "dewuapp",
279 "duappmoblink",
280 "cmblife",
281 "imeituan",
282 ],
283 "extra": {
284 "use_ad_web_v2": True,
285 "show_urls": [
286 "https://g.cn.miaozhen.com/x/k=2295590&p=89WTd&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="
287 ],
288 "click_urls": [
289 "https://e.cn.miaozhen.com/r/k=2295590&p=89WTd&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="
290 ],
291 "show_1s_urls": [],
292 "download_whitelist": [],
293 "open_whitelist": [
294 "tmall",
295 "taobao",
296 "openapp.jdmobile",
297 "weixin",
298 "alipays",
299 "tbopen",
300 "eleme",
301 "qqmusic",
302 "upwallet",
303 "yocial://plaza/?tab=0",
304 "hiapplink",
305 "meiju",
306 "midea-meiju",
307 "uclink",
308 "qklink",
309 "taobaolite",
310 "lazyaudio",
311 "meituanwaimai",
312 "baiduboxapp://",
313 "baiduboxapp",
314 "fleamarket",
315 "dewuapp",
316 "duappmoblink",
317 "cmblife",
318 "imeituan",
319 ],
320 "card": {
321 "card_type": 0,
322 "extreme_team_status": False,
323 "support_transition": False,
324 "under_player_interaction_style": 0,
325 "grade_denominator": 0,
326 "star_level": 0,
327 "live_booking_population_threshold": 0,
328 "ori_mark_hidden": 0,
329 "use_multi_cover": False,
330 "fold_time": 0,
331 "live_room_popularity": 0,
332 "live_tag_show": False,
333 "grade_level": 0,
334 },
335 "report_time": 0,
336 "sales_type": 75,
337 "special_industry": False,
338 "preload_landingpage": 0,
339 "share_info": {},
340 "upzone_entrance_type": 0,
341 "upzone_entrance_report_id": 0,
342 "topview_pic_url": "",
343 "topview_video_url": "",
344 "click_area": 0,
345 "shop_id": 0,
346 "up_mid": 0,
347 "track_id": "pbaes.usQXCK8mtPyInZ6TlgUE3WT5gMWLU89o3guKCQbmTkJSyJh5c3PfqzA9mo2h6vrYahFNbyuORlKEijmroC2-pw==",
348 "enable_store_direct_launch": 0,
349 "enable_double_jump": False,
350 "store_callup_card": False,
351 "enable_h5_alert": False,
352 "special_industry_style": 0,
353 "macro_replace_priority": 1,
354 "feedback_panel_style": 0,
355 "ad_content_type": 0,
356 "enable_h5_pre_load": 0,
357 "product_id": 0,
358 "landingpage_download_style": 2,
359 },
360 "enable_pre_download": True,
361 "enable_background_download": True,
362 "interact_type": 1,
363 "interact_url": "https://gxb.mmstat.com/gxb.gif?t=https%3A%2F%2Fequity.tmall.com%2Ftm%3FagentId%3D1598070%26bc_fl_src%3Dtmall_market_llb_1_1762697%26llbPlatform%3D_pube%26llbOsd%3D1%26mm_unid%3D1_11094511_560501015e6d5757020607530b6f5353086656040b075e&v=644035c3dbd3&di=__IDFA__&dim=__IMEI__&oaid=__OAID__&bc_fl_src=tmall_market_llb_1_1762697&llbPlatform=_pubu&llbOsd=1&agentId=1598070",
364 "interact_distance": 60,
365 "guide_button_list": [
366 {
367 "id": 24800,
368 "x": 50,
369 "y": 75,
370 "bg_color": "#80000000",
371 "bg_color_night": "#80000000",
372 "text_color": "#FFFFFFFF",
373 "text_color_night": "#FFFFFFFF",
374 "guide_instructions": "滑动畅享索尼醇音",
375 "guide_instructions_new": "",
376 "width": 70,
377 "jump_url": "https://gxb.mmstat.com/gxb.gif?t=https%3A%2F%2Fequity.tmall.com%2Ftm%3FagentId%3D1598070%26bc_fl_src%3Dtmall_market_llb_1_1762697%26llbPlatform%3D_pube%26llbOsd%3D1%26mm_unid%3D1_11094511_560501015e6d5757020607530b6f5353086656040b075e&v=644035c3dbd3&di=__IDFA__&dim=__IMEI__&oaid=__OAID__&bc_fl_src=tmall_market_llb_1_1762697&llbPlatform=_pubu&llbOsd=1&agentId=1598070",
378 "schema": "",
379 "schema_package_name": "",
380 "schema_title": "",
381 "schema_title_new": "",
382 "universal_app": "",
383 "height": 7,
384 "slide_threshold_value": 5,
385 "slide_border_color": "#40FFFFFF",
386 "guide_image_url": "",
387 "guide_image_md5": "",
388 "interact_style": 6,
389 "jump_image_url": "https://i0.hdslb.com/bfs/sycp/creative_img/202110/d721c5b34b582d0a88ac602eda0aa6e0.json",
390 "jump_image_md5": "",
391 "schema_image_url": "https://i0.hdslb.com/bfs/sycp/creative_img/202110/d721c5b34b582d0a88ac602eda0aa6e0.json",
392 "schema_image_md5": "",
393 "click_expand_ratio": 100,
394 "logo_image_url": "https://i0.hdslb.com/bfs/sycp/mgk/img/202106/17006d50ec506813727b1cb5c6fc58b1.png",
395 "logo_image_md5": "86bc1b68ce4708d918cd4e01a975ca17",
396 "related_ids": [],
397 "schema_list": [],
398 "font_ratio": 0.23,
399 "seq": 0,
400 "degrade_type": 1,
401 "twist_angle": 0.0,
402 "twist_speed": 0.0,
403 "secondary_guide_instructions": "",
404 "secondary_font_ratio": 0,
405 "secondary_text_color": "",
406 "secondary_text_color_night": "",
407 },
408 {
409 "id": 24803,
410 "x": 50,
411 "y": 80,
412 "bg_color": "#80000000",
413 "bg_color_night": "#80000000",
414 "text_color": "#FFFFFFFF",
415 "text_color_night": "#FFFFFFFF",
416 "guide_instructions": "滑动畅享索尼醇音",
417 "guide_instructions_new": "",
418 "width": 64,
419 "jump_url": "https://gxb.mmstat.com/gxb.gif?t=https%3A%2F%2Fequity.tmall.com%2Ftm%3FagentId%3D1598070%26bc_fl_src%3Dtmall_market_llb_1_1762697%26llbPlatform%3D_pube%26llbOsd%3D1%26mm_unid%3D1_11094511_560501015e6d5757020607530b6f5353086656040b075e&v=644035c3dbd3&di=__IDFA__&dim=__IMEI__&oaid=__OAID__&bc_fl_src=tmall_market_llb_1_1762697&llbPlatform=_pubu&llbOsd=1&agentId=1598070",
420 "schema": "",
421 "schema_package_name": "",
422 "schema_title": "点击进入第三方应用",
423 "schema_title_new": "",
424 "universal_app": "",
425 "height": 3,
426 "slide_threshold_value": 5,
427 "slide_border_color": "#40FFFFFF",
428 "guide_image_url": "",
429 "guide_image_md5": "",
430 "interact_style": 3,
431 "jump_image_url": "https://i0.hdslb.com/bfs/sycp/creative_img/202110/d721c5b34b582d0a88ac602eda0aa6e0.json",
432 "jump_image_md5": "",
433 "schema_image_url": "https://i0.hdslb.com/bfs/sycp/creative_img/202110/d721c5b34b582d0a88ac602eda0aa6e0.json",
434 "schema_image_md5": "",
435 "click_expand_ratio": 100,
436 "logo_image_url": "https://i0.hdslb.com/bfs/sycp/mgk/img/202106/17006d50ec506813727b1cb5c6fc58b1.png",
437 "logo_image_md5": "86bc1b68ce4708d918cd4e01a975ca17",
438 "related_ids": [24800],
439 "schema_list": [],
440 "font_ratio": 0.23,
441 "seq": 99,
442 "degrade_type": 1,
443 "twist_angle": 0.0,
444 "twist_speed": 0.0,
445 "secondary_guide_instructions": "",
446 "secondary_font_ratio": 0,
447 "secondary_text_color": "",
448 "secondary_text_color_night": "",
449 },
450 ],
451 }
452 # ... a lot of
453 ],
454 "splash_request_id": "1653661460572q172a27a3a3q2165",
455 }
456 ```
Modified ranking&dynamic/ranking.md +1 -1
@@ -52,7 +52,7 @@
52 52
53 53 ```shell
54 54 curl -G 'http://api.bilibili.com/x/web-interface/ranking/region' \
55 --data-urlencode 'tid=1' \
55 56 --data-urlencode 'day=3'
56 57 ```
57 58