系列: 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 双轨制架构设计
- 掌握统一响应格式、路由注册机制和核心装饰器的工作原理<
