ForHosting KIT · Documentos y PDF

Compruebe la linearización y la vista web rápida de un PDF

La linearización de PDF es una organización estructural que permite a un visor compatible mostrar la primera página mientras el resto de un documento remoto continúa descargándose.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Este comprobador recibe el indicador booleano de linearización generado por una herramienta de inspección de PDF y lo convierte en una conclusión concisa, lista para incluir en un informe. Indica si se anuncia la vista web rápida, explica su efecto práctico, diferencia la optimización de entrega de la validez del archivo y propone el siguiente paso sin cargar ni reescribir el PDF.

Interprete correctamente el indicador estructural

Un inspector de PDF puede presentar la linearización como un indicador booleano, a veces junto a etiquetas como Vista web rápida u Optimizado para web. Introduzca ese resultado estructural exacto en el campo linearized: true significa que se reconocieron el diccionario y el orden esperados de la linearización; false indica que el archivo no declara esa organización. El comprobador exige deliberadamente el indicador y no intenta deducirlo del nombre, el tamaño, la velocidad de descarga ni una etiqueta de metadatos. Esas pistas indirectas no permiten determinar el orden de los objetos dentro del documento. El resultado repite el booleano normalizado, aporta un estado estable para flujos automatizados y redacta un resumen claro para un informe técnico. Si la inspección no contiene el indicador, no utilice false en su lugar. Una observación ausente significa que el estado se desconoce, mientras que false es una conclusión estructural concreta. Por eso, la capacidad devuelve un error de entrada si falta el indicador o no es booleano y evita que una conclusión sin fundamento pase a una auditoría o control de calidad.

Comprenda qué cambia la vista web rápida

Un PDF linearizado sitúa cerca del principio del archivo la información necesaria para mostrar contenido pronto e incluye indicaciones que ayudan a un lector compatible a solicitar intervalos de bytes útiles. Si el archivo está alojado en un servidor que admite solicitudes por rangos, un navegador o visor compatible puede representar la página inicial antes de recibir todos los bytes. Esto puede mejorar la rapidez percibida en documentos grandes, conexiones lentas y consultas limitadas a las primeras páginas. El informe emplea términos prudentes porque el indicador estructural habilita una posibilidad, pero no garantiza el rendimiento. El comportamiento real también depende de la entrega HTTP, la caché, la latencia de red, el visor, la complejidad del documento y las transformaciones posteriores. Linearizar no comprime el PDF, no reduce sus páginas, no certifica su accesibilidad, no valida firmas ni demuestra que todo el documento esté bien formado. Del mismo modo, un PDF no linearizado puede abrirse deprisa si es pequeño o está almacenado en caché. La conclusión debe describir la preparación para entrega progresiva, no afirmar una mejora de velocidad medida.

Incorpore la conclusión a un informe o flujo

Ante un resultado positivo, registre que el PDF está linearizado y admite vista web rápida, conservando la salvedad de que las condiciones de entrega determinan el beneficio observado. Ante uno negativo, indique que no se anuncia la vista web rápida y que mostrar remotamente la primera página puede exigir descargar una parte mayor del archivo. No califique el documento como dañado: los PDF no linearizados son habituales y pueden ser plenamente válidos. La recomendación es condicional: linearice el archivo cuando sea importante la visualización HTTP progresiva y vuelva a inspeccionar el resultado reescrito. Editar, optimizar, firmar, combinar o regenerar un PDF puede cambiar su orden interno y eliminar una estructura de linearización antes válida. En una publicación automatizada, ejecute la inspección estructural después del último paso que genere el documento, envíe aquí su indicador booleano y guarde el estado y la explicación con las pruebas de publicación. Los campos estables también simplifican las políticas: un flujo web puede exigir true, mientras que uno de archivo o distribución local puede aceptar ambos valores y conservar el dato solo como información.

Documentar un control de publicación web

Convierta el indicador estructural de un inspector en una conclusión coherente antes de publicar un PDF grande en un sitio web.

Normalizar el resultado del control de calidad

Transforme true o false en estados estables y texto de informe que los controles posteriores puedan guardar y comparar.

Explicar con rigor un resultado negativo

Aclare que la ausencia de optimización para vista web rápida afecta a la entrega progresiva, pero no implica por sí sola que el PDF sea inválido.

¿Qué entrada necesita el comprobador?

Necesita el indicador booleano de linearización obtenido mediante una inspección estructural del PDF: true o false. No interpreta un indicador ausente o desconocido como false.

¿Esta capacidad inspecciona o carga el archivo PDF?

No. Interpreta un indicador estructural que ya ha producido otro paso de inspección de PDF.

¿Linearizado significa que el PDF siempre se abrirá más rápido?

No. Permite la entrega progresiva, pero la experiencia real depende del servidor, el visor, la conexión, la caché, la complejidad y el tamaño del documento.

¿Está dañado un PDF no linearizado?

No. La falta de linearización es una conclusión sobre optimización de entrega, no una prueba de daño o invalidez.

¿Puede una edición eliminar la linearización?

Sí. Reescribir, combinar, firmar u optimizar el archivo puede alterar el orden de los objetos; inspeccione de nuevo el artefacto final.

¿Cuánto cuesta una solicitud a la API?

Cada solicitud a la API cuesta $0.002. La versión del navegador puede ejecutar localmente la misma interpretación determinista.

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.

POSThttps://api.kit.forhosting.com/pdf/linearize-check

¿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.

curl -X POST https://api.kit.forhosting.com/pdf/linearize-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linearized":true}'
{
  "linearized": true
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.linearize_check",
  "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.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_mb25
max_pages200
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →