Decodificar un PDF Base64
- Panel
- Documentación
- API
Decodificar un PDF Base64
Esta herramienta toma una cadena Base64 que representa un fichero PDF, la decodifica y le devuelve el PDF original en descarga directa. Es la operación inversa de nuestro codificador PDF Base64.
¿Por qué decodificar un PDF Base64?
- Recuperar un PDF recibido en JSON: una API devuelve un documento firmado, una factura o un informe en forma de cadena Base64 en una clave JSON. Para visualizarlo, hay que decodificarlo.
- Depuración de integración con API: confirmar que la cadena Base64 que devuelve un servicio de terceros corresponde efectivamente a un PDF válido y legible.
- Recuperación de archivos: extraer un PDF a partir de una exportación JSON, un volcado de base de datos o un log de transacción que lo contenga codificado.
- Comprobación de adjuntos de correo: analizar el contenido Base64 de un adjunto MIME para validar su integridad.
Cómo utilizar la herramienta
- Pegue la cadena Base64 en el campo de entrada.
- El prefijo
data:application/pdf;base64,es opcional: la herramienta lo detecta y lo retira automáticamente si está presente. - Inicie la decodificación. Si la cadena es válida y representa realmente un PDF, aparece un botón de descarga.
- Descargue el fichero reconstituido y ábralo con su lector PDF habitual.
Ejemplo de cadena aceptada
data:application/pdf;base64,JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFIvRmlsdGVy...
La misma cadena sin el prefijo (a partir de JVBERi...) también es aceptada.
Validación del formato PDF
Una cadena Base64 válida no garantiza que el contenido decodificado sea un PDF. Nuestra herramienta efectúa
una verificación adicional: comprueba que los primeros octetos decodificados corresponden efectivamente al
magic header %PDF- que todo fichero PDF posee al comienzo del fichero
(la firma 0x25 0x50 0x44 0x46 0x2D).
Si el dato decodificado no comienza con esa firma, la herramienta rechaza la petición con el mensaje "Decoded data does not look like a PDF". Esta salvaguarda evita ofrecerle para su descarga un fichero que no se abrirá, y señala inmediatamente un problema de formato en origen (cadena truncada, tipo de fichero incorrecto o contenido no binario).
Descarga directa
El PDF reconstituido se sirve directamente con una cabecera HTTP
Content-Disposition: attachment y el tipo MIME application/pdf. Según
su navegador, el fichero se abre en el visor integrado o se descarga en la carpeta
predeterminada.
Seguridad y confidencialidad
La decodificación se efectúa en el lado del servidor durante la petición. El PDF reconstituido nunca se almacena en disco ni en caché: se calcula en memoria y se envía en streaming directamente a su navegador. Una vez enviada la respuesta, el dato se libera.
Para documentos especialmente sensibles (contratos, datos personales), prefiera una
decodificación local con una herramienta sin conexión (por ejemplo base64 -d en línea de comandos)
para que el contenido no pase por ningún servidor de terceros.
Diferencia con una imagen Base64
Nuestra herramienta es específica para PDF: rechaza una cadena que decodifique en imagen, en archivo ZIP o en cualquier otro formato. Para decodificar una imagen Base64 (PNG, JPEG, GIF, WebP), utilice nuestro decodificador Base64 de imagen, que valida los magic headers propios de los formatos de imagen y propone una previsualización directa en el navegador.
Preguntas frecuentes
¿Qué hacer si la herramienta devuelve "Decoded data does not look like a PDF"?
La cadena Base64 se decodifica correctamente, pero el resultado no comienza por %PDF-.
Esto significa o bien que la cadena está truncada, o bien que el contenido original no es un PDF
(quizá una imagen, un documento Word o un dato corrupto). Compruebe la fuente: la
cadena completa debe empezar por JVBERi (equivalente Base64 de %PDF).
Mi PDF parece truncado tras la decodificación, ¿por qué?
Esto ocurre cuando la cadena Base64 de origen no está completa: un copiado y pegado incompleto, un
salto de línea mal gestionado, o un campo de base de datos que ha truncado el valor. Compruebe
que la cadena termina bien (a menudo con uno o dos = de padding) y que no se haya
colado ningún carácter parásito.
¿El PDF resultante es idéntico al original?
Sí. Base64 es una codificación reversible sin pérdida: la secuencia de octetos decodificada es estrictamente idéntica a la secuencia de octetos codificada. Cualquier diferencia de hash o de comportamiento en la apertura indica un problema previo (cadena dañada, fuente incorrecta).
¿Es obligatorio el prefijo Data URI?
No. Nuestra herramienta acepta indistintamente la cadena con prefijo
(data:application/pdf;base64,...) o la cadena en bruto (a partir de los datos
Base64 directamente). El prefijo es útil en un contexto HTML, pero una API que devuelve el
PDF en un campo JSON típico lo proporciona sin prefijo.
¿Los espacios y los saltos de línea en la cadena suponen un problema?
No. El decodificador ignora los caracteres en blanco (espacios, saltos de línea, tabulaciones) que pueden aparecer cuando la cadena se ha formateado para su visualización. Solo se tienen en cuenta los caracteres Base64 válidos.
Ejemplo de solicitud
curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-decoder/execute \
-H "Content-Type: application/json" \
-d '{"text_encoded":"..."}'
Esquema de entrada
| Campo | Tipo | Obligatorio | Por defecto |
|---|---|---|---|
text_encoded |
text | ✓ | – |
Puntos de acceso
GET https://cdrn.fr/api/v1/tools- lista todas las herramientas disponiblesGET https://cdrn.fr/api/v1/tools/base64-pdf-decoder- recupera el esquema de esta herramientaPOST https://cdrn.fr/api/v1/tools/base64-pdf-decoder/execute- ejecuta esta herramienta con un payload JSON