CDRN

Decodificare un PDF Base64

  • Dashboard
  • Documentazione
  • API
recupera un file PDF a partire dalla sua rappresentazione Base64, in download diretto
Incolla la stringa Base64 del PDF, con o senza prefisso Data URI (data:application/pdf;base64,...).

Decodificare un PDF Base64

Questo strumento prende una stringa Base64 che rappresenta un file PDF, la decodifica e vi restituisce il PDF originale in download diretto. È l'operazione inversa del nostro encoder PDF Base64.

Perché decodificare un PDF Base64?

  • Recuperare un PDF ricevuto in JSON: un'API restituisce un documento firmato, una fattura o un report come stringa Base64 in una chiave JSON. Per visualizzarlo, bisogna decodificarlo.
  • Debug di integrazione API: confermare che la stringa Base64 restituita da un servizio terzo corrisponda effettivamente a un PDF valido e leggibile.
  • Recupero di archivi: estrarre un PDF da un export JSON, un dump di database o un log di transazione che lo contiene codificato.
  • Verifica di allegati email: analizzare il contenuto Base64 di un allegato MIME per validarne l'integrità.

Come usare lo strumento

  1. Incollate la stringa Base64 nel campo di input.
  2. Il prefisso data:application/pdf;base64, è opzionale: lo strumento lo rileva e lo rimuove automaticamente se presente.
  3. Avviate la decodifica. Se la stringa è valida e rappresenta effettivamente un PDF, appare un pulsante di download.
  4. Scaricate il file ricostituito e apritelo con il vostro lettore PDF abituale.

Esempio di stringa accettata

data:application/pdf;base64,JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFIvRmlsdGVy...

La stessa stringa senza il prefisso (a partire da JVBERi...) è anche accettata.

Validazione del formato PDF

Una stringa Base64 valida non garantisce che il contenuto decodificato sia un PDF. Il nostro strumento effettua una verifica aggiuntiva: controlla che i primi byte decodificati corrispondano al magic header %PDF- che ogni file PDF ha all'inizio del file (la firma 0x25 0x50 0x44 0x46 0x2D).

Se i dati decodificati non iniziano con questa firma, lo strumento rifiuta la richiesta con il messaggio "Decoded data does not look like a PDF". Questa protezione evita di proporre il download di un file che non si aprirà, e segnala immediatamente un problema di formato a monte (stringa troncata, tipo di file errato, o contenuto non binario).

Download diretto

Il PDF ricostituito è servito direttamente con un header HTTP Content-Disposition: attachment e il tipo MIME application/pdf. A seconda del browser, il file si apre nel visualizzatore integrato o si scarica nella cartella predefinita.

Sicurezza e riservatezza

La decodifica viene effettuata lato server solo per il tempo della richiesta. Il PDF ricostituito non viene mai memorizzato su disco né messo in cache: viene calcolato in memoria e trasmesso in streaming direttamente al vostro browser. Una volta inviata la risposta, i dati vengono liberati.

Per documenti particolarmente sensibili (contratti, dati personali), preferite una decodifica locale con uno strumento offline (per esempio base64 -d da riga di comando) in modo che il contenuto non transiti da alcun server terzo.

Differenza con un'immagine Base64

Il nostro strumento è specifico per i PDF: rifiuta una stringa che decodifica in immagine, in archivio ZIP o in qualsiasi altro formato. Per decodificare un'immagine Base64 (PNG, JPEG, GIF, WebP), usate il nostro decoder Base64 immagine, che valida i magic header propri dei formati immagine e propone una preview diretta nel browser.

Domande frequenti

Cosa fare se lo strumento restituisce "Decoded data does not look like a PDF"?

La stringa Base64 decodifica correttamente, ma il risultato non inizia con %PDF-. Significa che la stringa è troncata, o che il contenuto originale non è un PDF (forse un'immagine, un documento Word, o dati corrotti). Verificate la fonte: la stringa completa deve iniziare con JVBERi (equivalente Base64 di %PDF).

Il mio PDF sembra troncato dopo la decodifica, perché?

Accade quando la stringa Base64 sorgente non è completa: un copia-incolla incompleto, un ritorno a capo gestito male, o un campo di database che ha troncato il valore. Verificate che la stringa termini correttamente (spesso con uno o due = di padding) e che nessun carattere parassita si sia infilato.

Il PDF risultante è identico all'originale?

Sì. Base64 è una codifica reversibile senza perdita: la sequenza di byte decodificata è strettamente identica alla sequenza di byte codificata. Qualsiasi differenza di hash o di comportamento all'apertura indica un problema a monte (stringa danneggiata, sorgente sbagliata).

Il prefisso Data URI è obbligatorio?

No. Il nostro strumento accetta indifferentemente la stringa con prefisso (data:application/pdf;base64,...) o la stringa grezza (a partire dai dati Base64 direttamente). Il prefisso è utile in un contesto HTML, ma un'API che restituisce il PDF in un campo JSON tipico lo fornisce senza prefisso.

Gli spazi e i ritorni a capo nella stringa sono un problema?

No. Il decodificatore ignora i caratteri di spazio (spazi, ritorni a capo, tabulazioni) che possono apparire quando la stringa è stata formattata per la visualizzazione. Vengono presi in considerazione solo i caratteri Base64 validi.

Esempio di richiesta

curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-decoder/execute \
  -H "Content-Type: application/json" \
  -d '{"text_encoded":"..."}'

Schema di input

Campo Tipo Richiesto Predefinito
text_encoded text ✓ –

Endpoint

  • GET https://cdrn.fr/api/v1/tools - elenca tutti gli strumenti disponibili
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-decoder - recupera lo schema di questo strumento
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-decoder/execute - esegue questo strumento con un payload JSON