API de generación de PDF v1: sin estado

API de generación de PDF
de plantillas de negocios

Genere archivos PDF a partir de sus plantillas HTML, DOCX, Markdown o JSON. Retención de datos cero: no se almacenan documentos ni datos.

Obtenga su clave API Guía de inicio rápido

4 formatos de entrada

Sustitución de variables

Almacenamiento de datos cero

99,9% de tiempo de actividad SLA

Inicio rápido

Obtenga su primer PDF en menos de 2 minutos. Cree una clave API, envíe una solicitud y descargue el resultado.

Obtenga su clave API

Cree una clave API desde la consola a continuación o desde su panel de control.

Su clave API es un secreto. Nunca lo expongas en el código frontend.

Envía tu primera solicitud

Utilice el siguiente comando cURL para generar un PDF:

Terminal

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<h1>Invoice #{{invoice_number}}</h1><p>Client: {{client_name}}</p><p>Amount: {{amount}}</p>",
    "variables": {
      "invoice_number": "2026-001",
      "client_name": "Acme Corp",
      "amount": "$1,250.00"
    }
  }' \
  --output invoice.pdf

Descarga tu PDF

La API devuelve el binario PDF directamente en el cuerpo de la respuesta.

El PDF generado se guarda en el archivo especificado en el indicador --output.

Demostración en vivo

Pruebe la API aquí mismo: edite el contenido y las variables, luego presione Generar para ver su PDF al instante.

Inicia sesión para probar la demostración

Cree una cuenta gratuita para acceder al área de juegos en vivo y generar hasta 5 archivos PDF de demostración.

Crear una cuenta Iniciar sesión

Consola API

Administre sus claves API y supervise el uso directamente desde esta página.

Es necesario iniciar sesión

Inicie sesión para crear y administrar sus claves API.

Crear una cuenta Iniciar sesión

Autenticación

Todas las solicitudes de API requieren una clave API enviada a través del encabezado X-API-Key.

como funciona

Cree una clave API desde la consola o el panel.
Inclúyalo en cada solicitud como encabezado X-API-Key.
La API valida su clave y verifica su cuota.
Las claves no válidas o revocadas devuelven un error 401.

Mantenga su clave API segura. Utilice variables de entorno, nunca codifique en el código fuente.

Solicitud de ejemplo

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{"format":"html","content":"<h1>Hello</h1>"}' \
  --output output.pdf

Respuesta de clave no válida (401)

{
  "error": "invalid_api_key",
  "message": "The provided API key is invalid."
}

Formatos de entrada

EasyPDF admite 4 formatos de entrada. Elija el que mejor se adapte a su flujo de trabajo.

HTML

Soporte completo de CSS, píxeles perfectos a través de Chromium

DOCX

Cargar plantillas de Word con marcadores de posición variables

Markdown

5 temas integrados para hermosos documentos

Template JSON

Motor Canvas para un control preciso del diseño

HTML → PDF

Más Popular

Envíe cualquier HTML con CSS en línea. El motor de renderizado Chromium garantiza una salida perfecta en píxeles que coincide con la visualización del navegador.

Características clave

Soporte completo de CSS3 (Flexbox, Grid, consultas de medios)
Encabezados y pies de página personalizados con números de página
Sustitución de variables con sintaxis {{variable}}
Diseños responsivos con tamaños de página A4/Carta/Legal

Request body

{
  "format": "html",
  "content": "<html><head><style>body{font-family:Arial;padding:40px}h1{color:#333}.total{font-size:24px;font-weight:bold;color:#8b5cf6}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Date: {{date}}</p><p>Client: {{client_name}}</p><table><tr><th>Item</th><th>Price</th></tr><tr><td>{{item_1}}</td><td>{{price_1}}</td></tr></table><p class='total'>Total: {{total}}</p></body></html>",
  "variables": {
    "invoice_number": "2026-042",
    "date": "2026-03-16",
    "client_name": "Acme Corp",
    "item_1": "Web Development",
    "price_1": "$3,500",
    "total": "$4,700"
  },
  "options": { "page_format": "A4", "margin_top": "25mm" }
}

Puntos finales API

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

Genere un PDF a partir de contenido HTML, Markdown o JSON de plantilla.

Request Body (JSON)

Parámetro	Tipo	Requerida	Descripción
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	Cadena de contenido HTML o Markdown (requerido para html/markdown)
`template_data`	`object`	Yes*	Objeto JSON de plantilla (obligatorio para el formato de plantilla)
`variables`	`object`	No	Pares clave-valor para sustitución de variables
`options`	`object`	No	Opciones de generación de PDF (formato de página, márgenes, etc.)

Respuesta

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

Cargue un archivo DOCX para convertirlo a PDF con reemplazo de variables opcional.

Form Fields

Field	Tipo	Requerida	Descripción
`file`	File	Yes	El archivo .docx para convertir
`variables`	string (JSON)	No	Pares clave-valor para sustitución de variables
`options`	string (JSON)	No	Opciones de PDF como cadena JSON

POST/generate/previewAPI Key

Genere una vista previa PNG de la primera página en lugar de un PDF completo.

200Content-Type: image/png

GET/usageAPI Key

Verifique su uso mensual actual y su cuota restante.

Response (200)

{
  "month": "2026-03",
  "used": 142,
  "limit": 500,
  "remaining": 358,
  "plan": "starter"
}

POST/keysJWT Bearer

Cree una nueva clave API (requiere autenticación JWT).

GET/keysJWT Bearer

Enumere todas sus claves API con estadísticas de uso.

DELETE/keys/:key_idJWT Bearer

Revocar (desactivar) una clave API de forma permanente.

Ejemplos de código

Ejemplos completos y listos para usar en su idioma y formato preferido. Seleccione un idioma y formato de entrada a continuación.

curl — HTML

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<html><head><style>body{font-family:sans-serif;padding:40px}h1{color:#8b5cf6}table{width:100%;border-collapse:collapse}th,td{padding:8px 12px;border-bottom:1px solid #eee}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Client: <strong>{{client_name}}</strong></p><table><tr><th>Item</th><th>Amount</th></tr><tr><td>{{line_1}}</td><td>{{amount_1}}</td></tr></table><h2>Total: {{total}}</h2></body></html>",
    "variables": {
      "invoice_number": "INV-2026-042",
      "client_name": "Acme Corp",
      "line_1": "Web Development",
      "amount_1": "$3,500.00",
      "total": "$4,700.00"
    },
    "options": { "page_format": "A4", "margin_top": "20mm" }
  }' --output invoice.pdf

Casos de uso

Vea cómo los equipos utilizan la API EasyPDF para automatizar la generación de documentos a escala.

Facturas y recibos

Genere facturas de marca con partidas dinámicas, totales y detalles del cliente.

HTML / DOCX

Contratos y acuerdos

Complete las plantillas de Word con datos del cliente y conviértalas a PDF para firmarlas.

DOCX

Certificados y diplomas

Cree certificados personalizados con diseño y posicionamiento precisos.

Template JSON

Informes y paneles

Convierta datos de Markdown o HTML en informes PDF pulidos.

Markdown / HTML

Cartas y correos

Genere cartas personalizadas a partir de plantillas DOCX para envíos masivos.

DOCX

Documentos de cumplimiento

Produzca documentos de cumplimiento a prueba de manipulaciones y listos para auditorías.

HTML

Opciones de PDF

Personalice la salida con estos parámetros opcionales en el objeto de opciones.

Option	Tipo	Por defecto	Descripción
`page_format`	`string`	`"A4"`	Tamaño de página: A4, Carta, Legal, Tabloide o personalizado
`landscape`	`boolean`	`false`	Habilitar orientación horizontal
`margin_top`	`string`	`"20mm"`	Margen superior (unidades CSS: mm, cm, pulgadas, px)
`margin_bottom`	`string`	`"20mm"`	Margen inferior
`margin_left`	`string`	`"15mm"`	Margen izquierdo
`margin_right`	`string`	`"15mm"`	margen derecho
`header_html`	`string`	`null`	Contenido HTML para el encabezado de la página.
`footer_html`	`string`	`null`	Contenido HTML para pie de página (admite pageNumber, totalPages)
`theme`	`string`	`"modern"`	Tema Markdown: moderno, clásico, minimalista, github, académico

Ejemplo de opciones completas

JSON

{
  "format": "html",
  "content": "<h1>Report</h1><p>Content here...</p>",
  "variables": {},
  "options": {
    "page_format": "A4",
    "landscape": false,
    "margin_top": "25mm",
    "margin_bottom": "25mm",
    "margin_left": "20mm",
    "margin_right": "20mm",
    "header_html": "<div style='text-align:right;font-size:9px'>Acme Corp — Confidential</div>",
    "footer_html": "<div style='text-align:center;font-size:9px'>Page <span class='pageNumber'></span> / <span class='totalPages'></span></div>",
    "theme": "modern"
  }
}

Manejo de errores

La API devuelve errores JSON estructurados con códigos de error consistentes.

Formato de respuesta de error

{
  "error": "missing_content",
  "message": "The 'content' field is required for html format."
}

HTTP	Error	Cuando	que hacer
`400`	`missing_content`	Falta el campo obligatorio	Verificar los campos del cuerpo de la solicitud
`400`	`invalid_json`	Error al analizar JSON	Valida tu carga útil JSON
`400`	`unsupported_format`	Valor de formato desconocido	Utilice html, rebajas o plantilla
`401`	`invalid_api_key`	Clave API no encontrada	Verifique su encabezado X-API-Key
`402`	`quota_exceeded`	Cuota mensual superada	Actualice su plan o espere el reinicio
`403`	`api_key_revoked`	La clave ha sido revocada	Crear una nueva clave API
`429`	`rate_limit_exceeded`	Límite de tasa alcanzado	Espere y vuelva a intentarlo con retroceso exponencial
`500`	`generation_failed`	Error de procesamiento interno	Verifique su contenido en busca de errores y vuelva a intentarlo

Límites de tarifas y cuotas

Cada plan tiene una cuota mensual de PDF y un límite de tarifa por minuto.

Limitación de tasa

Las solicitudes que exceden su límite de tasa reciben una respuesta 429 con un encabezado Reintentar después.

Respuesta de velocidad limitada

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

Cuotas Mensuales

El uso se restablece el día 1 de cada mes a la medianoche UTC.

Plan	PDFs/mes	Rate limit	Precio	Exceso
Starter	500	10/min	9€/mes	0,02€/PDF
Business	5 000	30/min	79€/mes	0,01€/PDF
Enterprise	Costumbre	Costumbre	En cotización	Negociable

Mejores prácticas

Siga estas recomendaciones para aprovechar al máximo la API.

Utilice variables para contenido dinámico

Mantenga sus plantillas estáticas e inyecte datos a través del objeto de variables. Esto es más eficaz que reconstruir HTML en cada llamada.

Maneje los errores con gracia

Siempre verifique el código de estado HTTP. Implemente reintentos con retroceso exponencial para errores 429 y 5xx.

Optimiza tus plantillas

Minimice CSS, evite activos externos (inclúyalos) y pruebe las plantillas antes de implementarlas en producción.

Controle su uso

Utilice el punto final /usage o la consola anterior para realizar un seguimiento del consumo y evitar límites de cuota inesperados.

Asegure sus claves API

Almacene claves en variables de entorno o administradores secretos. Rote las claves periódicamente y revoque las que no utilice.

Precios

Precios simples y transparentes. Paga sólo por lo que usas.

Starter

9€/mes

~0,018€ / PDF

500 PDFs / mes
10 solicitudes/min
Los 4 formatos de entrada
Generación de vista previa PNG
Soporte por correo electrónico
Exceso : 0,02€/PDF

Empezar

Mejor valor

Business

79€/mes

~0,016€ / PDF

5 000 PDFs / mes
30 solicitudes/min
Todas las funciones iniciales
Apoyo prioritario
Panel de análisis de uso
Exceso : 0,01€/PDF