본문으로 건너뛰기

다음 도구 찾기

문서/자동화/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으로 시작하는 별도 시나리오를 만들고 웹훅 주소를 복사합니다.
  4. 4POST /api/v1/hooks/subscribe/ 요청(event는 processing.completed)으로 그 주소를 한 번만 구독합니다.
  5. 5웹훅 시나리오에서 HTTP → Make a request를 추가해 Authorization 헤더와 함께 GET {{data.statusUrl}} 요청을 보낸 다음 output.downloadUrl을 다음 모듈로 전달합니다.

요청 본문

Idempotency-Key에는 번들의 레코드 ID처럼 항목마다 고유한 값을 매핑하십시오. 그러면 실패한 시나리오를 다시 실행해도 중복 작업이 생성되지 않습니다.

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

한 시나리오 안에서 폴링하기

웹훅을 사용할 수 없다면 Sleep 모듈(5~10초)과, status가 completed 또는 failed가 되면 멈추는 라우터가 있는 Repeater를 추가하십시오. 이 방식은 웹훅 패턴보다 오퍼레이션과 MaxScanner 요청을 더 많이 사용하므로 처리량이 적을 때만 사용하십시오.

오류 처리

HTTP 모듈에 오류 처리기를 연결하십시오. 429와 5xx 응답에는 자동 재시도가 설정된 Break를, 수정이 필요한 4xx 응답에는 Ignore 또는 Rollback을 사용합니다. Make는 모듈 출력에 MaxScanner 오류 코드를 표시합니다.

자주 묻는 질문

URL 대신 파일 바이너리를 보낼 수 있습니까?

예. /extension/upload/ 를 호출해 서명된 URL을 받고, 두 번째 HTTP 모듈로 바이너리를 PUT한 다음, 반환된 objectKey를 sourceKey로 사용합니다.

관련 가이드