Base64 a PDF, sin enviar el documento a ninguna parte.

JSON no puede transportar bytes en bruto, así que las API que devuelven documentos (firma electrónica, facturación, nóminas, etiquetas de envío o informes) suelen meter el PDF en un campo de texto en Base64. El correo hace lo mismo: un PDF adjunto viaja en Base64 dentro del código MIME, cortado a 76 caracteres por línea. Ambos se decodifican aquí tal cual; no hace falta quitar antes los saltos de línea.

Todo PDF empieza por %PDF-, y en Base64 eso siempre se convierte en JVBERi0. Si tu cadena empieza por esos siete caracteres, es un PDF. Otros prefijos te dicen qué tienes en su lugar:

UEsDB indica un contenedor ZIP, que es también lo que son los archivos de Word y Excel. H4sI significa que el documento se comprimió con gzip antes de codificarlo: descarga el resultado como archivo .gz y descomprímelo para llegar al PDF.

• Copiado de JSON en bruto. JSON puede escapar la barra como \/. Copia el valor desde una vista ya interpretada (o sustituye \/ por /): una barra invertida no es Base64 válido.
• Truncado. Un PDF completo termina en %%EOF. Si la pestaña Hex muestra que el documento se corta antes, el Base64 se truncó y el lector de PDF lo dará por dañado.
• Codificado dos veces. Si el resultado empieza por JVBERi0 como texto, se codificó en Base64 dos veces. Pulsa Enviar a la entrada y decodifica de nuevo.
• Protegido con contraseña. La decodificación restaura el archivo exactamente; si estaba cifrado, el lector de PDF seguirá pidiendo su contraseña.

# Python
import base64
with open("document.pdf", "wb") as f:
    f.write(base64.b64decode(response["pdf"]))

// Node.js
fs.writeFileSync("document.pdf", Buffer.from(json.pdf, "base64"));

# Shell, straight from an API response
curl -s https://api.example.com/invoice/42 | jq -r .pdf | base64 --decode > invoice.pdf

Consulta todos los ejemplos para decodificar Base64 en Java, C#, PHP, Go y PowerShell.