81 lines
2.1 KiB
Python
81 lines
2.1 KiB
Python
"""
|
||
流水分析Mock服务器 - 主应用入口
|
||
|
||
基于 FastAPI 实现的 Mock 服务器，用于模拟流水分析平台的 7 个核心接口
|
||
"""
|
||
from fastapi import FastAPI
|
||
from routers import api
|
||
from config.settings import settings
|
||
|
||
# 创建 FastAPI 应用实例
|
||
app = FastAPI(
|
||
title=settings.APP_NAME,
|
||
description="""
|
||
## 流水分析 Mock 服务器
|
||
|
||
模拟流水分析平台的 7 个核心接口，用于开发和测试。
|
||
|
||
### 主要功能
|
||
|
||
- **Token管理** - 创建项目并获取访问Token
|
||
- **文件上传** - 上传流水文件，支持异步解析（4秒延迟）
|
||
- **行内流水** - 拉取行内流水数据
|
||
- **解析状态** - 轮询检查文件解析状态
|
||
- **文件删除** - 批量删除上传的文件
|
||
- **流水查询** - 分页获取银行流水数据
|
||
|
||
### 错误模拟
|
||
|
||
在请求参数中包含 `error_XXXX` 标记可触发对应的错误响应。
|
||
|
||
例如：`projectNo: "test_error_40101"` 将返回 40101 错误。
|
||
|
||
### 使用方式
|
||
|
||
1. 获取Token: POST /account/common/getToken
|
||
2. 上传文件: POST /watson/api/project/remoteUploadSplitFile
|
||
3. 轮询解析状态: POST /watson/api/project/upload/getpendings
|
||
4. 获取流水: POST /watson/api/project/getBSByLogId
|
||
""",
|
||
version=settings.APP_VERSION,
|
||
docs_url="/docs",
|
||
redoc_url="/redoc",
|
||
)
|
||
|
||
# 包含 API 路由
|
||
app.include_router(api.router, tags=["流水分析接口"])
|
||
|
||
|
||
@app.get("/", summary="服务根路径")
|
||
async def root():
|
||
"""服务根路径，返回基本信息"""
|
||
return {
|
||
"service": settings.APP_NAME,
|
||
"version": settings.APP_VERSION,
|
||
"swagger_docs": "/docs",
|
||
"redoc": "/redoc",
|
||
"status": "running",
|
||
}
|
||
|
||
|
||
@app.get("/health", summary="健康检查")
|
||
async def health_check():
|
||
"""健康检查端点"""
|
||
return {
|
||
"status": "healthy",
|
||
"service": settings.APP_NAME,
|
||
"version": settings.APP_VERSION,
|
||
}
|
||
|
||
|
||
if __name__ == "__main__":
|
||
import uvicorn
|
||
|
||
# 启动服务器
|
||
uvicorn.run(
|
||
app,
|
||
host=settings.HOST,
|
||
port=settings.PORT,
|
||
log_level="debug" if settings.DEBUG else "info",
|
||
)
|