API de PDF
Empieza gratis

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
Comprime un PDF con una sola solicitud
Lenguaje del ejemplo de código
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

  1. Crea una clave

    Crea una clave de sandbox en tu cuenta. Pasa a una clave real cuando estés listo.

    Cuenta › Desarrollador
  2. Inicia una tarea

    Envía los archivos y la herramienta en una sola solicitud multipart.

    POST /public/v1/tasks
  3. Entérate cuando termine

    Suscríbete a task_completed o consulta la tarea periódicamente.

    webhook: task_completed
  4. Descarga

    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 …

Referencia completa de la API

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
Consigue una clave de sandbox

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
Comparar planes

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
Habla con nosotros

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.