API de PDF de Macaaw
API de PDF para comprimir, convertir y firmar
Una API REST para 20 herramientas PDF y firmas electrónicas. Cada tarea se ejecuta en nuestros servidores de Londres y los archivos se eliminan en menos de 2 horas.
Consigue una clave de sandbox gratisLee la documentación de la API
- OpenAPI 3.1
- Colección de Postman
- Sandbox gratuito
- Webhooks firmados
curl https://macaaw.com/public/v1/tasks \
-H "Authorization: API-Key $MACAAW_API_KEY" \
-F "files[]=@lease.pdf" \
-F 'data={"tool":"compress-pdf","options":{"level":"recommended"}}'
# 201 Created
{ "id": "…", "tool": "compress-pdf", "status": "task.queued" }// Node 18+ (fetch, FormData and Blob are built in)
import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("files[]", new Blob([await readFile("lease.pdf")]), "lease.pdf");
form.append("data", JSON.stringify({ tool: "compress-pdf", options: { level: "recommended" } }));
const res = await fetch("https://macaaw.com/public/v1/tasks", {
method: "POST",
headers: { Authorization: `API-Key ${process.env.MACAAW_API_KEY}` },
body: form,
});
const task = await res.json(); // { id, tool, status: "task.queued" }# Python 3 with requests
import json, os, requests
res = requests.post(
"https://macaaw.com/public/v1/tasks",
headers={"Authorization": f"API-Key {os.environ['MACAAW_API_KEY']}"},
files={"files[]": open("lease.pdf", "rb")},
data={"data": json.dumps({"tool": "compress-pdf", "options": {"level": "recommended"}})},
)
task = res.json() # {"id": ..., "status": "task.queued"}- 20herramientas PDF en un solo endpoint
- 1 llamadapara subir e iniciar una tarea
- < 2 hhasta que se eliminan tus archivos
- 0 GBPpara el sandbox
Lo que puedes crear
Las tareas con PDF que tu producto no debería tener que asumir
Reduce las subidas antes de guardarlas
Comprime PDF, o ajústalos a un tamaño exacto, en el momento en que tus usuarios los suben.
Convierte archivos de Office a PDF
De Word, Excel, PowerPoint, OpenDocument y HTML a PDF, con diseños que se mantienen.
Haz que los escaneos tengan búsqueda
Reconocimiento de texto en 27 idiomas, PDF/A para archivos y tablas directamente a Excel.
Envía acuerdos desde tu propia app
Crea un documento a partir de un PDF, coloca campos con etiquetas de texto, envíalo y descarga la copia firmada.
Integra la firma en tu producto
Abre una sesión de firma dentro de tu sitio, limitada a los orígenes que permitas.
Ejecuta lotes con webhooks
Lanza cientos de tareas y recibe una devolución de llamada firmada cuando termine cada una.
Cómo funciona
De la clave al resultado en cuatro llamadas
Crea una clave
Crea una clave de sandbox en tu cuenta. Pasa a una clave real cuando estés listo.
Cuenta › DesarrolladorInicia una tarea
Envía los archivos y la herramienta en una sola solicitud multipart.
POST /public/v1/tasksEntérate cuando termine
Suscríbete a task_completed o consulta la tarea periódicamente.
webhook: task_completedDescarga
Obtén el resultado y después elimínalo o deja que caduque.
GET /tasks/{id}/download
Endpoints
Una API pequeña y predecible
URL base https://macaaw.com/public/v1 · JSON con claves en snake_case · Authorization: API-Key …
Tareas · herramientas PDF
- GET
/toolsTodas las herramientas que puedes llamar, con sus opciones - POST
/tasksSube archivos e inicia una herramienta en una sola llamada - GET
/tasks/{id}Estado: en cola, procesando, completada o fallida - GET
/tasks/{id}/downloadEl archivo de resultado, o un ZIP - DELETE
/tasks/{id}Elimina los archivos ahora
Documentos · firmas electrónicas
- POST
/documentsUn PDF más destinatarios y campos, o etiquetas de texto - POST
/documents/{id}/sendEnvío por correo, o silencioso para la firma integrada - GET
/documents/{id}/detailsDestinatarios, campos y la cronología completa - POST
/documents/{id}/sessionUn enlace de firma para tu propia página - GET
/documents/{id}/downloadEl PDF firmado con su certificado
Webhooks
- POST
/webhook-subscriptionsElige desencadenantes como task_completed o document_state_changed - GET
/webhook-eventsHistorial de envíos, con reenvío
Seguridad
Pensada para producción desde el primer día
Las mismas reglas de eliminación y el mismo procesamiento en el Reino Unido que el sitio web, además de los controles que espera un equipo de ingeniería.
- Claves que controlas túClaves reales y de sandbox, que se muestran una sola vez y se guardan como hash. Revoca cualquier clave desde tu cuenta.
- Webhooks firmadosCada envío lleva ?signature= con un HMAC-SHA256 del cuerpo, generado con tu clave compartida.
- Archivos eliminados rápidoLos archivos de las tareas se conservan 1 hora en una cuenta gratuita y 2 horas en Pro y Business, y después desaparecen. DELETE los elimina al instante.
- Procesamiento en el Reino UnidoCada tarea se ejecuta en nuestros servidores de Londres. Los registros de solicitudes nunca guardan el contenido ni los nombres de los archivos.
- Límites de frecuencia justos120 tareas nuevas por minuto y por usuario, con Retry-After en cada 429.
- Reintentos segurosEnvía una Idempotency-Key y una solicitud repetida devuelve el primer resultado durante 24 horas.
Precios
Empieza gratis. Paga a medida que creces.
Sandbox
0 GBP
- Todos los endpoints, con datos de prueba
- 10 solicitudes por minuto
- Hasta 5 páginas por tarea
- Resultados con el sello “Sandbox”
- Datos de prueba eliminados a los 7 días
Real, con Pro o Business
Desde 4,99 GBPal mes, facturado anualmente
- Usa los límites mensuales de tu plan
- Después, créditos: desde 5 GBP por 500
- 1 crédito por página de OCR, 2 créditos por conversión de Office
- 120 tareas nuevas por minuto
Enterprise
Precios por volumen
- Precios por volumen en páginas y conversiones
- Límites personalizados, vendidos por contrato
- Facturación anual con factura
- Un contacto asignado
Preguntas
Lo que preguntan los desarrolladores
¿Hay alguna forma gratuita de probar la API?
Sí. Cualquier usuario con sesión iniciada puede crear una clave de sandbox gratis. Las llamadas de sandbox están limitadas a 10 por minuto y 5 páginas por tarea, todos los resultados llevan el sello “Sandbox” y los datos de prueba se eliminan a los 7 días.
¿Qué herramientas puedo llamar?
Las 20 herramientas que se ejecutan en nuestros servidores, desde Comprimir y OCR hasta las conversiones de Office y PDF/A, además de las firmas electrónicas. GET /tools las lista con sus opciones. Las 20 herramientas de navegador se ejecutan en los navegadores de tus usuarios, por lo que no están en la API v1.
¿Cómo se cobra el uso de la API?
Las claves reales vienen con Pro y Business. Las llamadas usan los mismos límites mensuales que el sitio web; por encima de ellos se aplican créditos. Los paquetes de créditos empiezan en 5 GBP por 500 créditos y duran 12 meses.
¿Tenéis SDK?
La documentación incluye ejemplos para copiar y pegar en curl, Node y Python para cada endpoint, un archivo OpenAPI 3.1 y una colección de Postman, para que puedas generar un cliente en cualquier lenguaje.
¿Qué pasa si mi endpoint de webhook no está disponible?
Lo reintentamos tres veces más, al cabo de 1 minuto, 10 minutos y 1 hora, y después marcamos el envío como fallido. Puedes reenviarlo desde tu cuenta o con la API.
Lanza funciones PDF esta semana.
Crea una clave de sandbox en un minuto. Sin tarjeta.