fix(APP_widget/ver.md): fix wrong desc and add details (#1090)

This commit is contained in:
陈寒彤 2024-09-19 23:08:27 +08:00 committed by GitHub
parent cffe9ca449
commit 2dbdcd884d
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -6,18 +6,35 @@
*请求方式: GET*
鉴权方式(非必须):[APP API 签名与鉴权](../misc/sign/APP.md)
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| - | - | - | - | - |
| appkey | str | APP 密钥 | 不必要 | |
| build | int | 当前 APP 版本号 | 必要 | 将会影响是否有新版本 |
| mobi_app | str | 目标客户端类型 | 必要 | 如 `android` |
| nt | str | 任意非空串 | 必要 | 默认为 `1` |
| ov | str | 任意非空串 | 必要 | 默认为 `22` |
| platform | str | 设备平台 | 必要 | 任意非空串即可, 如 `android` |
| sn | int | 设备序列号? | 必要 | 任意数字即可, 如 `4462369` |
| vn | str | 当前版本号 | 必要 | 任意非空串即可, 如 `6.13.0` |
| 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](../misc/device_identity.md) |
| 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`](../misc/sign/APPKey.md)。特别地64 位版本粉版客户端应为 `android64` |
| buvid | str | BUVID | 必要 | XU-Prefixed BUVID见 [device_identity](../misc/device_identity.md) |
**JSON回复:**
@ -36,8 +53,8 @@
| - | - | - | - |
| title | str | 标题 | |
| content | str | 内容 | |
| version | str | 最新版本 | |
| version_code | int | 最新版本号 | build |
| version | str | 最新版本名称 | |
| version_code | int | 最新版本号 | `build` |
| url | str | 下载地址 | |
| size | int | 大小 | 单位字节 |
| md5 | str | MD5 值 | |
@ -50,16 +67,18 @@
**示例:**
```curl
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=!!!'
```sh
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'
```
<details>
@ -67,24 +86,25 @@ curl -G 'https://app.bilibili.com/x/v2/version/fawkes/upgrade' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"title": "升级提醒",
"content": "-修复了一些bug并优化了一些搜索和播放体验~\n-让我们举起双手,把力量借给备考的小伙伴们!",
"version": "7.81.0",
"version_code": 7810200,
"url": "https://dl.hdslb.com/mobile/pack/android/15013586/iBiliPlayer-apinkRelease-7.81.0-b15013586.apk",
"size": 138723520,
"md5": "60f83fb828bc05aefdac67504ba72ea9",
"silent": 0,
"upgrade_type": 1,
"cycle": 4,
"policy": 0,
"policy_url": "",
"ptime": 1717554395
}
"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
}
}
```