Reordenar páginas de un PDF
La API Reordenar Páginas PDF recibe un documento existente y la secuencia de páginas que desea, y devuelve un PDF nuevo con las páginas organizadas tal como lo pidió. Es una operación precisa y determinista para equipos que necesitan corregir el orden de un escaneo, intercalar secciones o normalizar la estructura de un documento sin abrir jamás un editor de escritorio.
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.
El problema exacto que resuelve
Los documentos casi nunca llegan en el orden que necesita. Un escáner a doble cara suelta primero las páginas impares y al final las pares; un paso de fusión concatena los capítulos en desorden; un contrato firmado regresa con la hoja de firma pegada al frente. Arreglarlo a mano es tedioso y no escala más allá de un puñado de archivos. Esta API acepta su PDF y una lista explícita de números de página que describe el orden que quiere, y genera un documento nuevo que sigue esa lista al pie de la letra. Si su entrada tiene diez páginas y envía la secuencia que necesita, cada página cae donde la indicó, sin agregar nada ni eliminar nada en silencio.
Cómo se comporta la llamada
Hace un POST a /pdf/reorder-pages con el archivo de origen y el orden de páginas deseado. Como reorganizar documentos grandes o protegidos con contraseña puede tomar tiempo real, el endpoint es asíncrono: valida la petición y devuelve de inmediato un task_id. Cuando el trabajo termina, el resultado se envía a su webhook firmado, o puede recuperarlo desde un enlace firmado que permanece válido durante veinticuatro horas. El orden que envía se respeta con exactitud, así que puede duplicar una página listándola dos veces o descartarla omitiéndola. Los marcadores, los campos de formulario y el contenido incrustado viajan con sus páginas en lugar de aplanarse.
Una nota sobre el formato
El PDF conserva un árbol interno de páginas desde sus primeras versiones, y por eso reorganizarlas es una edición estructural y no un nuevo renderizado: el contenido visual de cada página queda intacto y solo cambian las referencias de orden. Justamente eso hace seguro un reordenamiento por programa. El texto sigue siendo seleccionable, los gráficos vectoriales se mantienen nítidos y el tamaño del archivo apenas varía porque nada se rasteriza. Recibe las mismas páginas con las que empezó, caminando en otra fila.
Su lugar en la automatización
Esta tarea está pensada como un eslabón de una cadena. Un patrón habitual es dividir un escaneo por lotes, reordenarlo en secciones lógicas y luego fusionar o sellar el resultado, todo guiado por webhooks para que ningún proceso quede sondeando. El acceso exige saldo prepago, y eso es lo que mantiene la cola veloz y libre de abuso; una petición sin fondos devuelve un 402 claro en vez de fallar en silencio. Cada llamada cuesta los $0.002 publicados, una tarea fallida se reintenta tres veces con espera progresiva y nunca se cobra, y sus archivos se eliminan tras la ventana de retención y jamás se usan para entrenar nada.
Qué puede hacer con ella
Corregir el orden de un escaneo dúplex
Un equipo administrativo escanea contratos a doble cara en un alimentador de una sola cara, dejando todas las impares al frente y todas las pares invertidas al final. Una sola llamada de reordenamiento las intercala de nuevo en orden de lectura antes de archivarlas.
Enviar las hojas de firma al final
Un flujo de firma electrónica devuelve documentos con el certificado y la página de firma añadidos en un punto que rompe el diseño. Reordene de forma automática cada PDF recibido para que los anexos firmados queden donde el área legal los espera.
Armar informes a partir de plantillas
Un servicio de reportes genera por separado la portada, el resumen y los anexos y luego los une, pero el generador los emite en orden de creación. El reordenamiento impone la secuencia canónica de secciones antes de entregar el informe al cliente.
Reparar la salida de una tubería de OCR
Una tubería de digitalización a veces desordena las páginas cuando procesos paralelos terminan fuera de secuencia. Un paso de reordenamiento determinista, guiado por un mapa de páginas conocido, garantiza que el documento final se lea de principio a fin en todo momento.
Preguntas frecuentes
¿Cómo reordeno las páginas de un PDF con una API?
Envíe un POST a /pdf/reorder-pages con su archivo de origen y un arreglo que describa el orden de páginas deseado. La API reordenar paginas PDF devuelve un task_id y el documento terminado llega por webhook firmado o por un enlace firmado.
¿La API para reordenar páginas 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.
¿Puedo duplicar o quitar páginas al reordenar?
Sí. La salida sigue su lista de páginas con exactitud, así que listar una página dos veces la duplica y omitirla la descarta. Eso convierte al reordenamiento en una forma flexible de rehacer un documento en una sola llamada.
¿Reordenar reduce la calidad del PDF?
No. Reordenar cambia solo las referencias de orden de las páginas, no su contenido, por lo que el texto sigue siendo seleccionable y los gráficos vectoriales permanecen nítidos. Nada se rasteriza ni se vuelve a renderizar.
¿Puedo reordenar páginas de forma masiva?
Sí. Cada documento es una tarea asíncrona independiente con su propio task_id, de modo que puede distribuir miles de archivos en paralelo y recibir cada resultado por webhook a medida que se completa.
¿Qué pasa con los marcadores y los campos de formulario?
Viajan con sus páginas. Los campos de formulario interactivos y los marcadores de cada página siguen unidos al contenido al que pertenecen en vez de aplanarse durante el reordenamiento.
¿Cuánto tiempo está disponible el resultado?
El enlace firmado permanece válido durante veinticuatro horas, y recomendamos el webhook firmado para tuberías sin intervención. Tras la ventana de retención sus archivos se eliminan y nunca se usan para entrenamiento.
¿Qué ocurre si envío un número de página inválido?
La petición se valida de entrada y se rechaza con un error claro antes de cobrar nada. Una tarea que falla durante el procesamiento se reintenta tres veces con espera progresiva y, si aún así falla, nunca se cobra.
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/reorder-pages \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pdf":"https://ejemplo.com/documento.pdf"}'const res = await fetch("https://api.kit.forhosting.com/pdf/reorder-pages", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pdf": "https://ejemplo.com/documento.pdf"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/reorder-pages",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/reorder-pages", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pdf":"https://ejemplo.com/documento.pdf"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/reorder-pages", 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
{
"pdf": "https://ejemplo.com/documento.pdf"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.reorder_pages",
"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. |