El archivo no abre: Get Info, Repair y deja de adivinar
Cuando un PDF no abre, usa Get Info como comprobación previa y luego Repair para reconstruir la estructura. Es recuperación de xref, no un clon de Recovery Toolbox.

Un PDF que no abre suele tener un problema de estructura (tabla de referencias cruzadas rota, descarga truncada, objetos mal formados), no una imagen de página que falte y puedas redibujar a mano. Probar con OCR, compresión o conversión antes de que el archivo se pueda analizar es perder el tiempo.
Get Info primero
Get Info (POST /api/v1/security/get-info-on-pdf) devuelve un informe JSON: FileSize, PageCount, Encrypted, los campos del diccionario Info cuando existen (title, author, subject, creator, producer), la Version del PDF, una lista sencilla Pages y si se encontró la raíz del documento. Úsalo como comprobación previa:
- Encrypted: true indica que necesitas un Desbloquear autorizado antes de la mayoría de las ediciones; reparar por sí solo no rompe contraseñas.
- PageCount y FileSize parecen razonables, pero tu visor de escritorio sigue fallando: prueba después la Reparar estructural.
- La propia llamada no consigue cargar los bytes: puede que el archivo esté demasiado dañado para un Info limpio; intenta igualmente Repair sobre una copia.
Get Info no reescribe el PDF: te dice lo que el analizador alcanza a ver, para que dejes de tratar cada fallo como «necesita OCR» o «necesita comprimirse».
Después, Repair (reconstrucción estructural con qpdf)
Reparar PDF (POST /api/v1/misc/repair) reescribe el archivo con qpdf para que los visores vuelvan a abrirlo cuando quedan suficientes objetos. Cuando funciona, el contenido previsto de las páginas se conserva; el trabajo es sobre el mapa del archivo (xref y object streams), no una recuperación forense de borradores eliminados.
Repair no es:
- OCR ni limpieza de escaneos (el archivo abre, pero el texto es solo una imagen): usa OCR, que aquí devuelve texto Markdown y no una capa PDF buscable
- Eliminación de contraseñas: usa Desbloquear
- Reparación de fuentes ni «volver a hacer editable el archivo»
- Un clon del producto de Windows «Recovery Toolbox for PDF»
Para la diferencia de marca y canal (reparación estructural online frente a búsquedas de «recovery toolbox» de escritorio), lee Reparar PDF online frente a búsquedas de Recovery Toolbox.
Árbol de decisión para dejar de adivinar
- El visor no abre el archivo: Get Info y después Reparar.
- El archivo abre, pero seleccionar o buscar falla en un escaneo: OCR para obtener texto Markdown; opcionalmente Comprimir una copia si el tamaño es el problema que queda (Paquete de escaneo: OCR y luego comprimir).
- El archivo abre y la exportación de tablas devuelve 204: no se detectaron columnas; consulta Exportación de tabla vacía (204).
- La misma reparación desde un script o un agente:
POST /api/v1/misc/repaircon Desarrolladores. Envía unIdempotency-Keysi tu cliente reintenta las subidas (Idempotency-Key).
Lo que «reparado» todavía no arregla
Que Repair salga bien significa que un visor puede volver a abrir el archivo. No significa que:
- Cada imagen de página se reconstruyera de la nada (los objetos que faltan siguen faltando)
- El texto se haya vuelto seleccionable en un escaneo (eso es OCR → Markdown aquí)
- El cifrado haya desaparecido (hace falta Desbloquear con la contraseña conocida)
- Las tablas vayan a exportarse (sigue haciendo falta texto en columnas; 204 significa que no se detectó ninguna)
Si Get Info muestra un número de páginas razonable después de Repair pero una página está en blanco, la estructura se recuperó y el contenido de esa página puede seguir vacío o truncado en los bytes originales.
Conserva el original dañado
Conserva el original dañado junto a cualquier derivado reparado. Si Repair no recupera suficiente estructura, el resultado honesto es «los bytes ya no están», no otra herramienta al azar del catálogo. Comprimir o convertir un archivo que todavía no se puede analizar no inventa los objetos que faltan.
Compara la intención de cada canal (reparación estructural online frente a búsquedas de la marca «recovery toolbox» de escritorio) en Reparar PDF online frente a búsquedas de Recovery Toolbox si así llegaste a la herramienta. Las herramientas del catálogo no piden cuenta en la vía del navegador.