Day 4：GET、POST、Path、Query、Body 如何支撑企业 AI 接口设计

• 能围绕“GET、POST、Path、Query、Body 如何支撑企业 AI 接口设计”讲清楚是什么、为什么、怎么用、项目里怎么落地。
• 能完成当天实战任务：制造业订单风险查询接口设计。
• 能把当天知识点关联到你的AI应用岗位定位：AI工程师、AI Agent应用工程师、AI解决方案顾问。
• 能用业务场景表达技术，不只背概念。
• 能拿出当天产物 day04_api_design_examples.md 作为面试证据。

如果原视频分P标题变化，请按模块关键词人工定位；不要全刷。

3.1 GET只读查询

AI 工程里为什么必须会：GET只读查询 不是孤立概念，它会影响接口参数、JSON结构、工作流节点、Agent工具、RAG结果或制造业业务数据能否被稳定处理。

项目里怎么用：在“制造业订单风险查询接口设计”中，我要用它解决：业务人员问某订单是否有延期风险，系统要区分订单详情查询、风险分析提交和筛选条件。

面试时怎么说：我会把 GET只读查询 放到业务场景里讲，先说明它解决什么问题，再说明它如何支撑 FastAPI、RAG、Agent、悟空/DEAP 或 AI表格的落地。

面试官追问怎么答：如果被追问，我会补充它的输入、输出、异常情况和工程边界，避免只背定义。

3.2 POST复杂提交

AI 工程里为什么必须会：POST复杂提交 不是孤立概念，它会影响接口参数、JSON结构、工作流节点、Agent工具、RAG结果或制造业业务数据能否被稳定处理。

项目里怎么用：在“制造业订单风险查询接口设计”中，我要用它解决：业务人员问某订单是否有延期风险，系统要区分订单详情查询、风险分析提交和筛选条件。

面试时怎么说：我会把 POST复杂提交 放到业务场景里讲，先说明它解决什么问题，再说明它如何支撑 FastAPI、RAG、Agent、悟空/DEAP 或 AI表格的落地。

面试官追问怎么答：如果被追问，我会补充它的输入、输出、异常情况和工程边界，避免只背定义。

3.3 Path定位资源

AI 工程里为什么必须会：Path定位资源 不是孤立概念，它会影响接口参数、JSON结构、工作流节点、Agent工具、RAG结果或制造业业务数据能否被稳定处理。

项目里怎么用：在“制造业订单风险查询接口设计”中，我要用它解决：业务人员问某订单是否有延期风险，系统要区分订单详情查询、风险分析提交和筛选条件。

面试时怎么说：我会把 Path定位资源 放到业务场景里讲，先说明它解决什么问题，再说明它如何支撑 FastAPI、RAG、Agent、悟空/DEAP 或 AI表格的落地。

面试官追问怎么答：如果被追问，我会补充它的输入、输出、异常情况和工程边界，避免只背定义。

3.4 Query筛选条件

AI 工程里为什么必须会：Query筛选条件 不是孤立概念，它会影响接口参数、JSON结构、工作流节点、Agent工具、RAG结果或制造业业务数据能否被稳定处理。

项目里怎么用：在“制造业订单风险查询接口设计”中，我要用它解决：业务人员问某订单是否有延期风险，系统要区分订单详情查询、风险分析提交和筛选条件。

面试时怎么说：我会把 Query筛选条件 放到业务场景里讲，先说明它解决什么问题，再说明它如何支撑 FastAPI、RAG、Agent、悟空/DEAP 或 AI表格的落地。

面试官追问怎么答：如果被追问，我会补充它的输入、输出、异常情况和工程边界，避免只背定义。

3.5 Body承载结构化输入

AI 工程里为什么必须会：Body承载结构化输入 不是孤立概念，它会影响接口参数、JSON结构、工作流节点、Agent工具、RAG结果或制造业业务数据能否被稳定处理。

项目里怎么用：在“制造业订单风险查询接口设计”中，我要用它解决：业务人员问某订单是否有延期风险，系统要区分订单详情查询、风险分析提交和筛选条件。

面试时怎么说：我会把 Body承载结构化输入 放到业务场景里讲，先说明它解决什么问题，再说明它如何支撑 FastAPI、RAG、Agent、悟空/DEAP 或 AI表格的落地。

面试官追问怎么答：如果被追问，我会补充它的输入、输出、异常情况和工程边界，避免只背定义。

产物目录：/Users/hejunkai/Documents/AI工程师/28天每日背诵文档/Day04_接口参数设计_实战项目

核心文件：day04_api_design_examples.md

# 接口设计示例
GET /orders/{order_id}
用途：查询某个订单详情。Path中的order_id用于定位资源。

GET /orders?customer_name=无锡某制造企业&status=delayed
用途：按客户和状态筛选订单列表。Query用于过滤。

POST /orders/risk-analysis
用途：提交订单、库存、工单、采购数据，触发复杂风险分析。Body承载复杂JSON。

示例Body：
{
  "order_id": "SO-2026-001",
  "materials": [{"material_code": "M001", "required_qty": 100}],
  "inventory": [{"material_code": "M001", "available_qty": 40}],
  "work_order_status": "delayed"
}

验收目标：能解释同一个业务场景下为什么不能所有接口都用POST或GET。

1. 面试官可能问：你怎么理解接口参数设计在AI工程里的作用？
   候选人现场回答版：我会从业务场景讲：业务人员问某订单是否有延期风险，系统要区分订单详情查询、风险分析提交和筛选条件。。接口参数设计的价值是把这个问题变成可执行、可验证的工程流程。
2. 面试官可能问：这个知识点和你的简历项目有什么关系？
   候选人现场回答版：它可以对应我的悟空/DEAP技能、FastAPI接口、RAG知识库、Agent工具或制造业多系统Agent项目。
3. 面试官可能问：你能现场展示什么？
   候选人现场回答版：我可以展示当天产物 day04_api_design_examples.md，说明输入、处理过程、输出和后续升级路径。
4. 面试官可能问：它如何升级成Agent Tool？
   候选人现场回答版：先封装成函数或API，再定义工具名称、描述和参数Schema，让Agent在合适场景调用。
5. 面试官可能问：它如何接入悟空/DEAP？
   候选人现场回答版：通过工作流节点传入参数、调用API或读取AI表格，再把结果交给模型生成回复或报告。
6. 面试官可能问：如果数据错了怎么办？
   候选人现场回答版：先检查字段映射、数据类型、接口返回、日志和测试集，必要时转人工确认。
7. 面试官可能问：如何向非技术客户解释？
   候选人现场回答版：我会用业务语言说它如何减少手工整理、提升响应速度、让数据分析可追溯。
8. 面试官可能问：它和制造业有什么关系？
   候选人现场回答版：制造业ERP/MES/WMS/财务数据都需要通过结构化数据、接口、工具和工作流连接起来。
9. 面试官可能问：你目前做到什么程度？
   候选人现场回答版：我会如实说明是学习验证、原型、联调还是可演示项目，不编造上线效果。
10. 面试官可能问：你如何证明自己掌握了？
    候选人现场回答版：我能讲清原理，完成制造业订单风险查询接口设计，并把它映射到真实AI应用场景。