メインコンテンツへ移動

次に使うツールを探す

ドキュメント/自動化/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" で始まるシナリオを作成し、その URL を processing.completed にサブスクライブします。

クイックスタート

  1. 1「Make」という名前の MaxScanner API キーを作成します。
  2. 2HTTP → Make a request を追加し、POST https://maxscanner.app/api/v1/jobs/ を設定します。ヘッダーは Authorization と Idempotency-Key、ボディは url、filename、format を含む JSON です。"Parse response" をオンにします。
  3. 3Webhooks → Custom webhook で始まる別のシナリオを作成し、Webhook のアドレスをコピーします。
  4. 4POST /api/v1/hooks/subscribe/(event は processing.completed)で、そのアドレスを一度だけサブスクライブします。
  5. 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 として使います。

関連ガイド