ForHosting KIT · Documentos y PDF

Numerar páginas de un PDF

Un documento de cien páginas sin numerar es una pequeña molestia diaria multiplicada por cada lector que tiene que decir "ve a la página del gráfico" en vez de "página 42". Este endpoint numera automáticamente cada página de un PDF, en la posición y el formato que el documento requiera.

● EstablePor solicitud + por página$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.

Un detalle que nadie nota hasta que falta

La numeración de páginas es de esas cosas que el lector solo registra conscientemente por su ausencia — al intentar referenciar una página específica en una llamada, citar una sección en una revisión, o retomar su lugar después de cerrar un PDF largo. Los documentos armados combinando varios PDF son especialmente propensos a tener numeración faltante o inconsistente, ya que cada archivo de origen puede haber traído su propio esquema o ninguno. Este endpoint lo corrige en un solo paso, aplicado de manera uniforme sobre el archivo final.

Qué ofrece realmente la numeración

Controla dónde se ubican los números — abajo centrado, en una esquina inferior, arriba de la página — cómo se ven, si se leen como un número solo o con un patrón tipo "Página 3 de 40", y desde dónde empieza el conteo, algo importante cuando una portada o un índice no deben contarse como la página uno. Los números se escriben directamente en el contenido de la página, así que se muestran de forma consistente en cualquier visor de PDF y sobreviven a la impresión.

Cómo se hace la llamada

Envía por POST el PDF junto con sus preferencias de posición, formato y número inicial a /pdf/page-numbers. Se procesa de forma asíncrona: recibe un task_id de inmediato, y el PDF numerado llega a su webhook firmado cuando está listo, o queda disponible en un enlace firmado válido por 24 horas.

Su lugar en un flujo documental más amplio

Este paso casi siempre viene después de algo más — combinar PDF, generar un informe, o armar un paquete a partir de varios documentos de origen — y antes de la entrega final. Ejecutarlo como último paso en un flujo de ensamblado de documentos garantiza que el conteo final de páginas y la numeración siempre sean correctos, incluso cuando el número de secciones combinadas cambia de una corrida a otra.

Costo y confiabilidad

Es una tarifa plana de $0.002 por solicitud sin importar cuántas páginas se numeren, así que foliar un memo de 5 páginas o un manual de 500 se factura a la misma tarifa predecible. Si la tarea no logra completarse tras sus reintentos automáticos, nunca se le cobra.

Qué puede hacer con ella

Paquetes de documentos combinados

Varios PDF se combinan en un solo paquete para un trámite o una reunión de junta directiva; este endpoint aplica numeración consistente en todo el archivo unido.

Informes y manuales extensos

Un informe generado abarca docenas de páginas; agregar numeración tipo "Página X de Y" lo hace navegable y citable para lectores y revisores.

Presentaciones legales y académicas

Los escritos judiciales y los trabajos académicos suelen exigir convenciones específicas de numeración antes de presentarse, aplicadas automáticamente al exportar.

Folletos y cuadernillos para imprimir

Un PDF destinado a impresión necesita numeración para que las páginas se mantengan en orden y sean fáciles de referenciar tras compaginarlas.

Preguntas frecuentes

¿Cómo numero las páginas de un PDF vía API?

Envíe el PDF y sus preferencias de formato a /pdf/page-numbers en una solicitud POST, y el archivo numerado regresa por webhook o enlace firmado.

¿Puedo elegir dónde aparecen los números de página?

Sí, puede definir la posición — como abajo centrado o en una esquina superior o inferior — para que coincida con la maquetación existente del documento.

¿La numeración puede empezar en una página distinta de la uno?

Sí, puede definir el número inicial, útil cuando una portada o un índice no deben contar dentro de la numeración.

¿Admite formatos como "Página 3 de 40"?

Sí, puede elegir un número solo o un patrón que incluya el total de páginas junto con la actual.

¿Numerar páginas 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.

¿Los números se verán bien en cualquier visor de PDF?

Sí, porque los números se escriben en el propio contenido de la página en lugar de depender de funciones específicas de cada visor.

¿Puedo numerar un lote de PDF a la vez?

Envíe una tarea por documento; cada una se factura y procesa de forma independiente, lo que da un escalamiento lineal y predecible.

¿Qué pasa si la tarea de numeración falla?

Reintenta automáticamente hasta tres veces, y si aun así no se completa, recibe un error claro sin ningún cobro.

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/page-numbers

¿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/page-numbers \
  -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/page-numbers", {
  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/page-numbers",
    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/page-numbers", 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/page-numbers", 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.page_numbers",
  "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 →