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”的场景,并将其 URL 订阅到 processing.completed。
快速入门
- 1创建一个名为“Make”的 MaxScanner API 密钥。
- 2添加 HTTP → Make a request:POST https://maxscanner.app/api/v1/jobs/,请求头为 Authorization 和 Idempotency-Key,请求体为包含 url、filename、format 的 JSON。开启“Parse response”。
- 3创建一个以 Webhooks → Custom webhook 开始的独立场景,并复制 Webhook 地址。
- 4通过 POST /api/v1/hooks/subscribe/(event 为 processing.completed)将该地址订阅一次。
- 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 的错误代码。
常见问题
可以发送文件的二进制内容,而不是 URL 吗?
可以:调用 /extension/upload/ 获取签名 URL,用第二个 HTTP 模块 PUT 二进制内容,然后将返回的 objectKey 作为 sourceKey 使用。