ForHosting KIT · Documenti e PDF

Diagnosi di riparazione PDF e piano di recupero

Un PDF danneggiato genera spesso un elenco confuso di messaggi del parser senza spiegare che cosa sia davvero riparabile.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Questa diagnosi trasforma i problemi strutturali in un rapporto operativo. Indichi anomalie come una tabella dei riferimenti incrociati mancante, uno stream non terminato, una lunghezza errata o un file troncato. Ogni elemento riceve una classificazione coerente, un livello di rischio, una raccomandazione e una posizione nel piano ordinato. Il risultato consente di valutare se sia ragionevole tentare una riparazione automatica prima di modificare il file originale.

Trasformi i messaggi del validatore in una decisione

I validatori PDF individuano bene le strutture danneggiate, ma raramente producono informazioni sufficienti per decidere come procedere. Una tabella dei riferimenti incrociati mancante segnala un problema di navigazione, mentre una fine del file imprevista può indicare che alcuni byte sono andati persi definitivamente. Trattare allo stesso modo questi risultati può far perdere tempo o distruggere indizi che uno specialista avrebbe potuto recuperare. La diagnosi normalizza ogni descrizione fornita e la confronta con famiglie esplicite di guasti strutturali. Contrassegna un problema riconosciuto come riparabile solo quando esiste una tecnica di ricostruzione circoscritta. Assegna inoltre un livello di rischio e descrive l’azione consigliata. Le descrizioni sconosciute vengono volutamente classificate come non riparabili dal rapporto automatico, perché un’ipotesi sicura solo in apparenza è pericolosa quando i confini degli oggetti e i riferimenti non sono più affidabili. Aggiunga il numero dell’oggetto, l’offset in byte, la pagina o la posizione del trailer forniti dal validatore. Il contesto viene riportato nel rapporto per collegare ogni raccomandazione al problema originale senza consultare un registro separato.

Comprenda che cosa significa riparabile

La classificazione riparabile indica che il record strutturale danneggiato può normalmente essere ricostruito usando informazioni ancora presenti altrove nel file. Per esempio, i marcatori degli oggetti indiretti possono essere analizzati per ricreare un indice dei riferimenti incrociati mancante, mentre i byte codificati di uno stream possono essere misurati per correggere un valore Length errato. Ciò non implica che ogni pagina, font, immagine, annotazione o valore di modulo sia intatto. Uno stream non terminato è riparabile con rischio elevato perché un confine affidabile dell’oggetto successivo può rivelarne la fine, ma dati binari ambigui possono comunque impedire un intervento sicuro. Il troncamento, invece, non è riparabile se i byte assenti contenevano dati unici; neppure un catalogo mancante può essere ricreato automaticamente, perché scegliere la radice richiede di comprendere le relazioni previste. Gli errori di cifratura restano bloccati finché non sono disponibili credenziali autorizzate. Mantenga immutato l’originale, lavori su una copia e valuti insieme raccomandazione e rischio. Le classificazioni sono deterministiche: descrizioni identiche generano risultati identici, senza rete, casualità o interpretazione di modelli linguistici.

Applichi e verifichi il piano ordinato

Il piano generato include soltanto gli elementi classificati come riparabili e ne mantiene l’ordine di rilevamento. In questo modo è semplice confrontarlo con il registro del validatore, anche se uno strumento potrebbe dover raggruppare modifiche correlate in una sola riscrittura. Conservi le generazioni degli oggetti quando possibile, eviti di riutilizzare identificatori occupati e aggiorni i riferimenti indiretti quando rinumera un oggetto. Se cambiano l’estensione degli stream o gli offset degli oggetti, ricostruisca i riferimenti incrociati dopo tali modifiche, non prima. Ogni fase contiene un’istruzione di verifica che richiede una nuova analisi dell’output e la conferma che il problema sia scomparso senza introdurre altri guasti strutturali. La verifica finale deve usare un parser indipendente, perché una prova eseguita solo con la libreria che ha scritto la riparazione può nascondere presupposti condivisi. Confronti il numero di pagine e il grafo degli oggetti raggiungibili con la sorgente, apra visivamente pagine rappresentative e controlli le funzioni interattive rilevanti. Un’analisi strutturale riuscita è necessaria, ma non dimostra che il contenuto perso sia tornato. Se un elemento non è riparabile, lo mantenga nel fascicolo e lo sottoponga a uno specialista invece di ometterlo.

Esaminare un rapporto di convalida

Converta i problemi strutturali grezzi in un elenco coerente di casi riparabili e bloccati prima di assegnare il lavoro tecnico.

Pianificare un flusso di recupero

Usi le raccomandazioni ordinate per scegliere le fasi di ricostruzione e i controlli successivi a ogni modifica.

Documentare una decisione

Alleghi classificazioni, posizioni, rischi e raccomandazioni a un incidente o a un registro di recupero archivistico.

Questa capacità ripara direttamente il PDF?

No. Classifica un elenco fornito di problemi strutturali e crea un piano; non riceve né modifica mai i byte del PDF.

Che cosa significa riparabile nel rapporto?

Significa che una riparazione strutturale nota può spesso derivare dalle informazioni rimaste, ma non garantisce il recupero di tutti i contenuti.

Che cosa accade a un messaggio sconosciuto?

Viene classificato come problema strutturale non riconosciuto e non riparabile automaticamente, con l’indicazione di eseguire un controllo manuale.

Perché un elenco vuoto viene rifiutato?

Senza problemi la diagnosi non può classificare nulla né creare un piano significativo, quindi la richiesta restituisce un errore di input non valido.

Quanto costa un rapporto?

Ogni richiesta API costa $0.002. La capacità usa un’elaborazione locale deterministica, senza modelli esterni né servizi di rete.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/pdf/repair-report

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

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"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_items200
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →