干货:文件上传端点解析

文件上传端点解析:POST /PDF2Excels/UpLoadFile

端点是干什么的

外部系统把一份 PDF/Excel 传上来,我们接收、存到临时目录、塞进任务队列解析,最后回传结果。这是典型的"上传 → 异步处理 → 回传"。

接收文件

FastAPI 接收上传文件用 UploadFile:

python 复制代码
@app.post("/PDF2Excels/UpLoadFile")
async def upload(file: UploadFile = File(...)):
    # 存到本地临时目录
    folder = os.path.join(app.state.temp_folder, "upload")
    os.makedirs(folder, exist_ok=True)
    filepath = os.path.join(folder, file.filename)
    with open(filepath, "wb") as f:
        f.write(await file.read())
    return {"code": 0, "filepath": filepath, "folder": folder}

处理顺序

  1. 校验扩展名 / 大小(可选,好习惯是入口就做)。
  2. 落盘到临时目录,返回可用的绝对路径。
  3. 组任务塞进队列。
  4. 回传任务ID,后续轮询/回调。

落盘为什么必须

UploadFile 是流式的,不落盘你没法用 pdfplumber/openpyxl 打开。先存成真实文件,再交给引擎是标准做法。

要给任务一个 ID

异步处理不能直接返回结果,得返回一个 p_TaskId,让调用方拿着它去查结果:

python 复制代码
item = {
    "p_FolderPath": folder,
    "p_TaskId": task_id,
    "template": template,
}

返回值设计

  • 成功:{"code": 0, "task_id": "xxx", "msg": "已接收"}
  • 队列满:{"code": 503, "msg": "队列已满,请稍后重试"}

成功不代表解析完,只代表"已受理"。语义清清楚楚。

一句话:上传端点 = 接文件→落盘→组任务→回传ID,同步受理、异步出结果。


相关推荐
benchmark_cc5 小时前
个人开发者接入五档盘口:用 QuantDash 读取单只股票的验收清单与易错点
python·数据分析·pandas·量化交易·股票数据·quantdash
ZhengEnCi6 小时前
项目越写越乱?先别改架构:用一次目录重排 + 一份可复算的体检脚本把乱治住
python·架构·ai编程
Dmz丶7 小时前
前端转 AI 100 天 Day 45:阶段复盘——从“会调 API”到“做出 AI 产品”
python
Sakura_j_h_7 小时前
MCP SDK 2.0 实战:用 MCPServer 搭本地笔记检索服务
开发语言·笔记·python·qt·ai工具·mcp·mcpserver
QuZhengRong8 小时前
【AI】Agent 全栈进阶|AgentScope 沙箱源码解析
python·学习·ai·agent·沙箱
Eider19988 小时前
Python基础语法之并发相关3
开发语言·python
M--Y10 小时前
LangGraph 架构基石:持久化与运行控制
python·langchain·大模型·llm·持久化·langgraph
用户0190275816110 小时前
新浪财经 / 东方财富股票接口不稳、被限?稳定替代方案
python
七夜zippoe10 小时前
Nexent 知识库:调优靠 Chunk 与重排
开发语言·python·ai智能体·nexent·知识库与rag
承渊政道13 小时前
【Python编程—从入门到实践】(用户账户:给Django网站装上登录系统,让每个人拥有自己的学习笔记)
python·学习·pycharm·django