Unir varios PDF
La API Unir PDF recibe una lista de archivos PDF y los fusiona en un único documento, página por página, en el orden exacto que indique. Se conservan los marcadores, los tamaños de página y la orientación tal cual estaban, de modo que un contrato, sus anexos y la hoja de firmas llegan como un solo archivo limpio en lugar de una carpeta que alguien tiene que armar a mano.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Un documento a partir de muchos
Unir PDF a mano se come la tarde y aun así deja errores: una página fuera de secuencia, un anexo olvidado, la carátula equivocada. La api unir pdf elimina ese paso por completo. Envía una lista ordenada de archivos y recibe un documento cuyas páginas siguen la secuencia que declaró. Pensada para equipos que generan papeleo de forma programática — legal, finanzas, logística, RR. HH. — donde el entregable casi siempre son varios PDF que deben ser uno.
Cómo funciona la unión
Llama a POST /pdf/merge con su lista ordenada de entradas y recibe de inmediato un task_id. El trabajo corre de forma asíncrona en nuestra red global, así su petición nunca se bloquea mientras se completa una concatenación grande. Cuando el documento está listo le avisamos: por webhook firmado (lo recomendado) o por un enlace firmado válido 24 horas. La unión mantiene cada página intacta — sin rasterizar ni reducir la resolución — y concatena los objetos de página subyacentes, así el texto sigue seleccionable y los vectores nítidos.
Por qué el PDF complica lo que parece simple
El PDF se diseñó a comienzos de los noventa para congelar la apariencia de una página en cualquier equipo; pero esa maquetación fija implica que no es un flujo simple que pueda pegar de punta a punta. Cada archivo lleva su tabla de referencias cruzadas, su numeración de objetos y, a menudo, sus fuentes y metadatos. Una unión correcta debe renumerar cada objeto, reconstruir la tabla y reconciliar los recursos compartidos para que el resultado abra bien en cualquier lector. Con archivos reales es justo lo que resuelve este endpoint.
Pensada para flujos, no para clics
Como es asíncrona y devuelve un task_id, la unión encaja en una cola, un cron o un flujo orientado a eventos. Se genera un documento, se exportan facturas, se cierra un lote — y la unión se dispara como un paso más, sin que nadie abra una app de escritorio. El webhook firmado deja que la siguiente etapa reaccione en cuanto el archivo existe, y un estado de cuenta combinado pasa directo al almacenamiento, la firma o el correo.
Precio honesto y manejo seguro
El cobro es por página a $0.008 por solicitud: una tarifa base publicada más una tarifa por página, sin tokens ni créditos. Una tarea que falla nunca se cobra; reintentamos tres veces con espera progresiva y, de no lograrlo, devolvemos un error claro. El acceso requiere saldo prepago, lo que mantiene el servicio rápido y sin abuso; sin él, las peticiones reciben un 402. Sus archivos viven solo durante la ventana de retención, luego se eliminan y nunca sirven para entrenar nada.
Qué puede hacer con ella
Contratos con anexos
Un equipo de operaciones legales genera un contrato base, varios anexos y una hoja de firmas como PDF separados, y los une en un solo archivo listo para tribunal en el orden correcto antes de enviarlo a firma electrónica.
Paquetes de estados de cuenta mensuales
Una plataforma de facturación produce una carátula resumen y una factura por concepto, y las une por cliente para que cada uno reciba un único estado de cuenta paginado en lugar de una docena de adjuntos.
Paquetes de documentos de incorporación
Un sistema de recursos humanos reúne una carta de oferta, el manual de políticas y los formularios fiscales generados en distintos pasos y los combina en un solo paquete de bienvenida que el nuevo empleado descarga desde un único enlace.
Papeleo de envío y aduanas
Un servicio de logística concatena una factura comercial, la lista de empaque y el certificado de origen en un documento por envío para que los agentes aduanales reciban todo en la secuencia esperada.
Preguntas frecuentes
¿Cómo uno varios PDF con una API?
Envíe una lista ordenada de archivos PDF a POST /pdf/merge y recibe un task_id. La api unir pdf procesa el trabajo de forma asíncrona y entrega el archivo combinado por webhook firmado o por un enlace firmado válido durante 24 horas.
¿La API Unir PDF es gratis?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Las páginas se combinan en el orden que yo elijo?
Sí. El resultado sigue la secuencia exacta de la lista que envía, archivo por archivo y página por página, así que controla con precisión dónde queda cada documento en el PDF final.
¿Unir los PDF reduce su calidad?
No. Las páginas se concatenan a nivel de objeto en lugar de volver a renderizarse, por lo que el texto sigue siendo seleccionable y los gráficos vectoriales se mantienen nítidos. Cada página de origen llega al archivo combinado tal como estaba.
¿Puedo unir muchos PDF a la vez de forma masiva?
Sí. Cada llamada combina una lista ordenada completa en un solo documento y, al ser un endpoint asíncrono, puede disparar muchas uniones en paralelo desde una cola o un proceso por lotes sin bloquear.
¿Qué pasa si la unión falla?
Una tarea fallida nunca se cobra. Reintentamos tres veces con espera progresiva y, si aun así no logra completarse, recibe un error claro que explica el motivo en lugar de un fallo silencioso o un cargo.
¿En qué se diferencia de combinar PDF en un programa de escritorio?
Una herramienta de escritorio necesita a una persona haciendo clic entre archivos. Esta API une de forma programática dentro de su flujo, así combinar PDF se convierte en un paso automatizado que disparan sus propios sistemas.
¿Cuánto tiempo puedo acceder al archivo combinado?
El enlace firmado permanece válido 24 horas, o puede recibir el resultado de inmediato por webhook firmado. Tras la ventana de retención sus archivos se eliminan y nunca se usan para entrenamiento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/pdf/merge \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pdfs":["https://ejemplo.com/a.pdf","https://ejemplo.com/b.pdf"]}'const res = await fetch("https://api.kit.forhosting.com/pdf/merge", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pdfs": [
"https://ejemplo.com/a.pdf",
"https://ejemplo.com/b.pdf"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/merge",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pdfs": [
"https://ejemplo.com/a.pdf",
"https://ejemplo.com/b.pdf"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/merge", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pdfs":["https://ejemplo.com/a.pdf","https://ejemplo.com/b.pdf"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pdfs":["https://ejemplo.com/a.pdf","https://ejemplo.com/b.pdf"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/merge", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"pdfs": [
"https://ejemplo.com/a.pdf",
"https://ejemplo.com/b.pdf"
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.merge",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 25 |
max_pages | 200 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
413 | input_too_large | El archivo supera el límite de tamaño. |