ISZ.AI AI AGENT开发教程

什么是API？

这是一个交互式的分步教程，通过餐厅类比来解释API的工作原理。

您 (客户端)

HTTP Request 节点
想要获取信息的人

厨房 (服务器)

Webhook 节点
拥有数据和服务的地方

API (服务员)

菜单和规则
如何请求和获取响应

就像在餐厅点餐一样，API是一套规则，定义了您如何向服务器请求信息，以及服务器如何响应您的请求。

您将掌握的核心概念

从基础到高级，系统学习API的各个方面。

基础概念

理解URL和GET方法

餐厅地址 + 查看菜单

查询参数

使用?extra_cheese=true定制请求

特殊要求和选项

发送数据

POST方法和请求体的使用

提交反馈表单

身份认证

Headers和API密钥的作用

VIP会员卡验证

超时处理

设置请求超时避免卡死

等餐时间限制

实际应用

在n8n工作流中的实践运用

完整流程演示

餐厅类比详解

通过熟悉的场景理解复杂的技术概念

🍽️ 餐厅场景

• 您走进餐厅（发起请求）
• 查看菜单（GET 请求）
• 告诉服务员特殊要求（查询参数）
• 填写反馈表（POST 请求）
• 出示会员卡（身份验证）
• 等餐时间限制（超时设置）

🌐 API对应概念

• HTTP Request 节点（客户端）
• GET 方法获取数据
• Query Parameters 过滤器
• POST 方法发送数据
• Headers 和认证令牌
• Timeout 防止请求卡死

操作指南

⏱️ 准备时间：小于1分钟！

这是一个自包含的教程，无需任何外部服务或复杂的凭证配置。

按照以下步骤操作：

1

执行工作流

点击"Execute Workflow"按钮来运行整个教程。

2

按顺序学习

从上到下跟随流程，探索每个"课程"部分。

3

检查节点配置

点击每个课程的HTTP Request节点（客户）和对应的Webhook节点（厨房），查看它们是如何配置的。

4

阅读便签说明

每个课程旁边都有详细的便签说明，解释核心概念和工作原理。

n8n Cloud 用户特别注意

如果您使用的是n8n云版本，可能需要更新BASE URL节点的配置。

解决方法：从任一Webhook节点复制Production URL的基础部分，然后更新BASE URL节点中的值。

五个核心模块

每个模块都有对应的实践演示

1

基础操作：方法和URL

学习最简单的GET请求，理解URL（餐厅地址）和HTTP方法（想要做什么）的概念。

实例：就像问服务员"今天的菜单是什么？"

2

定制请求：查询参数

使用Query Parameters来过滤或修改请求，如添加extra_cheese=true参数。

实例：告诉服务员"我要披萨，加额外的奶酪"

3

发送数据：POST和请求体

使用POST方法向服务器发送数据，如提交客户反馈表。

实例：填写并提交一张客户满意度调查表

4

身份验证：Headers和认证

使用Headers传递元信息，如API密钥进行身份验证访问特殊菜品。

实例：出示VIP会员卡来访问秘密菜单

5

处理延迟：超时机制

设置Timeout防止请求永远等待，避免工作流卡死。

实例：设定等餐时间限制，超时就离开餐厅

学习目标

完成本教程后，您将完全理解API的工作原理，并能够在n8n中自信地构建和使用各种API集成。

概念理解

深入理解API的核心概念和工作机制

实践能力

掌握在n8n中配置和使用API的技能

应用拓展

为构建复杂的API工作流打下坚实基础

第四课：API集成与Webhook