跳至主要內容

尋找下一個工具

說明文件/自動化/Make(Integromat):MaxScanner 情境
自動化

Make(Integromat):MaxScanner 情境

在任意情境中使用 Make 的 HTTP 和 Webhooks 模組,藉助 MaxScanner 對檔案進行轉換、壓縮和 OCR。

簡要回答

在 Make 中新增 HTTP 的「Make a request」模組:method 設為 POST,URL 設為 https://maxscanner.app/api/v1/jobs/,新增請求標頭 Authorization: Bearer <key>,body type 選 Raw,content type 選 JSON。請將金鑰儲存在 Make 連線或資料存放區中,而不是放在與他人共享的一般模組欄位裡。要接收完成通知,請建立一個使用 Webhooks「Custom webhook」的情境,並將其網址訂閱到 processing.completed。

快速入門

  1. 1建立一個名為「Make」的 MaxScanner API 金鑰。
  2. 2新增 HTTP → Make a request:POST https://maxscanner.app/api/v1/jobs/,請求標頭為 Authorization 和 Idempotency-Key,請求主體為包含 url、filename、format 的 JSON。開啟「Parse response」。
  3. 3建立一個以 Webhooks → Custom webhook 開始的獨立情境,並複製 Webhook 網址。
  4. 4透過 POST /api/v1/hooks/subscribe/(event 為 processing.completed)將該網址訂閱一次。
  5. 5在 Webhook 情境中,新增 HTTP → Make a request:GET {{data.statusUrl}},並攜帶 Authorization 請求標頭,然後將 output.downloadUrl 傳給下一個模組。

請求主體

將 Idempotency-Key 對應為每個項目唯一的值,例如 bundle 的記錄 ID,這樣重新執行失敗的情境時就不會建立重複的工作。

{
  "url": "{{1.attachment.url}}",
  "filename": "{{1.attachment.name}}",
  "format": "pdf"
}

在單一情境內輪詢

如果無法使用 Webhook,請新增一個 Sleep 模組(5–10 秒)和一個 Repeater,並配合一個在 status 為 completed 或 failed 時停止的 Router。這種方式比 Webhook 模式消耗更多的 operations 和 MaxScanner 請求次數,因此只適合低流量的情境。

錯誤處理

為 HTTP 模組附加一個錯誤處理器:對 429 和 5xx 回應使用帶自動重試的 Break,對需要修正的 4xx 回應使用 Ignore 或 Rollback。Make 會在模組輸出中顯示 MaxScanner 的錯誤碼。

常見問題

可以傳送檔案的二進位內容,而不是網址嗎?

可以:呼叫 /extension/upload/ 取得簽署網址,用第二個 HTTP 模組 PUT 二進位內容,然後將傳回的 objectKey 作為 sourceKey 使用。

相關指南