bac

获取最新 APP 版本

获取版本信息

https://app.bilibili.com/x/v2/version

请求方法: GET

URL参数:

参数名	类型	内容	必要性	备注
mobi_app	str	目标客户端类型	不必要	留空为最新有更新的平台 android: Android 版 iphone: iPhone 版 ipad: iPad HD 版 win: UWP 版 android_tv_yst: TV 版 android_car: 车机版 pc_client: PC 客户端

JSON回复:

根对象:

字段	类型	内容	备注
code	int	返回值	0: 成功
message	str	错误信息	默认为 `0`
ttl	int	1
data	array	版本信息列表

data 数组中的对象:

字段	类型	内容	备注
plat	int	平台	0: Android 1: iPhone 2: iPad HD 3: UWP 12: TV 版 35: 车机版 40: PC 客户端
desc	str	版本描述
version	str	版本号
build	int	内部版本号

示例:

curl -G 'https://app.bilibili.com/x/v2/version' \
--url-query'mobi_app=android'

查看响应示例:

```json { "code": 0, "message": "0", "ttl": 1, "data": [ { "plat": 0, "desc": "-修复了一些bug，切了个大西瓜~", "version": "8.9.0", "build": 8090300, "ptime": 1723612377 }, // ... { "plat": 0, "desc": "[修正]横屏状态下,视频列表加载失败的问题\n[修正]超过48kHz采样率的音频无法播放的问题\n[修正]部分系统黑屏的问题\nPS:帮下面的同学祈祷早日上架", "version": "2.0.4", "build": 0, "ptime": 1382630400 } ] } ```

版本升级

https://app.bilibili.com/x/v2/version/fawkes/upgrade

请求方式: GET

鉴权方式（非必须）：APP API 签名与鉴权

URL参数:

参数名	类型	内容	必要性	备注
abi	str	设备 CPU ABI	不必要	如 `arm64-v8a`
appid	str	客户端类型	不必要	如 `tv.danmaku.bili`
brand	str	设备品牌	不必要	如 `google`
build	int	当前 APP 版本号	必要	如 `8000200`
channel	str	APP 分发渠道	必要	如 `master`
deviceid	str	设备唯一 ID	不必要	即 XU-Prefixed BUVID，见 device_identity
env	str	APP 分发环境	不必要	默认 `prod`
iv	int	当前 APP innerVer	不必要	如 `8000210`
mobi_app	str	APP mobi_app	必要	如 `android`
model	str	设备型号	不必要	如 `Pixel 2 XL`
nt	str	-	必要	默认 `1`
ov	str	设备 OS 版本	必要	安卓即 API Level，如 Android 11 为 `30`
platform	str	设备平台	不必要	如 `android`
screen	str	设备屏幕参数	不必要	如 `2712_1440@537.882_537.882`
sn	int	当前 APP SN	必要	如 `15088473`
vn	str	当前 APP 版本名称	必要	如 `8.0.0`

标头参数（Headers）：

参数名	类型	内容	必要性	备注
app-key	str	APPKey 名称	必要	大体等同于 `mobi_app`。特别地：64 位版本粉版客户端应为 `android64`
buvid	str	BUVID	必要	XU-Prefixed BUVID，见 device_identity

JSON回复:

根对象:

字段	类型	内容	备注
code	int	返回值	0: 成功 -304: 木有改动 -400: 请求异常
message	str	错误信息	默认为 `0`
ttl	int	1
data	obj	信息本体

data 对象:

字段	类型	内容	备注
title	str	标题
content	str	内容
version	str	最新版本名称
version_code	int	最新版本号	即 `build`
url	str	下载地址
size	int	大小	单位字节
md5	str	MD5 值
silent	int	是否静默安装?
upgrade_type	int	升级类型?
cycle	int	升级周期?
policy	int	升级策略?
policy_url	str	升级策略链接?
ptime	int	发布时间

示例:

curl -G 'https://app.bilibili.com/x/v2/version/fawkes/upgrade' \
--url-query 'build=1145141' \
--url-query 'channel=apt' \
--url-query 'mobi_app=android' \
--url-query 'nt=awa' \
--url-query 'ov=qwq' \
--url-query 'platform=archlinux' \
--url-query 'sn=919810' \
--url-query 'vn=!!!'

查看响应示例:

```json { "code": 0, "message": "0", "ttl": 1, "data": { "title": "升级提醒", "content": "-修复了一些bug，并吃了一桶冰淇凌~\n-记得检查暑假作业哦！", "version": "8.10.0", "version_code": 8100300, "url": "https://dl.hdslb.com/mobile/pack/android64/15793300/iBiliPlayer-apinkRelease-8.10.0-b15793300.apk", "size": 132432843, "md5": "f196c0ea68ff894dab0cf380cafad802", "silent": 0, "upgrade_type": 1, "cycle": 4, "policy": 0, "policy_url": "", "is_gray": 0, "ptime": 1724207041 } } ```

拼接最新版本下载地址

https://api.bilibili.com/x/web-frontend/getappversion

请求方法: GET

URL参数:

参数名	类型	内容	必要性	备注
target	string	目标平台	目测仅 `pc_electron`, 错误的值会导致返回 `HTTP 404`
cdn_url	string	CDN URL	任意字符串, 默认 `https://dl.hdslb.com/mobile/fixed/bili_win/bili_win-install.exe`

JSON回复:

根对象:

字段	类型	内容	备注
code	number	返回值	0: 成功 -1: need target
message	string	错误消息	成功时无此项

data 对象:

字段	类型	内容	备注
cdn_url	string	CDN URL	内容同请求参数 `cdn_url`
sole_cdn_url	string	带版本的 CDN URL	`cdn_url + "?v=" + 最新版本`

示例:

curl -G 'https://api.bilibili.com/x/web-frontend/getappversion' \
--url-query 'target=pc_electron' \
--url-query 'cdn_url=https://dl.hdslb.com/mobile/fixed/bili_win/bili_win-install.exe'

查看响应示例:

```json { "code": 0, "data": { "cdn_url": "https://dl.hdslb.com/mobile/fixed/bili_win/bili_win-install.exe", "sole_cdn_url": "https://dl.hdslb.com/mobile/fixed/bili_win/bili_win-install.exe?v=1.16.1-2" } } ```

This site is open source. Improve this page.