ForHosting KIT · Documentos y PDF

Convierta un rango de páginas PDF en números de página

Convierta una selección como 1-3,5,8-10 en la lista exacta de páginas que necesita un proceso de exportación.

● BetaGratis · en su navegador

Úselo desde WebAPIEmailTelegramApp pronto

Este analizador expande los intervalos inclusivos, conserva el orden en que se solicitaron las páginas por primera vez, elimina duplicados y comprueba cada resultado con el total de páginas del documento. Así, su aplicación puede validar antes de extraer, imprimir, dividir o exportar un PDF, sin aceptar páginas inexistentes ni cambiar la secuencia indicada.

Escriba una expresión clara de rango de páginas

Introduzca números de página individuales, intervalos inclusivos o una combinación separada por comas. Por ejemplo, 1-3,5,8-10 representa las páginas 1, 2, 3, 5, 8, 9 y 10. Se admiten espacios alrededor de comas y guiones, por lo que el texto copiado de un formulario puede seguir siendo legible. La numeración empieza en 1, igual que en los lectores de PDF habituales. Cada elemento debe ser un entero positivo o un intervalo ascendente cuyo inicio no supere el final. Los elementos vacíos, decimales, palabras, números negativos e intervalos descendentes se rechazan en lugar de interpretarse. Indique por separado el total de páginas del documento; el analizador lo utiliza como límite estricto para garantizar que la selección corresponda a páginas reales del archivo concreto.

Comprenda el orden y la eliminación de duplicados

El resultado respeta el orden de la primera aparición de cada página. Un intervalo se expande desde el inicio hasta el final y los elementos posteriores continúan a partir de ahí. Si una página vuelve a aparecer, ya sea por un intervalo solapado o por un número explícito, se omite la repetición y se conserva su primera posición. Por ejemplo, 3-5,1,4,2 produce 3, 4, 5, 1, 2. Este comportamiento es importante al alimentar una exportación o reordenación de PDF: ordenar numéricamente borraría la secuencia solicitada, mientras que conservar repeticiones podría exportar una página varias veces. La respuesta incluye el array pages expandido y su count, para que pueda utilizar la lista y mostrar un resumen sin volver a contarla. El proceso es determinista y no utiliza red, carga de archivos ni valores aleatorios.

Valide antes de exportar o imprimir

Utilice este analizador justo después de leer el rango introducido y antes de iniciar una tarea de PDF más costosa. Obtenga primero el total de páginas de metadatos fiables y envíelo junto con la cadena. Si una página o el extremo de un intervalo supera ese total, toda la solicitud falla con un error de entrada que identifica la página infractora. No se recorta nada hasta la última página, porque hacerlo en silencio podría ocultar errores de escritura y generar documentos incompletos. La misma validación estricta se aplica al cero, los enteros inseguros, los separadores incorrectos y los intervalos invertidos. Un resultado correcto puede tratarse como una selección explícita dentro de los límites declarados. La capacidad solo analiza el texto: no abre, inspecciona, modifica ni almacena el PDF.

Qué puede hacer con ella

Validar un diálogo de exportación

Expanda el rango introducido y rechace la solicitud antes de exportar si menciona una página inexistente.

Preparar una extracción de PDF

Convierta texto compacto en el array explícito que requiere un servicio de extracción o división de páginas.

Normalizar selecciones de impresión

Guarde una representación ordenada y sin duplicados aunque la expresión original contenga solapamientos.

Preguntas frecuentes

¿Cuánto cuesta?

Cada solicitud de API cuesta $0.002. La versión del navegador puede ejecutarse localmente sin cargar un PDF.

¿Se incluyen los extremos del intervalo?

Sí. Un intervalo como 4-6 se expande a las páginas 4, 5 y 6.

¿Qué ocurre con las páginas duplicadas?

Se eliminan las repeticiones y se conserva la posición de la primera aparición de cada página.

¿Se ordena el resultado?

No. El analizador conserva el orden solicitado y expande cada intervalo de forma ascendente.

¿Qué ocurre si una página supera el tamaño del documento?

La solicitud falla con un error de entrada. Las páginas nunca se recortan ni se descartan en silencio.

¿Esta capacidad lee o modifica mi PDF?

No. Solo recibe el texto del rango y el total de páginas, y devuelve números de página.

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/export-range-string-parse

¿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/export-range-string-parse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"range_string":"1-3,5,8-10","total_pages":10}'

const res = await fetch("https://api.kit.forhosting.com/pdf/export-range-string-parse", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "range_string": "1-3,5,8-10",
    "total_pages": 10
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/export-range-string-parse",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "range_string": "1-3,5,8-10",
    "total_pages": 10
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/export-range-string-parse", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"range_string":"1-3,5,8-10","total_pages":10}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"range_string":"1-3,5,8-10","total_pages":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/export-range-string-parse", 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

{
  "range_string": "1-3,5,8-10",
  "total_pages": 10
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.export_range_string_parse",
  "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_chars`	10000
`max_items`	100000

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 →