跳至主要內容

尋找下一個工具

控制台Android 應用程式
語言
外觀
開發者 API 與自動化

以 MAXScanner 打造文件自動化

用於文件轉換、合併與 OCR 的 REST API，並完整支援 Zapier、Make 與 n8n。免費開始，無需信用卡。

快速開始

  1. 登入並開啟你的儀表板，然後前往 API 與自動化 → API 金鑰 → 建立新金鑰。
  2. 複製金鑰（只會顯示一次），格式類似 mxs_xxxxxxxx_xxxxxxxxxxxx。
  3. 在每個請求中以 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（無限制）。

付費方案依操作扣除點數：

轉換 — 2 點合併 — 1 點OCR — 3 點用量查詢 — 免費

端點

基本 URL： https://maxscanner.app/api/v1

GET/health免費，無需金鑰

檢查 API 是否正常運作，適合用於 Zapier 的「測試連線」步驟。

回應

{ "status": "ok", "service": "MAXScanner Public API", "version": "v1" }
GET/usage免費

查看所傳送金鑰的目前方案與剩餘配額。

回應

{ "plan": "Free", "limits": { "per_day": 10, "per_month": 100 },
  "remaining": { "today": 7, "this_month": 84 } }
POST/convert2 點

將 URL 上的文件轉換為其他格式（pdf、docx、xlsx、pptx、txt、html、png 等）。

請求本文

{ "url": "https://example.com/report.docx",
  "filename": "report.docx", "format": "pdf" }

回應

二進位檔案（Content-Type 與要求的格式相符）
POST/merge1 點

依指定順序將 2–20 個 PDF（以 URL 提供）合併為一個 PDF。

請求本文

{ "files": ["https://.../page1.pdf", "https://.../page2.pdf"] }

回應

二進位檔案 (application/pdf)
POST/ocr3 點

以真正的 OCR 從掃描圖片或 PDF 擷取文字，即使完全沒有文字層也能使用。

請求本文

{ "url": "https://.../scan.pdf", "filename": "scan.pdf", "language": "eng" }

回應

{ "text": "...", "pages": 3, "language": "eng" }
POST/documents/import1 點

從自動化流程把檔案匯入你的 MAXScanner 文件庫，與 /convert 方向相反。

請求本文

{ "url": "https://.../invoice.pdf", "filename": "invoice.pdf" }

回應

{ "id": "...", "filename": "invoice.pdf", "downloadUrl": "..." }
POST/hooks/subscribe免費

註冊 Webhook URL，以接收某一類型的後續事件。請參閱下方的「Webhook、Zapier 與 n8n」。

請求本文

{ "event": "scan.created", "targetUrl": "https://hooks.zapier.com/..." }

回應

{ "id": "...", "event": "scan.created", "targetUrl": "..." }
POST/hooks/unsubscribe免費

依 id 移除 Webhook 訂閱。

請求本文

{ "id": "..." }

回應

{ "success": true }
GET/hooks免費

列出目前有效的 Webhook 訂閱，以及每個訂閱最近一次傳送的狀態。

回應

{ "subscriptions": [{ "id": "...", "event": "scan.created", "targetUrl": "..." }] }

/convert 支援（不只是 Office 格式）

Word / Excel / PowerPointPDF經典的「Office 轉 PDF」
PDFWord / 純文字 / HTML「PDF 轉 Office」
PDFPNG / JPG 圖片每頁一張圖片
PNG / JPG 圖片PDF將圖片轉成 PDF 頁面

Zapier、Make、n8n 與 Webhook

將 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

自架工作流程自動化

Webhook

用於其他一切的直接 HTTP 回呼

這三個平台在這裡的用法相同：它們提供一個 URL，你透過 /hooks/subscribe 讓 MAXScanner 向該 URL 傳送 POST。目前還沒有可安裝的 Zapier 原生應用程式，使用的是 Zapier 內建的通用動作 Webhooks by Zapier，現在就能使用。

⚡ Zapier 逐步說明

  1. 建立 Zap → 搜尋 Webhooks by Zapier 應用程式 → 選擇觸發事件 Catch Hook。
  2. Zapier 會顯示專屬的 Webhook URL（例如 https://hooks.zapier.com/hooks/catch/...），請複製。
  3. 以該 URL 和所需事件呼叫一次 MAXScanner 的 /hooks/subscribe（請參閱下方 curl 範例）。
  4. 回到 Zapier，在應用程式中觸發測試事件（例如掃描一份文件），Catch Hook 步驟應會顯示範例資料。接著繼續建立 Zap 的動作步驟（Google 雲端硬碟、試算表、Slack、電子郵件等）。

🔄 n8n 逐步說明

  1. 在新的工作流程中加入 Webhook 觸發節點，並設定為接受 POST 請求。
  2. 複製節點的 Production URL（請先啟用工作流程，讓它處於上線狀態）。
  3. 以該 URL 和選定的事件呼叫 /hooks/subscribe。
  4. 在應用程式中觸發測試事件，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/.../..."}'

準備好自動化你的文件了嗎？

建立免費 API 金鑰：每天 10 次、每月 100 次請求，無需信用卡。