You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

78 lines
2.4 KiB

# API 测试用例清单
## 新增数据同步接口测试用例
| 测试ID | 测试名称 | 方法 | 路径 | 说明 |
|--------|----------|------|------|------|
| `admin_data_sync_full` | 全量数据同步 | POST | `/v1/admin/data/sync` | 同步基础+行情+财务数据 |
| `admin_data_sync_base` | 同步基础K线数据 | POST | `/v1/admin/data/sync` | 仅同步OHLCV基础数据 |
| `admin_data_sync_quote` | 同步行情指标数据 | POST | `/v1/admin/data/sync` | 同步均线/MACD/涨跌幅 |
| `admin_data_sync_finance` | 同步财务数据 | POST | `/v1/admin/data/sync` | 同步市值/股本/利润 |
| `admin_data_sync_incremental` | 增量数据同步 | POST | `/v1/admin/data/sync/incremental` | 同步最近30天数据 |
| `admin_data_sync_futures` | 期货数据同步 | POST | `/v1/admin/data/sync` | 同步期货数据 |
## 测试用例分类统计
| 分类 | 用例数 |
|------|--------|
| 股票接口 | 4 |
| 期货接口 | 5 |
| 管理接口 | 7 |
| 适配器管理 | 3 |
| **数据同步接口** | **6** |
| 测试管理 | 1 |
| **总计** | **26** |
## 使用方法
### 通过管理后台API测试
```bash
# 1. 获取测试列表
curl "http://localhost:8080/v1/admin/tests/api"
# 2. 执行全量数据同步测试
curl -X POST "http://localhost:8080/v1/admin/tests/api/run" \
-H "Content-Type: application/json" \
-d '{
"id": "admin_data_sync_full",
"params": {
"symbols": ["000001.SZ"],
"sync_type": "full"
}
}'
# 3. 执行基础数据同步测试
curl -X POST "http://localhost:8080/v1/admin/tests/api/run" \
-H "Content-Type: application/json" \
-d '{
"id": "admin_data_sync_base"
}'
```
### 直接调用数据同步接口
```bash
# 全量同步
curl -X POST "http://localhost:8080/v1/admin/data/sync" \
-H "Content-Type: application/json" \
-d '{
"symbols": ["600519.SH", "000001.SZ"],
"sync_type": "full",
"start_date": "20240101",
"end_date": "20240301"
}'
# 增量同步
curl -X POST "http://localhost:8080/v1/admin/data/sync/incremental" \
-H "Content-Type: application/json" \
-d '["600519.SH", "000001.SZ"]'
```
## 对应的适配器方法
| API接口 | 适配器方法 |
|---------|-----------|
| `/admin/data/sync` (base) | `fetch_kline_base` |
| `/admin/data/sync` (quote) | `fetch_kline_quote` |
| `/admin/data/sync` (finance) | `fetch_kline_finance` |
| `/admin/data/sync/incremental` | `sync_daily_incremental` |