Saltar al contenido principal

Encuentra tu próxima herramienta

PanelApp para Android
Idioma
Apariencia
API para desarrolladores y automatización

Crea automatización de documentos sobre MAXScanner

Una API REST para convertir, unir y aplicar OCR a documentos, con compatibilidad completa con Zapier, Make y n8n. Empieza gratis, sin tarjeta de crédito.

Inicio rápido

  1. Inicia sesión y abre tu Panel; después ve a API y automatización → Claves de API → Crear clave nueva.
  2. Copia la clave (solo se muestra una vez); tiene este aspecto: mxs_xxxxxxxx_xxxxxxxxxxxx.
  3. Envíala como token Bearer en cada solicitud: 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
EN VIVO

Prueba la API ahora mismo

Esto llama al endpoint real /api/v1/sandbox/convert y convierte un pequeño documento de demostración generado al momento. No necesitas clave de API, y solo funciona desde esta página de maxscanner.app, así que no puede incrustarse ni extraerse en otro sitio.

Límites de uso y créditos gratuitos

PLAN GRATUITO

10 / día

y 100 solicitudes al mes, gratis para siempre. Sin tarjeta de crédito.

PLANES DE PAGO

2000 – ilimitado

Starter (2000 créditos/mes), Pro (10 000/mes), Business (ilimitado).

Los planes de pago gastan créditos por operación:

Convertir — 2 créditosUnir — 1 créditoOCR — 3 créditosConsulta de uso — gratis

Endpoints

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

GET/healthgratis, sin clave

Comprueba que la API está activa; útil para el paso «Probar conexión» de Zapier.

RESPUESTA

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

Consulta tu plan actual y la cuota restante de la clave que envías.

RESPUESTA

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

Convierte un documento de una URL a otro formato (pdf, docx, xlsx, pptx, txt, html, png, ...).

CUERPO DE LA SOLICITUD

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

RESPUESTA

Archivo binario (el Content-Type coincide con el formato solicitado)
POST/merge1 crédito

Une de 2 a 20 PDF (indicados como URL) en un solo PDF, en el orden indicado.

CUERPO DE LA SOLICITUD

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

RESPUESTA

Archivo binario (application/pdf)
POST/ocr3 créditos

Extrae texto de una imagen o un PDF escaneado con OCR real; funciona incluso sin capa de texto.

CUERPO DE LA SOLICITUD

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

RESPUESTA

{ "text": "...", "pages": 3, "language": "eng" }
POST/documents/import1 crédito

Envía un archivo A tu biblioteca de MAXScanner desde una automatización: la dirección contraria a /convert.

CUERPO DE LA SOLICITUD

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

RESPUESTA

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

Registra una URL de webhook para recibir futuros eventos de un tipo. Consulta «Webhooks, Zapier y n8n» más abajo.

CUERPO DE LA SOLICITUD

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

RESPUESTA

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

Elimina una suscripción de webhook por su id.

CUERPO DE LA SOLICITUD

{ "id": "..." }

RESPUESTA

{ "success": true }
GET/hooksgratis

Muestra tus suscripciones de webhook activas, con el estado de la última entrega de cada una.

RESPUESTA

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

/convert ADMITE (NO SOLO FORMATOS DE OFFICE)

Word / Excel / PowerPointPDFel clásico «Office a PDF»
PDFWord / texto sin formato / HTML«PDF a Office»
PDFImagen PNG / JPGuna imagen por página
Imagen PNG / JPGPDFconvierte una imagen en una página PDF

Zapier, Make, n8n y webhooks

Conecta la app MAXScanner para Android con más de 5000 aplicaciones. En la app, abre Ajustes → Zapier y automatización (o el mosaico API y automatización en Herramientas) para suscribirte y obtener tu clave de integración; después úsala como clave de API de MAXScanner en el paso de conexión de Zapier. La misma clave también sirve para las llamadas REST directas de arriba.

DISPARADORES DISPONIBLES

Nuevo documento escaneadoscan.createdTodos los planes

Se activa cada vez que se escanea un documento nuevo en la app.

Nueva exportación a PDFpdf.exportedTodos los planes

Se activa cuando un grupo de documentos se exporta a PDF.

Nuevo escaneo geoetiquetadogeotag.capturedPro y superiores

Se activa con los escaneos que incluyen datos de ubicación (dirección, ciudad, coordenadas).

Nueva captura con marca de tiempotimestamp.capturedBusiness

Se activa con las capturas que llevan marca de tiempo.

Nuevo texto OCR extraídoocr.completedPro y superiores

Se activa cuando el texto OCR del dispositivo está disponible para un escaneo.

Nuevo código QR escaneadoqr.scannedTodos los planes

Se activa en cuanto se escanea un código QR en la app, con el texto decodificado.

Make.com

Escenarios de automatización visual

n8n

Automatización de flujos autoalojada

Webhooks

Callbacks HTTP directos para todo lo demás

Las tres plataformas funcionan igual aquí: te dan una URL y le indicas a MAXScanner que envíe un POST a ella mediante /hooks/subscribe. Todavía no hay una app nativa de Zapier que instalar: se usa la acción genérica Webhooks by Zapier de Zapier, que ya funciona hoy.

⚡ Zapier paso a paso

  1. Crea un Zap → busca la app Webhooks by Zapier → elige el evento disparador Catch Hook.
  2. Zapier te muestra una URL de webhook personalizada (p. ej., https://hooks.zapier.com/hooks/catch/...). Cópiala.
  3. Llama una vez a /hooks/subscribe de MAXScanner con esa URL y el evento que quieras (consulta el ejemplo de curl más abajo).
  4. De vuelta en Zapier, provoca un evento de prueba desde la app (por ejemplo, escanea un documento): el paso Catch Hook debería mostrar datos de ejemplo. Continúa creando la acción de tu Zap desde ahí (Google Drive, Sheets, Slack, correo, lo que necesites).

🔄 n8n paso a paso

  1. Añade un nodo disparador Webhook a un flujo nuevo. Configúralo para aceptar solicitudes POST.
  2. Copia la Production URL del nodo (activa antes el flujo para que esté en marcha).
  3. Llama a /hooks/subscribe con esa URL y el evento que elijas.
  4. Provoca un evento de prueba desde la app: el nodo Webhook recibe la carga útil, lista para conectarla al resto de tu flujo.

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

¿Listo para automatizar tus documentos?

Crea una clave de API gratuita: 10 solicitudes al día, 100 al mes, sin tarjeta.