update:更新下载量统计接口信息

下载量统计接口规范.md

@@ -0,0 +1,128 @@
+# 下载量统计接口规范
+
+## 1. 获取下载次数
+
+获取指定应用的下载次数
+
+**URL**: `{SOURCE_URL}/{ARCH}/{CATOGARY}/{Package Name}/download-times.txt`
+
+**请求方式**: GET
+
+
+
+**示例**:
+
+```
+https://cdn.d.store.deepinos.org.cn/store/tools/spark-store/download-times.txt
+https://cdn.d.store.deepinos.org.cn/amd64-store/office/wps/download-times.txt
+https://cdn.d.store.deepinos.org.cn/aarch64-store/tools/spark-store/download-times.txt
+```
+
+**响应**: 纯文本，返回下载次数数字，如 `12345`
+
+---
+
+## 2. 上报下载次数 (apm-app-store)
+
+apm-app-store 项目使用 HTTP POST 上报下载统计
+
+**URL**: `{STATS_BASE_URL}/handle_post`
+
+**请求方式**: POST
+
+**请求头**:
+```
+Content-Type: application/json
+```
+
+**请求参数**:
+```json
+{
+    "path": "{ARCH}/{CATOGARY}/{Package Name}"
+}
+```
+
+**示例**:
+
+请求:
+```
+POST https://feedback.spark-app.store/handle_post
+Content-Type: application/json
+
+{
+    "path": "amd64-apm/office/wps"
+}
+```
+
+---
+
+## 3. 上报下载次数 (spark-store)
+# Spark Store 评分反馈接口文档
+## 接口概述
+| 项目 | 内容 |
+|------|------|
+| 接口名称 | 应用评分反馈 |
+| 接口地址 | `https://feedback.spark-app.store/handle_post` |
+| 请求方式 | POST |
+| 协议 | HTTPS |
+---
+## 请求头
+| Header | 值 | 说明 |
+|--------|-----|------|
+| Content-Type | application/json | 请求数据类型 |
+| User-Agent | Spark-Store/4.x | 客户端标识 |
+---
+## 请求参数
+### 请求体 (JSON)
+```json
+{
+  "path": "应用安装路径"
+}
+```
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| path | string | 是 | 应用在系统中的安装路径 |
+---
+## 响应结果
+### 成功响应
+```json
+Finished
+```
+### 失败响应
+```
+Permission denied
+```
+---
+## 调用示例
+### cURL
+```bash
+curl -X POST "https://feedback.spark-app.store/handle_post" \
+  -H "Content-Type: application/json" \
+  -H "User-Agent: Spark-Store/4.x" \
+  -d '{"path":"/opt/spark-store/apps/com.example.app"}'
+```
+### Python
+```python
+import requests
+url = "https://feedback.spark-app.store/handle_post"
+headers = {
+    "Content-Type": "application/json",
+    "User-Agent": "Spark-Store/4.x"
+}
+data = {"path": "/opt/spark-store/apps/com.example.app"}
+response = requests.post(url, json=data, headers=headers)
+print(response.text)
+```
+---
+## 错误码
+| 错误信息 | 说明 |
+|----------|------|
+| Finished | 请求成功 |
+| Permission denied | 权限不足或请求失败 |
+
+
+
+说明：当应用下载成功后，客户端会自动发送下载统计数据到服务器。此接口主要用于内部统计，不建议外部直接调用。
+请求体：JSON格式，包含应用元数据URL和统计标识符
+
+注意：此接口由客户端自动调用，无需手动触发。