ForHosting KIT · Documentos y PDF

Inserte una página en blanco en cualquier posición del PDF

Inserte una página en blanco en un PDF existente sin reconstruir el documento manualmente.

● BetaGratis · en su navegador

Úselo desde WebAPIEmailTelegramApp pronto

Proporcione el PDF y una posición numerada desde 1; la herramienta colocará allí una página limpia con las mismas dimensiones que la página ubicada en ese punto. Para añadirla al final, indique la posición posterior a la última página actual. La operación es determinista, conserva el orden original y rechaza claramente las posiciones inexistentes.

Elija la posición exacta de inserción

Las posiciones comienzan en 1 porque indican dónde aparecerá la página nueva para quien lea el documento terminado. La posición 1 inserta una hoja en blanco antes de la primera página actual. La posición 2 la coloca entre la primera y la segunda. En un documento de cinco páginas, la posición 6 añade una hoja después de la quinta. Esas son las únicas posiciones válidas: el mínimo es 1 y el máximo equivale al número de páginas existente más uno. Esta regla explícita impide que una solicitud ambigua genere silenciosamente un documento con la hoja en un lugar equivocado. Si la posición es cero, negativa, fraccionaria o superior a la posición final, la solicitud devuelve un error de entrada no válida y deja intacto el origen. Antes de automatizar un flujo, cuente las páginas y calcule la posición según el documento que realmente envía. El resultado indica la posición insertada y el nuevo total para que pueda verificar la transformación.

Cómo obtiene su tamaño la página en blanco

La página insertada utiliza el cuadro de medios efectivo de la página que ocupa la posición solicitada. Por tanto, si la inserta antes de una hoja vertical de tamaño carta, se crea una hoja en blanco vertical del mismo tamaño; si la siguiente es apaisada o personalizada, se conservan esas dimensiones. Cuando se añade al final no existe una página posterior que consultar, por lo que la nueva copia el tamaño de la última página existente. Esto resulta útil en PDF con tamaños mixtos, como expedientes escaneados, folletos, planos y recopilaciones de informes. La hoja está vacía de forma intencionada: no contiene flujo de contenido, anotaciones, campos de formulario ni marcas copiadas. Solo se conserva la geometría. La respuesta incluye también el ancho y el alto calculados en puntos PDF, de modo que usted puede confirmar las dimensiones elegidas. Las páginas originales mantienen su orden y contenido.

Prepare una entrada compatible y compruebe el resultado

Proporcione un PDF clásico como texto PDF sin formato o como URI de datos PDF en base64. Esta versión beta rechaza deliberadamente los documentos con flujos de referencias cruzadas, en lugar de adivinar estructuras que no puede reconstruir con seguridad. El analizador lee el catálogo y el árbol de páginas, recorre nodos anidados, resuelve cuadros de medios heredados, inserta la referencia nueva en el padre correcto, actualiza los recuentos afectados y reconstruye una tabla clásica válida. No intervienen red, reloj, valores aleatorios, almacenamiento ni modelos. Tras el procesamiento, revise el número de páginas, la posición, el ancho y el alto devueltos; después guarde o transmita el PDF. Para automatización, pruebe primero archivos representativos. Si se rechaza un flujo de referencias cruzadas, convierta el archivo a PDF clásico con una utilidad fiable. Cada solicitud a la API cuesta $0.002; la misma operación determinista también funciona de forma interactiva en el navegador.

Qué puede hacer con ella

Añadir una hoja separadora

Inserte una página limpia entre secciones de un informe combinado para dividir o anotar las copias impresas.

Restablecer la alineación dúplex

Añada una hoja vacía donde corresponda para que un capítulo o formulario comience en el anverso previsto al imprimir a doble cara.

Crear espacio para firmas o notas

Coloque una hoja vacía del mismo tamaño junto al material de apoyo sin recrear ni redimensionar el PDF original.

Preguntas frecuentes

¿Qué posiciones son válidas?

Use un entero desde 1 hasta el número actual de páginas más uno. El último valor añade la hoja al final.

¿Qué tamaño de página se utiliza?

La hoja copia el cuadro de medios efectivo de la página situada en la posición indicada, o el de la última al añadirla al final.

¿La página nueva contiene algo?

No. Tiene las dimensiones seleccionadas, pero no contiene contenido, anotaciones, campos de formulario ni gráficos copiados.

¿Qué ocurre si la posición está fuera del intervalo?

La solicitud devuelve un error de entrada no válida y no genera un PDF modificado.

¿Cuánto cuesta la solicitud a la API?

Cada solicitud cuesta $0.002.

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

POSThttps://api.kit.forhosting.com/pdf/insert-blank-page

¿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, por email y desde Telegram — y pronto también desde nuestra app.

Llámela desde su stack

curl -X POST https://api.kit.forhosting.com/pdf/insert-blank-page \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf":"https://ejemplo.com/documento.pdf","position":2}'

const res = await fetch("https://api.kit.forhosting.com/pdf/insert-blank-page", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pdf": "https://ejemplo.com/documento.pdf",
    "position": 2
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/insert-blank-page",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pdf": "https://ejemplo.com/documento.pdf",
    "position": 2
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/insert-blank-page", 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","position":2}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf","position":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/insert-blank-page", 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",
  "position": 2
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.insert_blank_page",
  "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

Por solicitud$0.002

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.

Ver la documentación completa del KIT →