Il file non si apre: chiedi le info, ripara, poi smetti di tirare a indovinare
Quando un PDF non si apre, usa Get Info per il preflight e poi Ripara per la ricostruzione strutturale: è recupero della xref, non un clone di Recovery Toolbox.

Un PDF che non si apre è di solito un problema di struttura (tabella cross-reference rotta, download troncato, oggetti malformati), non un'immagine di pagina mancante che puoi ridisegnare a mano. Tirare a indovinare con OCR, compressione o conversione fa perdere tempo, finché il file non si riesce ad analizzare.
Prima Get Info
Get Info (POST /api/v1/security/get-info-on-pdf) restituisce un report JSON: FileSize, PageCount, Encrypted, i campi del dizionario Info quando presenti (title, author, subject, creator, producer), la Version PDF, un semplice elenco Pages e se è stata trovata una radice del documento. Usalo come preflight:
- Encrypted: true significa che serve uno Sblocco autorizzato prima della maggior parte delle modifiche; la sola riparazione non viola le password.
- PageCount / FileSize sembrano plausibili ma il visualizzatore desktop continua a fallire: prova poi la Riparazione strutturale.
- La chiamata stessa non riesce a caricare i byte: il file può essere troppo danneggiato per un passaggio pulito di Get Info; tenta comunque la riparazione su una copia.
Get Info non riscrive il PDF. Ti dice cosa riesce a vedere il parser, così smetti di trattare ogni errore come «serve l'OCR» o «serve la compressione».
Poi la riparazione (ricostruzione strutturale con qpdf)
Ripara PDF (POST /api/v1/misc/repair) riscrive il file con qpdf, così i visualizzatori possono riaprirlo quando restano abbastanza oggetti. Quando funziona, il contenuto previsto delle pagine viene preservato; il lavoro riguarda la mappa del file (xref / object stream), non il recupero forense di bozze cancellate.
La riparazione non è:
- OCR o pulizia di scansioni (il file si apre ma il testo è solo un'immagine): usa OCR, che qui restituisce testo Markdown, non uno strato PDF ricercabile
- rimozione della password: usa Sblocco
- riparazione dei font o «rendere di nuovo modificabile il file»
- un clone del prodotto Windows «Recovery Toolbox for PDF»
Per la distinzione tra marchio e canale (riparazione strutturale online e ricerche desktop di «recovery toolbox»), leggi Riparare un PDF online e le ricerche Recovery Toolbox.
Albero decisionale per smettere di indovinare
- Il visualizzatore non riesce ad aprire il file: Get Info, poi Ripara.
- Il file si apre ma selezione e ricerca falliscono su una scansione: OCR per avere testo Markdown; facoltativamente Comprimi una copia se il problema che resta è la dimensione (Pacchetto di scansioni: prima OCR poi compressione).
- Il file si apre e le tabelle vengono esportate come 204: nessuna colonna rilevata; vedi Esportazione tabella vuota (204).
- Ti serve la stessa riparazione da uno script o da un agente:
POST /api/v1/misc/repairtramite Developers. Invia unIdempotency-Keyse il tuo client ritenta i caricamenti (Idempotency-Key).
Cosa non risolve un file «riparato»
Una riparazione riuscita significa che un visualizzatore riesce ad aprire di nuovo il file. Non significa che:
- ogni immagine di pagina sia stata ricostruita dal nulla (gli oggetti mancanti restano mancanti)
- il testo sia diventato selezionabile su una scansione (quello è l'OCR → Markdown, qui)
- la cifratura sia sparita (serve lo Sblocco con una password nota)
- le tabelle verranno esportate (serve comunque testo colonnare; 204 significa che non ne è stato rilevato)
Se dopo la riparazione Get Info mostra un numero di pagine plausibile ma una pagina è bianca, la struttura si è recuperata ma il contenuto di quella pagina può essere ancora vuoto o troncato nei byte originali.
Conserva l'originale danneggiato
Conserva l'originale danneggiato accanto a ogni derivato riparato. Se la riparazione non recupera abbastanza struttura, l'esito onesto è «i byte sono persi», non un altro strumento a caso del catalogo. Comprimere o convertire un file che ancora non si analizza non inventa gli oggetti mancanti.
Confronta l'intento dei due canali (riparazione strutturale online e ricerche desktop del marchio «recovery toolbox») in Riparare un PDF online e le ricerche Recovery Toolbox, se è così che hai trovato lo strumento. Per il percorso nel browser sugli strumenti del catalogo non è richiesto alcun account.