Documentación para desarrolladores: API de JavaScript
Asistente de subida
API de JavaScript
Reduce un PDF o una imagen a un límite de tamaño desde tu propio código con PDFkind.fit(file, { max }) y gestiona cada resultado.
El script añade un objeto global PDFkind. Úsalo cuando los archivos llegan desde un lugar que el modo automático no ve: al pegar, desde una cámara o desde un selector personalizado.
PDFkind.fit(file, options)
try {
const small = await PDFkind.fit(file, { max: '5MB' });
upload(small);
} catch (err) {
if (err.reason === 'too-big') alert('Este archivo es demasiado grande, incluso reducido.');
else upload(file); // recurrir al original
}| Opción | Tipo | Descripción |
|---|---|---|
max | string o number | Obligatoria. Mismo formato que data-pdfkind-max: 5MB, 500KB o bytes. |
el | Element | Opcional. Su data-lang (o el de un elemento padre) define el idioma de la ventana. |
Se resuelve con un File: el archivo reducido, el JPG convertido en el caso de las fotos HEIC, o el original si ya cumple el límite (en ese caso no se abre ninguna ventana). Se rechaza con un error cuyo reason es uno de los siguientes:
| reason | Significado |
|---|---|
too-big | Incluso reducido, el archivo supera el límite. |
unsupported | No es un PDF ni una imagen que el asistente pueda reducir. |
cancel | El visitante cerró la ventana. |
unavailable | La ventana de PDFkind no cargó en 8 segundos. |
timeout | El procesamiento tardó más de 3 minutos. |
failed | El archivo está dañado o se produjo otro error. |
bad-call | Se llamó sin un File o sin max. |
PDFkind.mount(root)
Convierte los elementos data-pdfkind-tool en herramientas. Se ejecuta solo al cargar la página; vuelve a llamarlo después de añadir herramientas más tarde, por ejemplo en una aplicación de página única (SPA). root es opcional y, por defecto, es toda la página.
container.innerHTML = '<div data-pdfkind-tool="split-pdf"></div>';
PDFkind.mount(container);PDFkind.version
La versión del script, actualmente 3. Es útil para comprobar que el script se ha cargado: escribe PDFkind.version en la consola del navegador.
Última actualización: 3 de noviembre de 2026 · ¿Preguntas? contact@pdfkind.com