連接 Pipedream

Pipedream 中的 Bannerify 應用程式有三個動作。其中兩個會繪製範本並回傳檔案的連結，第三個則會列出你的範本。這個應用程式沒有觸發程序，所以請用任何 Pipedream 觸發程序來啟動工作流程。

動作

動作	功能	欄位
Render Image	把範本繪製成 PNG、JPEG 或 WebP 檔案	Template ID、Format、Modifications JSON
Render PDF	把範本繪製成 PDF 檔案	Template ID、Modifications JSON
List Templates	列出你工作區中的範本	Include Layers

Render Image 和 Render PDF 會回傳含有 url 欄位的物件。Bannerify 會把檔案儲存在它的 CDN 上，每次執行計為一次生成。List Templates 不計算。

先決條件

• 一個 Pipedream 帳號。
• 一組 Bannerify API 金鑰。
• 一個有命名圖層的範本。名稱為什麼很重要，請見 Modifications。

繪製檔案

1. 在你的工作流程中，於觸發程序之後新增一個步驟，並搜尋 Bannerify。
2. 選擇 Render Image 或 Render PDF。
3. 連接你的帳號，並貼上你的 API 金鑰。
4. 在 Template ID 中選擇範本。清單會顯示擁有該金鑰的工作區中的範本名稱。
5. 對於 Render Image，請選擇 Format：png、jpeg 或 webp。預設為 png。
6. 在 Modifications JSON 中輸入值。這個欄位是選填的。請用 Pipedream 運算式引用前面步驟的資料：

{
  "headline": "{{steps.trigger.event.body.title}}",
  "photo": { "src": "{{steps.trigger.event.body.imageUrl}}" }
}

7. 測試這個步驟。結果中會有 url 欄位。

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

找出圖層名稱

開啟 Include Layers 並執行 List Templates，就能看到每個範本的圖層。請把圖層名稱當作 Modifications JSON 中的鍵。

疑難排解

問題	處理方式
步驟因 Invalid JSON in modifications 而失敗	請確認 Modifications JSON 是有效的 JSON，可以是像 {"headline":"Hello"} 這樣的物件，或陣列格式
Template ID 清單是空的	請確認 API 金鑰屬於擁有這些範本的工作區
某個圖層沒有變更	請在編輯器中檢查圖層名稱。名稱有區分大小寫，API 會忽略不存在的名稱
步驟因用量上限訊息而失敗	工作區已達到每日或每月上限。請見用量額度與限制