# 下载量统计接口规范

## 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和统计标识符

注意：此接口由客户端自动调用，无需手动触发。
