Come Usare un PDF Base64 in una Richiesta API JSON
Scopri come strutturare un payload JSON con un PDF codificato in Base64, inviarlo da un client e decodificarlo di nuovo in un file sul server.
- pdf base64 api
- pdf base64 json
- inviare pdf in richiesta api
- decodificare pdf base64 server
- pdf me
Perché le API Codificano i File in Base64
Le API REST e JSON sono costruite intorno al testo, non al binario puro, quindi non esiste un modo nativo per inserire i byte di un PDF direttamente in un campo JSON. Codificare prima il file in Base64 lo trasforma in una stringa, che JSON gestisce come qualsiasi altro valore di testo.
Se non hai ancora convertito un file, la guida PDF in Base64 copre il passaggio di conversione stesso.
Strutturare il Corpo della Richiesta
Una richiesta tipica affianca la stringa codificata ad alcuni campi di metadati: un campo — spesso chiamato file, document o content — contiene il testo Base64, un campo filename porta il nome originale del file, e un campo contentType o mimeType impostato su application/pdf dice al destinatario come interpretare i byte una volta decodificati.
Mantieni il campo codificato come un'unica stringa senza interruzioni. Interruzioni di riga o spazi extra inseriti da un editor o da un passaggio di copia e incolla corrompono il valore prima ancora che raggiunga il server.
Inviare la Richiesta
La maggior parte dei client HTTP — fetch nel browser, una libreria HTTP lato server o uno strumento come curl — invia il corpo JSON nello stesso modo in cui invierebbe qualsiasi altro payload, purché l'header Content-Type sia impostato su application/json. Il campo Base64 è solo una lunga stringa all'interno di quel corpo.
Tieni d'occhio la dimensione totale della richiesta: il PDF codificato fa parte del JSON, quindi un allegato grande aumenta direttamente la dimensione del corpo, e alcuni gateway API o reverse proxy impongono una dimensione massima della richiesta.
Decodificare sul Server
La maggior parte dei linguaggi lato server include un decoder Base64 integrato. La decodifica trasforma la stringa di nuovo negli esatti byte originali, che il server può quindi scrivere su disco, salvare in un database, inviare a un altro servizio o trasmettere in streaming a un client.
Se il file decodificato non si apre come PDF valido, controlla un eventuale prefisso data URI rimasto o una corruzione da copia e incolla — vedi problemi comuni di PDF in Base64.
Quando Usare un Upload di File invece
Per PDF grandi, upload frequenti o file che devono essere trasmessi in streaming invece di essere caricati interamente in memoria, un upload multipart o un caricamento diretto su uno storage è di solito più adatto che incorporare il file nel JSON. Base64 dentro JSON funziona meglio per file da piccoli a medi spostati occasionalmente — certificati, moduli firmati, report brevi.