連接 n8n

Bannerify 節點會繪製範本，並回傳檔案的連結。每個進入節點的項目都會執行一次，所以收到 20 個項目的節點會產生 20 個檔案。這個套件是 npm 上的 n8n-nodes-bannerify。

操作

操作	輸出	欄位
Render Image	PNG、JPEG 或 WebP 檔案	Template、Format、Modifications JSON
Render PDF	PDF 檔案	Template、Modifications JSON

兩個操作都會回傳含有 url 欄位的物件。Bannerify 會把檔案儲存在它的 CDN 上，每個檔案計為一次生成。

先決條件

• 一個可以安裝社群節點的 n8n 帳號。n8n 將此限制在 Owner 和 Admin 角色。
• 一組 Bannerify API 金鑰。
• 一個有命名圖層的範本。名稱為什麼很重要，請見 Modifications。

安裝節點

1. 在 n8n 中開啟 Settings，再開啟 Community nodes。
2. 點選 Install。
3. 輸入 n8n-nodes-bannerify 作為 npm 套件名稱。
4. 接受未經驗證程式碼的風險提示，然後點選 Install。

新增你的 API 金鑰

1. 在工作流程中新增一個 Bannerify 節點，並為它建立新的憑證。憑證類型是 Bannerify API。
2. 把你的金鑰貼到 API Key。
3. API Base URL 請維持 https://api.bannerify.co。
4. 儲存憑證。

繪製檔案

1. 選擇 Operation：Render Image 或 Render PDF。
2. 在 Template 中選擇範本。節點會載入擁有該金鑰的工作區中的範本。
3. 對於 Render Image，請選擇 Format。預設為 PNG，另外還有 JPEG 和 WebP 可選。
4. 在 Modifications JSON 中輸入值。請使用運算式來讀取前面節點的資料：

{
  "headline": "{{ $json.title }}",
  "photo": { "src": "{{ $json.imageUrl }}" }
}

5. 執行節點。每個輸出項目都有 url 欄位。

這個欄位接受以圖層名稱為鍵的物件，或 API 所使用的陣列。每種圖層類型會讀取哪些欄位，請見 Modifications。

如果繪製失敗，節點會停止工作流程。當你把節點設為發生錯誤時繼續，失敗的項目會有含有錯誤訊息的 error 欄位。

範例：把表單回覆變成 PDF

1. 新增 Webhook 觸發程序，並讓你的表單工具指向它的網址。
2. 新增 Bannerify 節點，並選擇 Render PDF。在 Modifications JSON 中，把回覆對應到圖層名稱。
3. 新增 Send Email 節點，並把 url 放進訊息中。

疑難排解

問題	處理方式
Template 清單是空的	請確認 API 金鑰屬於擁有這些範本的工作區，且 API Base URL 是 https://api.bannerify.co
某個圖層沒有變更	請在編輯器中檢查圖層名稱。名稱有區分大小寫，API 會忽略不存在的名稱
節點因 JSON 錯誤而失敗	請確認 Modifications JSON 是有效的 JSON
節點因用量上限訊息而失敗	工作區已達到每日或每月上限。每個項目計為一次生成。請見用量額度與限制