API 基礎實戰互動教學 - n8n 工作流程

n8n 新手： 剛接觸此平台，需要了解如何與外部 API 互動的使用者。
自動化工程師： 尋求穩健、具說服力的 n8n 範本，用來教導團隊成員 API 原理的專業人士。
學生與教育工作者： 需要 HTTP 方法與 API 架構實用視覺化指南的人員。
所有人： 想要一個獨立運作、無需外部憑證即可執行的 n8n 工作流。

掌握 API（應用程式介面）是任何自動化專家的必修課。這個強大的 n8n 工作流可作為一個獨立的 API 模擬環境。它是最有效的 n8n API 初學者範本之一，將複雜的概念簡化為五個簡單、可執行的課程。

整個 n8n 節點鏈使用餐廳的比喻，其中 HTTP Request n8n 節點是「顧客」，而 Webhook n8n 節點則是「廚房」。執行此 n8n 工作流後，您會立即執行五種不同的 API 呼叫，並可以檢視每個 n8n 節點的輸入和輸出，了解參數、標頭和內文如何影響回應。這種互動式方法提供了即時回饋，鞏固了您對如何建構與真實世界 API 互動的穩固 n8n 工作流自動化的理解。

整個 n8n 工作流由手動 n8n 觸發器啟動，該觸發器會立即計算所有內部請求所需的基礎網址 (Base URL)。

1. 準備 (基礎網址)： Start Tutorial n8n 觸發器會啟動一個 Set n8n 節點，以動態建構內部 Webhook 所需的基礎網址，確保整個 n8n 工作流在測試模式下能流暢運行。


2. 課程 1 (GET 請求)： HTTP Request n8n 節點（顧客）發送一個簡單的 GET 請求，從目標 Webhook n8n 節點（廚房）擷取資料（菜單）。


3. 課程 2 (查詢參數)： 第二個 HTTP Request n8n 節點發送一個 GET 請求，但包含了一個查詢參數 (?extra_cheese=true)。Webhook n8n 節點接收到此參數後，會使用一個 IF n8n 節點來分流執行流程，示範選項如何自訂請求。


4. 課程 3 (POST 請求與內文)： 客戶端發送一個 POST 請求，並在請求內文中包含資料（顧客評論）。伺服器（另一個 Webhook n8n 節點）處理該資料，並使用一個 Set n8n 節點將收到的評論回傳在回應中，以此說明資料的提交方式。


5. 課程 4 (標頭與授權)： 客戶端發送一個需要授權的請求。它在標頭中包含了一個 x-api-key。Webhook n8n 節點使用 IF n8n 節點檢查此金鑰。如果金鑰正確，即授予存取權；否則，會返回錯誤回應。


6. 課程 5 (超時處理)： 最終的 HTTP Request n8n 節點配置了 2 秒的超時時間。對應的 Webhook n8n 節點則配置了 3 秒的 Wait（等待）時間。此請求被設計成因超時而失敗，強調了任何穩健的 n8n 工作流中關鍵的錯誤處理邏輯。

若要使用這個教育性的 n8n 工作流範本，請依照以下簡單步驟操作：

1. 匯入 JSON： 複製提供的 JSON 資料。


2. 在您的 n8n 實例中，點擊「新增」->「從 JSON 匯入」，然後貼上複製的資料。


3. 無需憑證： 由於此 n8n 工作流是獨立運作，且使用內部 Webhook 位址，因此不需要任何外部憑證或 API 金鑰。


4. 執行教學： 點擊右上角的「執行工作流」按鈕，從 n8n 啟動觸發器開始執行整個 n8n 工作流。檢查每一組「顧客」（HTTP Request n8n 節點）和「廚房」（Webhook n8n 節點）的輸出，以實際查看資料流動的情況。

本教學利用了幾個關鍵的 n8n 節點類型來模擬完整的 API 對話：

Manual Trigger (開始教學)： 用於手動啟動工作流執行的初始 n8n 觸發器。
Set (基礎網址、回傳菜單等)： 廣泛用於動態計算 Webhook 呼叫所需的基礎網址，以及製作「廚房」回傳給「顧客」的特定 JSON 回應。
Webhook n8n 節點（廚房）： 作為模擬的 API 伺服器。它會被設定特定的路徑（如 /menu、/order、/review 等）和 HTTP 方法（GET、POST），以監聽來自 HTTP Request n8n 節點的傳入請求。
HTTP Request n8n 節點（顧客）： 作為啟動呼叫的 API 客戶端。這是模擬中的核心 n8n 節點，配置用於展示特定的 API 功能，例如發送查詢參數、使用帶有內文的 POST 方法、加入自訂標頭以及設定請求超時。
IF n8n 節點 (如果加起司、如果已授權)： 根據 Webhook n8n 節點收到的輸入提供流程控制。它會檢查特定的參數（如查詢參數或標頭值），並相應地導向回應。
Wait n8n 節點 (等待 3 秒)： 在課程 5 中用來模擬 API 響應緩慢的情況。此 n8n 節點會將伺服器的回應延遲足夠長的時間（3 秒），以確保客戶端的 HTTP Request n8n 節點超時（2 秒），從而在複雜的 n8n 工作流中展示穩健的超時處理能力。