ForHosting KIT · Documentos y PDF

Dividir un PDF por marcadores

Un manual o informe de 400 páginas ya sabe dónde empiezan sus propios capítulos, porque su autor los marcó con marcadores, y aun así mucha gente sigue dividiendo esos archivos contando páginas a mano. Esta API para dividir PDF por marcadores lee el esquema de marcadores existente de un documento y lo corta en un archivo separado por cada entrada de nivel superior, convirtiendo una tabla de contenidos en un conjunto real de archivos.

● BetaPor solicitud + por documento$0.002

Ejecutar — $0.002 Cómo funciona y API

Úselo desde WebAPIEmailApp prontoTelegram pronto

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.

La división manual que nadie debería hacer

Los PDF largos — manuales técnicos, informes compilados, borradores de capítulos fusionados, publicaciones gubernamentales — casi siempre se construyen con un esquema de marcadores ya definido, agregado por la herramienta de autoría o por quien armó el documento final. Ese esquema es un mapa perfectamente estructurado de dónde empieza y termina cada sección, y aun así dividir el archivo suele significar abrirlo, desplazarse para encontrar cada límite y exportar rangos de páginas a mano. Este endpoint existe porque ese mapa ya estaba ahí; solo hacía falta leerlo y actuar sobre él de forma automática.

Cómo se decide la división

Llama a POST /pdf/split-by-bookmark con el PDF de origen y recibe un task_id de inmediato, ya que la división corre de forma asíncrona. El motor lee el esquema de marcadores existente del documento y usa cada marcador de nivel superior como límite de sección: cada entrada se convierte en el inicio de un archivo nuevo, que continúa hasta que empieza el siguiente marcador de nivel superior o termina el documento. El resultado es un conjunto de archivos que refleja la propia tabla de contenidos del documento, con el contenido de página, el formato y las imágenes conservados exactamente como aparecían en el original.

Por qué los marcadores son la señal correcta para dividir

Los marcadores de PDF, técnicamente el esquema del documento, forman parte del formato desde sus primeras versiones específicamente para permitir navegar documentos largos sin desplazarse por cientos de páginas — la misma función que muestra una tabla de contenidos clicable en el panel lateral de un lector de PDF. Como ese esquema lo escribe quien produjo el documento y normalmente coincide directamente con capítulos, secciones o informes independientes agrupados en un solo archivo, es una señal de división mucho más confiable que un conteo fijo de páginas o la detección de páginas en blanco, que puede fallar en documentos que no siguen un patrón estricto de páginas.

Dónde ahorra tiempo real

Está pensado justo para el tipo de documento que llega como un PDF grande pero se consume sección por sección: un informe anual compilado donde cada departamento quiere solo su propio capítulo, un conjunto fusionado de contratos que necesita volver a ser archivos individuales, un manual de capacitación cuyos módulos deben distribuirse por separado, o un expediente gubernamental encuadernado que hay que separar de vuelta en sus documentos originales. Ejecutar esto como un paso de una tubería reemplaza lo que de otro modo sería un ejercicio manual y propenso a errores de contar páginas cada vez que llega un nuevo documento grande.

Entrega y precio

Los archivos resultantes se entregan por un webhook firmado, recomendado para automatización, o un enlace firmado válido durante 24 horas; el origen y la salida se eliminan tras la ventana de retención y nunca se usan para entrenar modelos. El precio es un fijo de $0.002 por solicitud sin importar en cuántas secciones se divida el documento, y una tarea que falla tras sus reintentos nunca se cobra. Este endpoint está activo ahora mismo y listo para tráfico de producción.

Qué puede hacer con ella

Distribuir un manual de capacitación módulo por módulo

Divida un único manual de capacitación con marcadores en un archivo por módulo, para que cada equipo reciba solo la sección que le corresponde en lugar del documento completo.

Separar un informe anual compilado en capítulos por departamento

Convierta un solo PDF de informe grande con marcadores para cada departamento en archivos individuales, para que cada equipo reciba exactamente su propio capítulo sin el resto del documento.

Recuperar contratos individuales de un PDF fusionado

Divida un PDF con marcadores que contiene varios contratos fusionados de vuelta en archivos separados, uno por contrato, revirtiendo de forma limpia una fusión anterior.

Separar un expediente gubernamental en sus documentos componentes

Divida un expediente encuadernado con varios documentos según su estructura de marcadores para recuperar los documentos independientes originales con los que se armó.

Preguntas frecuentes

¿Cómo divido un PDF por marcadores con una API?

Envíe el PDF a POST /pdf/split-by-bookmark, que devuelve un task_id de inmediato. El conjunto de archivos divididos, uno por cada marcador de nivel superior, llega por webhook o enlace firmado cuando termina el procesamiento.

¿La API para dividir PDF por marcadores 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.

¿Qué pasa si mi PDF no tiene marcadores?

Este endpoint divide en base a un esquema de marcadores existente, así que un documento sin marcadores no tiene límites en los que dividirse; agregue primero un esquema o use una división basada en rangos de página.

¿También divide en submarcadores anidados?

Usa los marcadores de nivel superior como límites de sección, así que los submarcadores anidados quedan dentro del archivo de su sección padre en lugar de generar divisiones adicionales.

¿El formato, las imágenes y el diseño se mantienen intactos tras dividir?

Sí. Cada archivo de salida conserva exactamente el contenido de página, el formato y las imágenes del documento de origen; nada se vuelve a renderizar ni se altera.

¿Puedo dividir muchos PDF con marcadores por lote?

Sí. Cada solicitud es una tarea asíncrona independiente, así que puede enviar un lote grande de documentos en paralelo y recoger cada conjunto de archivos divididos por webhook.

¿Cómo se nombran los archivos de salida?

Cada archivo de salida corresponde a una sección de marcador de nivel superior del esquema del documento original, entregados juntos como resultado de una sola tarea.

¿Este endpoint está activo ahora mismo?

Sí, está activo y acepta tráfico de producción hoy mismo.

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/split-by-bookmark

¿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/split-by-bookmark \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"pdf":"https://ejemplo.com/documento.pdf"}'

const res = await fetch("https://api.kit.forhosting.com/pdf/split-by-bookmark", {
  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/split-by-bookmark",
    headers={"Authorization": f"Bearer {os.environ[&#39;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/split-by-bookmark", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"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/split-by-bookmark", 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.split_by_bookmark",
  "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.
`413`	`input_too_large`	El archivo supera el límite de tamaño.

Ver la documentación completa del KIT →