提議更新:統一材料中 HTTP 節點和 HTTP 代理工具設定憑證的指引

您好 n8n 學院團隊,

我最近看到兩篇文章提出了 QS101: 快速入門第 3 節 中的問題:

解決後,我注意到這個問題來自於學生在課程第 2 節和第 3 節之間移動時遺失上下文,以及第 3 節說明中缺失的資訊。

根本原因是那些 HTTP 節點需要兩個 HTTP 標頭(x-assessment-idX-API-KEY)。在第 2 節中,課程引導使用者透過「傳送標頭」新增 x-assessment-id,並透過認證新增 X-API-KEY

不過,在第 3 節中,說明建議要麼重複使用第 2 節的認證,要麼在認證中新增 x-assessment-id這與第 2 節的說明相反),而且根本沒有提到 X-API-KEY

有個學生誤讀了,把他們目前的認證從 X-API-KEY 改成了 x-assessment-id,這也導致他們在第 2 節的工作出錯,而且他們不知道怎麼修復。

關於重複使用認證,學生無法簡單地複製並貼上節點,因為第 3 節是將 HTTP 請求用作代理工具,而不是一般節點。因此,他們必須新增新的 HTTP 工具、重新設定認證,並且很可能會錯過「傳送標頭」欄位。

我提議了幾種方式可以減少這個問題:

(1) 統一這兩個節點的教材,指導哪個鍵值對應放在認證內,哪個放在「傳送標頭」內。

(2) 在第 3 節中,我們可以再明確指導他們一次如何設定認證,就像我們在第 2 節所做的一樣。這將是一次性的複製貼上,只需要在第 3 節進行更改。我也注意到了基礎課程中的這種模式,所以我們可以遵循這種方法。

(3) 不太可能,但我們可以指導學生使用多標頭認證。這是我的偏好,因為學生可以清楚地看到並管理兩個標頭為一體,而不需要他們費力去理解認證標頭和傳送標頭會被合併這一事實,這只有在身份驗證方法使用標頭時才是正確的。它也避免了學生需要複製並貼上 HTTP 節點來重複使用的必要,這本來是為了防止學生遺漏「傳送標頭」欄位,但正如我在學生無法複製 HTTP 節點到 HTTP 代理工具的情況下所提及的,這可能會被破壞。但這個解決方案需要改變和審計大量的教材,所以我認為這不值得。

感謝你的建議。

  1. 我已在第 3 節添加了更多資訊。
  2. 已更新
  3. 我不想在初級課程中引入自訂標頭。目的是透過重複來加強學習。這就像我要求你每次都命名和標記你的工作流程,每次都命名你的節點一樣。設定一個認證資訊的問題是他們可能會忘記它。當你剛開始時,不斷重複做這些事,你就會記住要這樣做。

乾杯,

謝謝你,Jamie,幫我看了一下。我同意你在第 3 點的看法。

我想補充的是,在 第 3 節 增加了更多資訊後,第 6 個舊步驟(如下方截圖)變得多餘且有衝突,所以我認為我們可以考慮把它移除。

@kristinker

這已經修復了。

乾杯,