Contar páginas de PDF
Obtenga el total de páginas y el tamaño de la primera a partir de las medidas que ya extrajo su lector de PDF: tres páginas, la primera de 612 × 792 puntos. Cada página se revisa antes: una lista rota nunca pasa por válida. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Obtenga un total fiable de páginas y las dimensiones de la primera a partir de metadatos generados previamente por un lector de PDF. Proporcione un descriptor ordenado por cada página, con anchura y altura medidas en puntos PDF. La capacidad valida todos los descriptores, cuenta las entradas y devuelve las dimensiones de la primera página con la unidad indicada expresamente. Resulta útil cuando un flujo ya ha analizado un PDF y necesita un resumen pequeño y predecible antes de dirigir, mostrar, comprobar o guardar el documento.
Prepare los descriptores de página
Proporcione un array pages en el mismo orden que las páginas del PDF. Cada entrada debe ser un objeto con los campos width y height, ambos expresados en puntos PDF. Un punto equivale a una septuagésima segunda parte de una pulgada y es la unidad de coordenadas habitual que exponen las bibliotecas de PDF.
Se admiten medidas decimales porque los cuadros de recorte y de soporte no siempre tienen números enteros. Use el tamaño efectivo que comunique su analizador y aplique el mismo criterio de rotación a todo el array. La capacidad no abre los bytes del PDF, no deduce dimensiones ni elige entre distintos cuadros de página; resume los descriptores que usted aporta.
Incluya todas las páginas, aunque las posteriores cambien de orientación o tamaño, porque la cantidad de descriptores determina el total indicado. La primera entrada se considera la primera página. Un array vacío se rechaza porque no permite informar ni de un total útil ni del tamaño inicial.
Interprete el total y el tamaño inicial
Se conserva la precisión numérica original: la capacidad no redondea, redimensiona, normaliza la orientación ni convierte a pulgadas o milímetros. Solo se devuelven las dimensiones de la primera página, aunque el documento combine después tamaños Carta, A4, apaisados, verticales o personalizados. Aun así, todos los descriptores se validan antes de producir el resultado.
Esto evita que un recuento basado en una lista parcialmente defectuosa parezca fiable mientras oculta una salida incompleta del analizador. La operación no conserva estado y siempre genera el mismo resultado para la misma entrada.
Valide los metadatos antes de dirigir el PDF
Use el resumen como control compacto entre el análisis del PDF y una acción posterior. Un servicio de recepción puede rechazar archivos que superen un límite de páginas, escoger el diseño de vista previa según la orientación inicial o adjuntar el total y las dimensiones a un registro de índice. Un flujo de impresión puede comparar el tamaño de la primera página con una plantilla esperada antes de enviar el archivo original.
La validación es estricta: pages debe ser un array no vacío, cada entrada debe ser un objeto y cada width y height debe ser un número finito positivo. Los ceros, valores negativos, campos ausentes, cadenas, infinitos y valores NaN generan errores en vez de corregirse silenciosamente. Las solicitudes se limitan además a cien mil descriptores.
No se realizan solicitudes de red, cargas, decodificación del PDF ni almacenamiento persistente.
Qué puede hacer con ella
Aplique límites de páginas
Cuente descriptores validados antes de admitir un PDF en un flujo con requisitos mínimos o máximos de páginas.
Elija la orientación de la vista previa
Compare la anchura y la altura iniciales para seleccionar un contenedor vertical, apaisado o cuadrado.
Guarde metadatos compactos del PDF
Añada el total y las dimensiones iniciales a un índice de búsqueda, un registro de activos o un historial de procesamiento.
Preguntas frecuentes
¿Esta capacidad lee el archivo PDF?
No. Recibe descriptores ordenados que un lector o analizador de PDF ya ha generado.
¿Qué unidad deben usar width y height?
Proporcione ambas medidas en puntos PDF. La respuesta identifica la unidad como pt.
¿Informa del tamaño de todas las páginas?
No. Valida todos los descriptores, comunica su cantidad total y solo devuelve las dimensiones de la primera entrada.
¿Para qué sirve conocer el total y el tamaño de la primera página?
Para comprobar el documento antes del siguiente paso: rechazar archivos que superan un límite de páginas, elegir una vista previa vertical u horizontal según la primera página o confirmar que coincide con el papel que espera una plantilla de impresión.
¿Por qué se rechaza mi lista de páginas?
Cada página necesita un ancho y un alto mayores que cero. Una lista vacía, una medida que falta, un cero o un valor negativo detienen el recuento, para que una lista a medias nunca dé un total que solo parece correcto.
Herramientas relacionadas
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, 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/page-count \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pages":[{"width":612,"height":792},{"width":612,"height":792},{"width":792,"height":612}]}'const res = await fetch("https://api.kit.forhosting.com/pdf/page-count", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pages": [
{
"width": 612,
"height": 792
},
{
"width": 612,
"height": 792
},
{
"width": 792,
"height": 612
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/page-count",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pages": [
{
"width": 612,
"height": 792
},
{
"width": 612,
"height": 792
},
{
"width": 792,
"height": 612
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/page-count", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pages":[{"width":612,"height":792},{"width":612,"height":792},{"width":792,"height":612}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pages":[{"width":612,"height":792},{"width":612,"height":792},{"width":792,"height":612}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/page-count", 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
{
"pages": [
{
"width": 612,
"height": 792
},
{
"width": 612,
"height": 792
},
{
"width": 792,
"height": 612
}
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.page_count",
"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_pages | 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. |
Notas técnicas
Interprete el total y el tamaño inicial
La respuesta contiene dos campos principales. page_count es la cantidad de entradas validadas del array pages. first_page incluye width y height copiados del primer descriptor, además de unit con el valor pt, para que el sistema receptor no tenga que adivinar la unidad. Por tanto, el orden del array es la única regla que decide qué dimensiones aparecen en first_page.
Valide los metadatos antes de dirigir el PDF
Para comprobaciones interactivas, ejecute la operación en el navegador; para procesos automatizados, la API cuesta $0.002 por solicitud y devuelve la misma estructura JSON determinista.
Preguntas técnicas
¿Pueden variar los tamaños o las orientaciones?
Sí. Los descriptores posteriores pueden diferir; la longitud del array fija el total y el primero determina first_page.
¿Qué ocurre si el array pages está vacío?
La solicitud falla con un error invalid_input porque no existe una primera página que describir.