您好 n8n 學院團隊,
我最近看到兩篇文章提出了 QS101: 快速入門第 3 節 中的問題:
解決後,我注意到這個問題來自於學生在課程第 2 節和第 3 節之間移動時遺失上下文,以及第 3 節說明中缺失的資訊。
根本原因是那些 HTTP 節點需要兩個 HTTP 標頭(x-assessment-id 和 X-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 代理工具的情況下所提及的,這可能會被破壞。但這個解決方案需要改變和審計大量的教材,所以我認為這不值得。


