Documentos · API HTML a PDF
Tu HTML convertido en PDF con calidad de navegador.
Envía HTML y CSS y recibe PDFs, PNGs o JPGs renderizados por un Chromium real. Genera facturas, reportes y certificados uno por uno o en lotes con plantilla, sin mantener servidores de renderizado.
curl -X POST 'https://api.respawntech.dev/v1/tools/document/pdf/convert' \
-H "X-API-Token: $RESPAWN_API_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"html": "<h1>Fatura #001</h1><p>Total: R$ 199,90</p>",
"format": "pdf",
"page_size": "A4",
"webhook_url": "https://seu-app.com/webhooks/pdf"
}'Casos de uso
Convierte HTML y CSS a PDF, PNG o JPG — un documento o 500 a la vez.
Facturas, recibos y comprobantes de pago
Transforma el HTML que ya tienes en documentos listos para enviar al cliente.
Reportes con gráficos
Activa JavaScript para renderizar gráficos y SPAs antes de generar el PDF.
Certificados y contratos masivos
Una plantilla, hasta 500 variaciones por lote, con descuento por volumen.
Cómo funciona
Del registro a la primera llamada en minutos
Envía el HTML
POST con HTML, CSS y opciones; recibe el conversion_id con estado 202.
Espera el webhook
Tu endpoint recibe una llamada cuando el job termina — sin polling.
Descarga el archivo
Descarga el PDF (o el ZIP del lote) desde el endpoint de descarga.
Funcionalidades
Hecha para correr en producción
Renderizado fiel
Chromium headless con soporte para CSS moderno, Google Fonts, encabezado y pie de página por página.
PDF, PNG o JPG
Elige el formato, el tamaño de página (A4, Letter, Legal), la orientación, los márgenes y la escala.
Lotes con plantilla
Envía una plantilla con placeholders y hasta 500 ítems; descarga todo en un ZIP.
Asíncrono de verdad
Recibe un 202 al instante y un aviso por webhook cuando el archivo esté listo.
JavaScript en sandbox
Activa enable_js para páginas que dependen de scripts, con espera por selector o por retraso.
Retención bajo control
Archivos efímeros por ~24 h, retención de hasta 30 días o permanente, almacenados de forma cifrada.
Precios
Paga por uso, no por suscripción
Cada documento cuesta desde 1 crédito. La retención de más de 3 días y JavaScript son adicionales, y los lotes a partir de 10 ítems obtienen descuento automático.
HTML a PDF — por documento
| Ítem | Créditos |
|---|---|
| Conversión base | 1,0 |
Retención hasta 3 díasretention_days ≤ 3 | +0,0 |
Retención de 4 a 7 díasretention_days 4–7 | +0,5 |
Retención de 8 a 30 díasretention_days 8–30 | +2,5 |
Retención permanenteretention_days: -1 | +15,0 |
JavaScript en sandboxenable_js | +0,25 |
HTML a PDF — descuento en lotes
| A partir de | Descuento |
|---|---|
| 10+ | 5% |
| 20+ | 10% |
| 30+ | 15% |
| 40+ | 20% |
Lecturas vía API (después de la franquicia diaria)
Valores por consulta, cobrados solo después de las lecturas gratis del día.
| Operación | Créditos |
|---|---|
| Listar conversiones o lotes | 0,005 |
| Estado de conversión o lote | 0,01 |
| Descarga de archivo o ZIP | 0,03 |
Casos de uso
Lo que puedes construir
FAQ
Preguntas frecuentes
¿Cuánto tarda una conversión?
Los documentos simples suelen estar listos en segundos. Como el procesamiento es asíncrono, usa webhook_url para recibir un aviso sin tener que consultar el estado.
¿Puedo usar fuentes e imágenes externas?
Sí. Usa google_fonts_url para fuentes de Google y URLs absolutas para imágenes y hojas de estilo.
¿Por cuánto tiempo está disponible el archivo?
Por defecto, hasta 3 días sin costo extra. Puedes elegir retención efímera (~24 h), hasta 30 días o permanente.
¿Y si la conversión falla?
El estado indica el motivo en error_code. Puedes reprocesar la conversión; las fallas no generan archivo para descargar.
Empieza a integrar hoy
Crea tu cuenta, genera un token y haz la primera llamada en pocos minutos.