2026-04-08-01 下载安装统计
1. 变更摘要
本次上线“下载/安装统计”能力，采用“低前端负担 + 后端去重限流”的实现方式：
- 新增下载跳转统计接口（计数 + 302 跳转）
- 新增下载上报接口与安装上报接口
- 新增管理端下载量/安装量统计接口
2. 前端影响与动作
- 下载接入：建议改为下载跳转模式（
/chatx/application/download）。 - 安装上报：必须提供并持久化
installID。 - 旧下载上报：可保留，不影响当前能力使用。
- 管理端统计：可通过统计接口查看下载/安装总量。
3. 接口变更清单
3.1 新增接口
| 说明 | 路径 | 状态 | 链接 |
|---|---|---|---|
| 下载跳转统计（302） | /chatx/application/download?versionID=... | Active | 跳转 |
| 下载行为上报 | /chatx/application/report_download | Active | 跳转 |
| 下载量统计 | /adminx/application/statistic/download | Active | 跳转 |
| 安装行为上报 | /chatx/application/report_install | Active | 跳转 |
| 安装量统计 | /adminx/application/statistic/install | Active | 跳转 |
| 版本分页查询 | /adminx/application/page_versions | Active | 跳转 |
3.2 修改接口
无
3.3 删除接口
无
4. 兼容性说明
report_download与download两种下载统计模式可并存。- 新增
download接口不会改变原有请求结构。 - 若前端切到下载跳转模式，可进一步降低接入复杂度。
5. 前端对接步骤（最简）
- 下载按钮改为：
/chatx/application/download?versionID=<版本ID>。 - 首次启动生成并持久化
installID。 - 安装上报调用：
POST /chatx/application/report_install，字段仅versionID、installID。 - 若已切换下载跳转模式，可不再主动调用
report_download。