빠른 시작
- 로그인한 뒤 대시보드을 열고 API 및 자동화 → API 키 → 새 키 만들기로 이동하세요.
- 키를 복사하세요(한 번만 표시됩니다). 형식은
mxs_xxxxxxxx_xxxxxxxxxxxx와 같습니다. - 모든 요청에 Bearer 토큰으로 보내세요:
Authorization: Bearer YOUR_API_KEY.
curl -X POST https://maxscanner.app/api/v1/convert \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/report.docx","filename":"report.docx","format":"pdf"}' \
--output report.pdf지금 바로 API 사용해 보기
실제 /api/v1/sandbox/convert 엔드포인트를 호출해 즉석에서 만든 작은 데모 문서를 변환합니다. API 키가 필요 없으며 maxscanner.app의 이 페이지에서만 동작하므로 다른 곳에 삽입하거나 무단으로 사용할 수 없습니다.
사용 한도와 무료 크레딧
무료 요금제
하루 10회
월 100회 요청까지 평생 무료입니다. 신용카드가 필요 없습니다.
유료 요금제
2,000회 – 무제한
Starter(월 2,000 크레딧), Pro(월 10,000), Business(무제한).
유료 요금제는 작업마다 크레딧을 사용합니다:
엔드포인트
기본 URL: https://maxscanner.app/api/v1
/health무료, 키 불필요API가 작동 중인지 확인합니다. Zapier의 “연결 테스트” 단계에 유용합니다.
응답
{ "status": "ok", "service": "MAXScanner Public API", "version": "v1" }/usage무료보낸 키의 현재 요금제와 남은 할당량을 확인합니다.
응답
{ "plan": "Free", "limits": { "per_day": 10, "per_month": 100 },
"remaining": { "today": 7, "this_month": 84 } }/convert2 크레딧URL에 있는 문서를 다른 형식(pdf, docx, xlsx, pptx, txt, html, png 등)으로 변환합니다.
요청 본문
{ "url": "https://example.com/report.docx",
"filename": "report.docx", "format": "pdf" }응답
바이너리 파일(Content-Type은 요청한 형식과 일치)/merge1 크레딧URL로 지정한 PDF 2~20개를 지정한 순서대로 하나의 PDF로 병합합니다.
요청 본문
{ "files": ["https://.../page1.pdf", "https://.../page2.pdf"] }응답
바이너리 파일 (application/pdf)/ocr3 크레딧스캔한 이미지나 PDF에서 실제 OCR로 텍스트를 추출합니다. 텍스트 레이어가 전혀 없어도 작동합니다.
요청 본문
{ "url": "https://.../scan.pdf", "filename": "scan.pdf", "language": "eng" }응답
{ "text": "...", "pages": 3, "language": "eng" }/documents/import1 크레딧자동화에서 파일을 MAXScanner 라이브러리로 가져옵니다. /convert와는 반대 방향입니다.
요청 본문
{ "url": "https://.../invoice.pdf", "filename": "invoice.pdf" }응답
{ "id": "...", "filename": "invoice.pdf", "downloadUrl": "..." }/hooks/subscribe무료한 가지 유형의 이후 이벤트를 받을 웹훅 URL을 등록합니다. 아래의 “웹훅, Zapier, n8n”을 참고하세요.
요청 본문
{ "event": "scan.created", "targetUrl": "https://hooks.zapier.com/..." }응답
{ "id": "...", "event": "scan.created", "targetUrl": "..." }/hooks/unsubscribe무료id로 웹훅 구독을 삭제합니다.
요청 본문
{ "id": "..." }응답
{ "success": true }/hooks무료활성 웹훅 구독과 각 구독의 마지막 전송 상태를 나열합니다.
응답
{ "subscriptions": [{ "id": "...", "event": "scan.created", "targetUrl": "..." }] }/convert 지원 형식(Office 형식만이 아닙니다)
Zapier, Make, n8n 및 웹훅
MAXScanner Android 앱을 5,000개 이상의 앱과 연결하세요. 앱에서 설정 → Zapier 및 자동화(또는 도구의 API 및 자동화 타일)를 열어 구독하고 연동 키를 받은 뒤, Zapier 연결 단계에서 MAXScanner API 키로 사용하세요. 같은 키로 위의 REST 직접 호출도 할 수 있습니다.
사용 가능한 트리거
새 스캔 문서scan.created모든 요금제
앱에서 새 문서를 스캔할 때마다 실행됩니다.
새 PDF 내보내기pdf.exported모든 요금제
문서 그룹을 PDF로 내보낼 때 실행됩니다.
새 위치 태그 스캔geotag.capturedPro 이상
위치 정보(주소, 도시, 좌표)가 태그된 스캔에서 실행됩니다.
새 타임스탬프 촬영timestamp.capturedBusiness
타임스탬프가 찍힌 촬영에서 실행됩니다.
새 OCR 텍스트 추출ocr.completedPro 이상
스캔의 기기 내 OCR 텍스트를 사용할 수 있게 되면 실행됩니다.
새 QR 코드 스캔qr.scanned모든 요금제
앱에서 QR 코드를 스캔하는 즉시 디코딩된 텍스트와 함께 실행됩니다.
Make.com
시각적 자동화 시나리오
n8n
셀프 호스팅 워크플로 자동화
웹훅
그 밖의 모든 것을 위한 직접 HTTP 콜백
세 플랫폼은 여기서 모두 같은 방식으로 작동합니다. 각 플랫폼이 URL을 제공하면 /hooks/subscribe로 MAXScanner가 해당 URL에 POST하도록 지정합니다. 아직 설치할 Zapier 기본 앱은 없으며, 지금 바로 작동하는 Zapier의 범용 Webhooks by Zapier 액션을 사용합니다.
⚡ Zapier 단계별 안내
- Zap 만들기 → Webhooks by Zapier 앱 검색 → 트리거 이벤트로 Catch Hook을 선택합니다.
- Zapier가 전용 웹훅 URL(예:
https://hooks.zapier.com/hooks/catch/...)을 보여 줍니다. 복사하세요. - 그 URL과 원하는 이벤트로 MAXScanner의
/hooks/subscribe를 한 번 호출합니다(아래 curl 예시 참고). - Zapier로 돌아가 앱에서 테스트 이벤트를 발생시키세요(예: 문서 스캔). Catch Hook 단계에 샘플 데이터가 표시됩니다. 거기서 Zap의 작업 단계(Google Drive, Sheets, Slack, 이메일 등)를 계속 만들면 됩니다.
🔄 n8n 단계별 안내
- 새 워크플로에 Webhook 트리거 노드를 추가하고 POST 요청을 받도록 설정합니다.
- 노드의 Production URL을 복사합니다(먼저 워크플로를 활성화해 실행 상태로 두세요).
- 그 URL과 선택한 이벤트로
/hooks/subscribe를 호출합니다. - 앱에서 테스트 이벤트를 발생시키면 Webhook 노드가 페이로드를 받아 워크플로의 나머지 단계에 연결할 수 있습니다.
curl로 구독하기
curl -X POST https://maxscanner.app/api/v1/hooks/subscribe \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"event":"scan.created","targetUrl":"https://hooks.zapier.com/hooks/catch/.../..."}'