Vai al contenuto principale

Trova il prossimo strumento

DashboardApp Android
Lingua
Aspetto
API per sviluppatori e automazione

Crea automazioni documentali con MAXScanner

Un’API REST per conversione, unione e OCR di documenti, con supporto completo a Zapier, Make e n8n. Inizia gratis, senza carta di credito.

Avvio rapido

  1. Accedi e apri la tua Dashboard, poi vai su API e automazione → Chiavi API → Crea nuova chiave.
  2. Copia la chiave (viene mostrata una sola volta): ha questo aspetto mxs_xxxxxxxx_xxxxxxxxxxxx.
  3. Inviala come token Bearer in ogni richiesta: 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
LIVE

Prova subito l’API

Questo chiama il vero endpoint /api/v1/sandbox/convert e converte un piccolo documento dimostrativo generato al momento. Non serve una chiave API, e funziona solo da questa pagina su maxscanner.app, quindi non può essere incorporato o sfruttato altrove.

Limiti di utilizzo e crediti gratuiti

PIANO GRATUITO

10 / giorno

e 100 richieste al mese, gratis per sempre. Nessuna carta di credito.

PIANI A PAGAMENTO

2.000 – illimitate

Starter (2.000 crediti/mese), Pro (10.000/mese), Business (illimitati).

I piani a pagamento consumano crediti per operazione:

Conversione — 2 creditiUnione — 1 creditoOCR — 3 creditiVerifica utilizzo — gratis

Endpoint

URL di base: https://maxscanner.app/api/v1

GET/healthgratis, senza chiave

Verifica che l’API sia attiva: utile per il passaggio “Test connection” di Zapier.

RISPOSTA

{ "status": "ok", "service": "MAXScanner Public API", "version": "v1" }
GET/usagegratis

Mostra il piano attuale e la quota residua per la chiave inviata.

RISPOSTA

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

Converte un documento raggiungibile tramite URL in un altro formato (pdf, docx, xlsx, pptx, txt, html, png, ...).

CORPO DELLA RICHIESTA

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

RISPOSTA

File binario (il Content-Type corrisponde al formato richiesto)
POST/merge1 credito

Unisce da 2 a 20 PDF (indicati come URL) in un unico PDF, nell’ordine fornito.

CORPO DELLA RICHIESTA

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

RISPOSTA

File binario (application/pdf)
POST/ocr3 crediti

Estrae il testo da un’immagine o un PDF scansionato con un vero OCR, anche senza alcun livello di testo.

CORPO DELLA RICHIESTA

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

RISPOSTA

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

Inserisce un file NELLA tua libreria MAXScanner da un’automazione: la direzione opposta a /convert.

CORPO DELLA RICHIESTA

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

RISPOSTA

{ "id": "...", "filename": "invoice.pdf", "downloadUrl": "..." }
POST/hooks/subscribegratis

Registra un URL webhook per ricevere i futuri eventi di un tipo. Vedi “Webhook, Zapier e n8n” più sotto.

CORPO DELLA RICHIESTA

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

RISPOSTA

{ "id": "...", "event": "scan.created", "targetUrl": "..." }
POST/hooks/unsubscribegratis

Rimuove un’iscrizione webhook tramite il suo id.

CORPO DELLA RICHIESTA

{ "id": "..." }

RISPOSTA

{ "success": true }
GET/hooksgratis

Elenca le iscrizioni webhook attive, con lo stato dell’ultima consegna di ciascuna.

RISPOSTA

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

/convert SUPPORTA (NON SOLO FORMATI OFFICE)

Word / Excel / PowerPointPDFil classico “Office in PDF”
PDFWord / testo semplice / HTML“PDF in Office”
PDFImmagine PNG / JPGun’immagine per pagina
Immagine PNG / JPGPDFtrasforma un’immagine in una pagina PDF

Zapier, Make, n8n e webhook

Collega l’app Android MAXScanner a oltre 5.000 app. Nell’app apri Impostazioni → Zapier e automazione (o il riquadro API e automazione in Strumenti) per abbonarti e ottenere la chiave di integrazione, poi usala come chiave API di MAXScanner nel passaggio di connessione di Zapier: la stessa chiave funziona anche per le chiamate REST dirette indicate sopra.

TRIGGER DISPONIBILI

Nuovo documento scansionatoscan.createdTutti i piani

Si attiva ogni volta che nell’app viene scansionato un nuovo documento.

Nuova esportazione PDFpdf.exportedTutti i piani

Si attiva quando un gruppo di documenti viene esportato in PDF.

Nuova scansione geolocalizzatageotag.capturedPro e superiori

Si attiva per le scansioni con dati di posizione (indirizzo, città, coordinate).

Nuova acquisizione con data e oratimestamp.capturedBusiness

Si attiva per le acquisizioni con marca temporale.

Nuovo testo OCR estrattoocr.completedPro e superiori

Si attiva quando il testo OCR sul dispositivo è disponibile per una scansione.

Nuovo codice QR scansionatoqr.scannedTutti i piani

Si attiva appena un codice QR viene scansionato nell’app, con il testo decodificato.

Make.com

Scenari di automazione visuale

n8n

Automazione dei flussi self-hosted

Webhook

Callback HTTP diretti per tutto il resto

Qui le tre piattaforme funzionano allo stesso modo: ti forniscono un URL e tu chiedi a MAXScanner di inviarvi un POST tramite /hooks/subscribe. Non c’è ancora un’app Zapier nativa da installare: si usa l’azione generica Webhooks by Zapier di Zapier, che funziona già oggi.

⚡ Zapier passo dopo passo

  1. Crea uno Zap → cerca l’app Webhooks by Zapier → scegli l’evento trigger Catch Hook.
  2. Zapier ti mostra un URL webhook personalizzato (ad es. https://hooks.zapier.com/hooks/catch/...). Copialo.
  3. Chiama una volta /hooks/subscribe di MAXScanner con quell’URL e l’evento desiderato (vedi l’esempio curl qui sotto).
  4. Torna in Zapier e genera un evento di prova dall’app (ad es. scansiona un documento): il passaggio Catch Hook dovrebbe mostrare dati di esempio. Da lì continua a costruire l’azione dello Zap (Google Drive, Sheets, Slack, email, qualsiasi cosa).

🔄 n8n passo dopo passo

  1. Aggiungi un nodo trigger Webhook a un nuovo flusso. Impostalo per accettare richieste POST.
  2. Copia la Production URL del nodo (prima attiva il flusso, così è online).
  3. Chiama /hooks/subscribe con quell’URL e l’evento scelto.
  4. Genera un evento di prova dall’app: il nodo Webhook riceve il payload, pronto da collegare al resto del flusso.

Iscriviti con 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/.../..."}'

Pronto ad automatizzare i tuoi documenti?

Crea una chiave API gratuita: 10 richieste al giorno, 100 al mese, senza carta.