App 版本

server 层 /api/app/version 与 APK 下载

路径未版本化 最后更新:2026-10-25

App 版本(server 层公开接口)

注意 GET /api/app/version 注册在 server.js 中,不在 /api router 内。它不要求认证,返回 app-version.json 的原始内容,不使用 {ok,data} 信封,也不经过 API 的 JSON 解析/错误中间件。

{
  "versionCode": 34,
  "versionName": "1.34",
  "minSdk": 26,
  "force": false,
  "releasedAt": "2026-10-25 14:23",
  "sizeText": "4.08 MB",
  "apkPath": "/download/app-v1.34-release.apk",
  "md5": "<md5>",
  "changelog": ["..."],
  "note": "...",
  "history": [ { "versionCode": 33, "versionName": "1.33", "releasedAt": "2026-10-19 08:35", "changelog": ["..."] } ]
}
  • 响应带 Cache-Control: no-store。版本文件读取失败时返回 HTTP 500 和 {"error":"版本信息不可用"};格式错误返回 {"error":"版本信息格式错误"},同样不是统一信封。
  • minSdk 当前为 26(Android 8.0);apkPath 指向 /download/<文件名>.apk,下载路由只允许 releases/ 下的 .apk 文件。
若本文与源码不一致,以源码和实际响应为准;发现不一致时请更新文档,而不是修改 API 行为。 学生使用指南 · 返回 API 总览