获取最新 APP 版本

版本升级

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

请求方式: GET

鉴权方式(非必须):APP API 签名与鉴权

URL参数:

参数名类型内容必要性备注
abistr设备 CPU ABI不必要arm64-v8a
appidstr客户端类型不必要tv.danmaku.bili
brandstr设备品牌不必要google
buildint当前 APP 版本号必要8000200
channelstrAPP 分发渠道必要master
deviceidstr设备唯一 ID不必要即 XU-Prefixed BUVID,见 device_identity
envstrAPP 分发环境不必要默认 prod
ivint当前 APP innerVer不必要8000210
mobi_appstrAPP mobi_app必要android
modelstr设备型号不必要Pixel 2 XL
ntstr-必要默认 1
ovstr设备 OS 版本必要安卓即 API Level,如 Android 11 为 30
platformstr设备平台不必要android
screenstr设备屏幕参数不必要2712_1440@537.882_537.882
snint当前 APP SN必要15088473
vnstr当前 APP 版本名称必要8.0.0

标头参数(Headers):

参数名类型内容必要性备注
app-keystrAPPKey 名称必要大体等同于 mobi_app。特别地:64 位版本粉版客户端应为 android64
buvidstrBUVID必要XU-Prefixed BUVID,见 device_identity

JSON回复:

根对象:

字段类型内容备注
codeint返回值0: 成功
-304: 木有改动
-400: 请求异常
messagestr错误信息默认为 0
ttlint1
dataobj信息本体

data 对象:

字段类型内容备注
titlestr标题
contentstr内容
versionstr最新版本名称
version_codeint最新版本号build
urlstr下载地址
sizeint大小单位字节
md5strMD5 值
silentint是否静默安装?
upgrade_typeint升级类型?
cycleint升级周期?
policyint升级策略?
policy_urlstr升级策略链接?
ptimeint发布时间

示例:

curl 'https://app.bilibili.com/x/v2/version/fawkes/upgrade' \
  --url-query 'build=8000200' \
  --url-query 'channel=master' \
  --url-query 'mobi_app=android' \
  --url-query 'ov=30' \
  --url-query 'nt=1' \
  --url-query 'sn=15088473' \
  --url-query 'vn=8.0.0' \
  --header 'app-key: android64' \
  --header 'buvid: XU607DF6A8098F57B0BAF7FC107714C3035F0' \
  --header 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36'
查看响应示例:
{
    "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
    }
}