ForHosting KIT · Documentos y PDF

Diagnóstico de reparación PDF y plan de recuperación

Un PDF dañado suele generar una lista confusa de mensajes del analizador sin indicar qué puede repararse realmente.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Este diagnóstico convierte esos hallazgos estructurales en un informe práctico. Proporcione problemas como una tabla de referencias cruzadas ausente, un flujo sin terminar, una longitud incorrecta o un archivo truncado. Cada elemento recibe una clasificación coherente, un nivel de riesgo, una recomendación y un lugar en un plan ordenado. El resultado ayuda a decidir si conviene intentar una reparación automatizada antes de modificar el archivo original.

Convierta los mensajes del validador en una decisión de reparación

Los validadores de PDF identifican bien las estructuras dañadas, pero su salida rara vez basta para tomar una decisión completa. Un aviso sobre una tabla de referencias cruzadas ausente describe un fallo de navegación, mientras que un final de archivo inesperado puede indicar que faltan bytes para siempre. Tratar ambos hallazgos igual puede hacerle perder tiempo o destruir pruebas que un especialista habría recuperado. Este diagnóstico normaliza cada descripción proporcionada y la compara con familias explícitas de fallos estructurales. Solo marca un problema reconocido como reparable cuando existe una técnica de reconstrucción acotada. También asigna un nivel de riesgo y explica la acción recomendada. Las descripciones desconocidas se consideran deliberadamente no reparables mediante este informe automatizado, pues una suposición segura en apariencia resulta peligrosa cuando los límites de objetos y las referencias ya no son fiables. Añada el número de objeto, desplazamiento de bytes, página o ubicación del tráiler que indique su validador. Ese contexto se conserva en el informe para relacionar cada recomendación con el hallazgo original sin revisar otro registro.

Comprenda qué significa reparable

Una clasificación reparable significa que el registro estructural dañado normalmente puede reconstruirse a partir de información que permanece en otra parte del archivo. Por ejemplo, es posible examinar los marcadores de objetos indirectos para reconstruir un índice de referencias cruzadas ausente y medir los bytes codificados de un flujo para corregir un valor Length erróneo. No significa que cada página, fuente, imagen, anotación o valor de formulario siga intacto. Un flujo sin terminar se clasifica como reparable con riesgo alto porque un límite fiable del objeto siguiente puede revelar dónde acaba, aunque unos datos binarios ambiguos aún pueden impedir una reparación segura. En cambio, un truncamiento no es reparable si los bytes ausentes contenían información única, y un catálogo ausente no puede repararse automáticamente porque elegir la raíz del documento exige comprender las relaciones previstas. Los fallos de cifrado también quedan bloqueados hasta disponer de credenciales autorizadas. Mantenga inmutable el archivo original, trabaje sobre una copia y lea la recomendación junto con el riesgo. Las clasificaciones son deterministas: descripciones idénticas generan resultados idénticos, sin red, azar ni interpretación mediante modelos de lenguaje.

Aplique y verifique el plan ordenado

El plan generado incluye únicamente los elementos clasificados como reparables y conserva su orden de detección. Así resulta fácil compararlo con el registro del validador, aunque una herramienta de reparación quizá deba agrupar cambios relacionados en una sola reescritura. Conserve las generaciones de objetos cuando sea posible, evite reutilizar identificadores ocupados y actualice las referencias indirectas al renumerar un objeto. Si cambian las extensiones de los flujos o los desplazamientos de objetos, reconstruya las referencias cruzadas después de esos cambios, no antes. Cada paso incorpora una instrucción de verificación para volver a analizar la salida y confirmar que el hallazgo objetivo desapareció sin introducir nuevos fallos estructurales. La verificación final debe usar un analizador independiente, porque probar solo con la biblioteca que escribió la reparación puede ocultar supuestos compartidos. Compare el número de páginas y el grafo de objetos accesibles con el origen, abra visualmente páginas representativas y compruebe las funciones interactivas importantes. Un análisis estructural correcto es necesario, pero no demuestra que haya regresado el contenido perdido. Si algún elemento se considera no reparable, consérvelo en el expediente y escálelo en lugar de omitirlo silenciosamente.

Clasificar un informe de validación

Convierta hallazgos estructurales sin procesar en una lista coherente de problemas reparables y bloqueados antes de asignar trabajo técnico.

Planificar un proceso de recuperación

Use recomendaciones ordenadas para elegir las fases de reconstrucción y las comprobaciones posteriores a cada cambio.

Documentar una decisión de reparación

Adjunte clasificaciones, ubicaciones, riesgos y recomendaciones a un incidente o registro de recuperación documental.

¿Esta capacidad repara el propio PDF?

No. Clasifica una lista suministrada de hallazgos estructurales y genera un plan; nunca recibe ni modifica los bytes del PDF.

¿Qué significa reparable en el informe?

Significa que una reparación estructural reconocida suele poder derivarse de la información conservada. No garantiza que todo el contenido sea recuperable.

¿Qué ocurre con un mensaje de validación desconocido?

Se clasifica como problema estructural no reconocido y no reparable automáticamente, con una recomendación de inspección manual.

¿Por qué se rechaza una lista de problemas vacía?

Un diagnóstico sin hallazgos no puede clasificar nada ni generar un plan útil, por lo que la solicitud devuelve un error de entrada no válida.

¿Cuánto cuesta un informe?

Cada solicitud API cuesta $0.002. La capacidad utiliza procesamiento local determinista, sin modelos externos ni servicios de red.

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/repair-report

¿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/repair-report \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issues":[{"description":"Missing cross-reference table","location":"file trailer"},{"description":"Unterminated stream","location":"object 18"}]}'
{
  "issues": [
    {
      "description": "Missing cross-reference table",
      "location": "file trailer"
    },
    {
      "description": "Unterminated stream",
      "location": "object 18"
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.repair_report",
  "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_items200
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 →