工作流介绍
将从 CocktailDB API 收到的 JSON 数据转换为 XML
此 N8n 工作流模板旨在从 TheCocktailDB 公共 API 以 JSON 格式获取随机鸡尾酒数据,并使用内置的数据转换功能将其转换为 XML 格式。该工作流演示了一个简单而实用的集成和数据转换管道,非常适合需要将 REST API 的 JSON 响应转换为 XML 以供需要或偏好基于 XML 的数据的下游系统的用户。
工作流功能
工作流在手动执行时启动,发送 HTTP GET 请求从 TheCocktailDB API 检索随机鸡尾酒的详细信息,然后将返回的 JSON 响应转换为 XML 文档。这使得现代基于 JSON 的 API 与使用 XML 的传统或企业系统之间能够实现无缝互操作。
主要功能和能力
- 手动触发执行: 工作流仅在手动触发时运行,适合按需检索数据。
- HTTP 请求集成: 直接连接到实时公共 REST API,无需身份验证。
- 数据格式转换: 使用 n8n 中的原生 XML 节点将结构化 JSON 转换为格式正确的 XML。
- 轻量级且可重用: 最少的节点设置使此工作流易于理解、修改并在更大的工作流中重用。
- 无外部依赖: 仅依赖 n8n 的核心节点——Manual Trigger、HTTP Request 和 XML——确保跨 n8n 环境的兼容性。
主要节点及其用途
-
点击“执行”时(Manual Trigger 节点)
- 用途: 作为工作流的起点。
- 功能: 等待用户点击 n8n 界面中的“执行工作流”按钮以开始该过程。
- 类型:
n8n-nodes-base/manualTrigger
-
HTTP Request 节点
- 用途: 从外部 API 检索实时鸡尾酒数据。
- 功能: 向
https://www.thecocktaildb.com/api/json/v1/1/random.php发送 GET 请求,该请求以 JSON 格式返回随机鸡尾酒(例如,名称、配料、说明、图片)。 - 类型:
n8n-nodes-base/httpRequest - 关键参数: URL 设置为 CocktailDB 随机饮品端点。
-
XML 节点
- 用途: 将传入的 JSON 有效负载转换为 XML 格式。
- 功能: 在
"jsonToXml"模式下运行,将来自 HTTP Request 的结构化 JSON 响应转换为有效的 XML 字符串。 - 类型:
n8n-nodes-base/xml - 模式:
jsonToxml— 确保从 JSON 到 XML 的定向转换。
用例和优势
- 系统集成: 当与仅接受 XML 输入的传统系统或第三方工具集成时非常有用(例如,旧的 ERP、CMS 或 EDI 系统)。
- 数据标准化: 能够在异构环境中实现数据格式的标准化。
- 原型设计和测试: 非常适合开发人员测试 API 响应或构建涉及格式转换的概念验证集成。
- 学习工具: 非常适合初学者学习 n8n 如何处理 API 调用和数据转换。
- 自动化准备: 可以扩展为通过 Webhook 或计划自动触发,并将转换后的 XML 输入到电子邮件、文件存储或消息队列中。
分步工作流逻辑
-
步骤 1: 工作流启动
- 用户通过单击“执行”按钮手动执行工作流。
- Manual Trigger 节点激活并将控制权传递给下一个节点。
-
步骤 2: 获取鸡尾酒数据
- HTTP Request 节点向
https://www.thecocktaildb.com/api/json/v1/1/random.php发送 GET 请求。 - API 以包含随机选择的鸡尾酒详细信息的 JSON 对象进行响应,包括其名称、配料、测量值、说明等。
- HTTP Request 节点向
-
步骤 3: 将 JSON 转换为 XML
- JSON 响应被传递到 XML 节点。
- 该节点处理 JSON 结构并将其转换为等效的 XML 表示形式。
- 例如,JSON 字段如
{"strDrink": "Margarita"}将在根<root>元素(默认,除非自定义)内变为<strDrink>Margarita</strDrink>。
-
输出
- 最终输出是一个格式化的 XML 字符串,反映了原始 JSON 数据。
- 此 XML 可用于后续节点,如 File Binary、Email 或 Webhook Responders,以进行进一步处理或交付。
此工作流例证了 n8n 在处理 API 集成和数据转换方面的强大功能,只需最少的配置,即可供技术和非技术用户使用。
使用方法:下载 JSON 文件,然后在 n8n 中选择“从文件导入”。