返回提交历史
Modified
docs/APP_widget/ver.md
+58
-38
XFEstudio/bilibili-API-collect
fix(APP_widget/ver.md): fix wrong desc and add details (#1090)
2dbdcd8
代码差异
1 个文件
+58
-38
@@ -6,18 +6,35 @@
6
6
7
7
*请求方式: GET*
8
8
9
鉴权方式（非必须）：[APP API 签名与鉴权](../misc/sign/APP.md)
10
9
11
**URL参数:**
10
12
11
13
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
12
14
| - | - | - | - | - |
13
| appkey | str | APP 密钥 | 不必要 | |
14
| build | int | 当前 APP 版本号 | 必要 | 将会影响是否有新版本 |
15
| mobi_app | str | 目标客户端类型 | 必要 | 如 `android` |
16
| nt | str | 任意非空串 | 必要 | 默认为 `1` |
17
| ov | str | 任意非空串 | 必要 | 默认为 `22` |
18
| platform | str | 设备平台 | 必要 | 任意非空串即可, 如 `android` |
19
| sn | int | 设备序列号? | 必要 | 任意数字即可, 如 `4462369` |
20
| vn | str | 当前版本号 | 必要 | 任意非空串即可, 如 `6.13.0` |
15
| abi | str | 设备 CPU ABI | 不必要 | 如 `arm64-v8a` |
16
| appid | str | 客户端类型 | 不必要 | 如 `tv.danmaku.bili` |
17
| brand | str | 设备品牌 | 不必要 | 如 `google` |
18
| build | int | 当前 APP 版本号 | 必要 | 如 `8000200` |
19
| channel | str | APP 分发渠道 | 必要 | 如 `master` |
20
| deviceid | str | 设备唯一 ID | 不必要 | 即 XU-Prefixed BUVID，见 [device_identity](../misc/device_identity.md) |
21
| env | str | APP 分发环境 | 不必要 | 默认 `prod` |
22
| iv | int | 当前 APP innerVer | 不必要 | 如 `8000210` |
23
| mobi_app | str | APP mobi_app | 必要 | 如 `android` |
24
| model | str | 设备型号 | 不必要 | 如 `Pixel 2 XL` |
25
| nt | str | - | 必要 | 默认 `1` |
26
| ov | str | 设备 OS 版本 | 必要 | 安卓即 API Level，如 Android 11 为 `30` |
27
| platform | str | 设备平台 | 不必要 | 如 `android` |
28
| screen | str | 设备屏幕参数 | 不必要 | 如 `2712_1440@537.882_537.882`
29
| sn | int | 当前 APP SN | 必要 | 如 `15088473` |
30
| vn | str | 当前 APP 版本名称 | 必要 | 如 `8.0.0` |
31
32
**标头参数（Headers）：**
33
34
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
35
| - | - | - | - | - |
36
| app-key | str | APPKey 名称 | 必要 | 大体等同于 [`mobi_app`](../misc/sign/APPKey.md)。特别地：64 位版本粉版客户端应为 `android64` |
37
| buvid | str | BUVID | 必要 | XU-Prefixed BUVID，见 [device_identity](../misc/device_identity.md) |
21
38
22
39
**JSON回复:**
23
40
@@ -36,8 +53,8 @@
36
53
| - | - | - | - |
37
54
| title | str | 标题 | |
38
55
| content | str | 内容 | |
39
| version | str | 最新版本号 | |
40
| version_code | int | 最新版本号 | build |
56
| version | str | 最新版本名称 | |
57
| version_code | int | 最新版本号 | 即 `build` |
41
58
| url | str | 下载地址 | |
42
59
| size | int | 大小 | 单位字节 |
43
60
| md5 | str | MD5 值 | |
@@ -50,16 +67,18 @@
50
67
51
68
**示例:**
52
69
53
```curl
54
curl -G 'https://app.bilibili.com/x/v2/version/fawkes/upgrade' \
70
```sh
71
curl 'https://app.bilibili.com/x/v2/version/fawkes/upgrade' \
72
--url-query 'build=8000200' \
73
--url-query 'channel=master' \
74
--url-query 'mobi_app=android' \
75
--url-query 'ov=30' \
76
--url-query 'nt=1' \
77
--url-query 'sn=15088473' \
78
--url-query 'vn=8.0.0' \
79
--header 'app-key: android64' \
80
--header 'buvid: XU607DF6A8098F57B0BAF7FC107714C3035F0' \
81
--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'
55
82
```
56
83
57
84
<details>
@@ -67,24 +86,25 @@ curl -G 'https://app.bilibili.com/x/v2/version/fawkes/upgrade' \
67
86
68
87
```json
69
88
{
70
"code": 0,
71
"message": "0",
72
"ttl": 1,
73
"data": {
74
"title": "升级提醒",
75
"content": "-修复了一些bug，并优化了一些搜索和播放体验~\n-让我们举起双手，把力量借给备考的小伙伴们！",
76
"version": "7.81.0",
77
"version_code": 7810200,
78
"url": "https://dl.hdslb.com/mobile/pack/android/15013586/iBiliPlayer-apinkRelease-7.81.0-b15013586.apk",
79
"size": 138723520,
80
"md5": "60f83fb828bc05aefdac67504ba72ea9",
81
"silent": 0,
82
"upgrade_type": 1,
83
"cycle": 4,
84
"policy": 0,
85
"policy_url": "",
86
"ptime": 1717554395
87
}
89
"code": 0,
90
"message": "0",
91
"ttl": 1,
92
"data": {
93
"title": "升级提醒",
94
"content": "-修复了一些bug，并吃了一桶冰淇凌~\n-记得检查暑假作业哦！",
95
"version": "8.10.0",
96
"version_code": 8100300,
97
"url": "https://dl.hdslb.com/mobile/pack/android64/15793300/iBiliPlayer-apinkRelease-8.10.0-b15793300.apk",
98
"size": 132432843,
99
"md5": "f196c0ea68ff894dab0cf380cafad802",
100
"silent": 0,
101
"upgrade_type": 1,
102
"cycle": 4,
103
"policy": 0,
104
"policy_url": "",
105
"is_gray": 0,
106
"ptime": 1724207041
107
}
88
108
}
89
109
```
90
110