系列: RAGFlow v0.25.0 源码深度解析作者: 耿雨飞前置知识: 已完成第五课"数据模型与服务层架构"的学习导读在第五课中，我们深入分析了 RAGFlow 的数据模型和服务层架构——32 个数据模型、CommonService基类和 25 个专用服务构成了坚实的数据基础。本课将目光上移一层，来到直接面向前端和外部调用者的 API 层。RAGFlow 的 API 层采用了清晰的双轨制架构：Web API（/v1/）面向前端 UI 交互，RESTful API（/api/v1/）面向程序化调用和 SDK 集成。整个 API 层由api/apps/目录下的多个 Blueprint 模块组成，涵盖知识库管理、文档处理、Agent 工作流、Chunk 操作、LLM 模型管理、数据连接器等核心功能，总计超过100 个 API 端点。本课将逐一拆解这些 API 模块，帮你建立从"一个 HTTP 请求到达服务器"到"调用服务层完成业务逻辑并返回响应"的完整认知链路。学习目标理解 RAGFlow 的 Web API 与 RESTful API 双轨制架构设计掌握统一响应格式、路由注册机制和核心装饰器的工作原理