python_market_data_service/API_TEST_CASES.md

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测试

# 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"
  }'

直接调用数据同步接口

# 全量同步
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