Quando ti serve un PDF in Base64?
JSON, XML e molti moduli possono trasportare solo testo, quindi un file binario come un PDF va prima scritto in forma di testo. Il Base64 è il modo più comune per farlo:
- Inviare un documento a un'API. I servizi di fatturazione elettronica, firma elettronica, spedizioni e gestione documentale chiedono spesso il PDF in un campo chiamato content, file o data.
- Testare la tua integrazione. Con l'opzione JSON ottieni un corpo di richiesta pronto da incollare in Postman, curl o in un test unitario, senza scrivere codice di codifica.
- Salvarlo in una colonna di testo o in una configurazione. Alcuni sistemi conservano piccoli modelli o certificati come testo; con il Base64 anche il PDF ci sta.
- Incorporarlo in una pagina web. Un data URI permette a una pagina di mostrare un PDF in un iframe senza ospitare un file a parte, una soluzione adatta ai documenti piccoli.
Trovi esempi di richieste passo passo in curl, JavaScript e Python nella guida Come inviare un PDF a un'API in Base64. Per ritrasformare il codice in un file, usa Base64 in PDF; per le immagini, vedi Immagine in Base64.
Come si presenta ogni formato
| Formato | Inizia con | Uso tipico |
|---|---|---|
| Solo il codice Base64 | JVBERi0 | Campi API, JSON, XML, database |
| Data URI | data:application/pdf;base64, | Scheda del browser, iframe, tag object |
| Righe da 76 caratteri | JVBERi0, spezzato in righe brevi | Allegati email (MIME), file in stile PEM |
| JSON | { "fileName": … } | Corpo di richiesta per testare un'integrazione |
Se qualcosa va storto
«Questo file non è un PDF valido». Il file non inizia con la firma %PDF-: potrebbe essere un file Word o un'immagine rinominata in .pdf. Aprilo prima in un lettore PDF oppure convertilo con lo strumento giusto.
L'API dice che il contenuto non è valido. Controlla di aver inviato il codice puro, senza il prefisso data: e senza interruzioni di riga, a meno che la documentazione non li richieda. Verifica anche che non sia stato tagliato niente alla fine quando l'hai incollato.
Il testo è troppo lungo per il campo. Riduci il PDF con Comprimere PDF e convertilo di nuovo: il codice si accorcia nella stessa proporzione.