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 キーを作成します。
- 2HTTP → Make a request を追加し、POST https://maxscanner.app/api/v1/jobs/ を設定します。ヘッダーは Authorization と Idempotency-Key、ボディは url、filename、format を含む JSON です。"Parse response" をオンにします。
- 3Webhooks → Custom webhook で始まる別のシナリオを作成し、Webhook のアドレスをコピーします。
- 4POST /api/v1/hooks/subscribe/(event は processing.completed)で、そのアドレスを一度だけサブスクライブします。
- 5Webhook のシナリオで HTTP → Make a request を追加し、Authorization ヘッダーを付けて GET {{data.statusUrl}} を送信してから、output.downloadUrl を次のモジュールに渡します。
リクエストボディ
Idempotency-Key には、バンドルのレコード ID など項目ごとに一意の値をマッピングしてください。失敗したシナリオを再実行しても、重複したジョブが作成されなくなります。
{
"url": "{{1.attachment.url}}",
"filename": "{{1.attachment.name}}",
"format": "pdf"
}1 つのシナリオ内でのポーリング
Webhook を使えない場合は、Sleep モジュール(5〜10 秒)と、status が completed または failed になったら停止するルーター付きの Repeater を追加します。この方法は Webhook のパターンよりも多くのオペレーションと MaxScanner のリクエストを消費するため、処理量が少ない場合に限って使ってください。
エラー処理
HTTP モジュールにエラーハンドラーを設定します。429 と 5xx のレスポンスには自動再試行付きの Break を、修正が必要な 4xx のレスポンスには Ignore または Rollback を使います。Make のモジュール出力には、MaxScanner のエラーコードが表示されます。
よくある質問
URL の代わりにファイルのバイナリを送信できますか?
はい。/extension/upload/ を呼び出して署名付き URL を取得し、2 つ目の HTTP モジュールでバイナリを PUT してから、返された objectKey を sourceKey として使います。