PDF a Base64

Cómo elegir la salida y comprobar que una integración es correcta

Base64 limpio contiene únicamente la representación textual de los bytes. Una Data URL añade el tipo MIME y el marcador ;base64,. Ninguna opción es universalmente mejor: usa exactamente la forma documentada por la API receptora y envía el valor en una propiedad JSON, encabezado o cuerpo solo cuando el contrato lo permita.

Calcula el tamaño antes de enviar

La codificación utiliza cuatro caracteres por cada tres bytes, por lo que el resultado crece aproximadamente un tercio. A esto se suman el prefijo, las comillas del JSON y posibles copias en memoria. Si la API limita el cuerpo a 10 MB, no selecciones un PDF de 10 MB esperando que siga ocupando lo mismo.

Evita copiar una cadena incompleta

Algunas consolas y editores muestran únicamente el inicio y el final de valores largos. La descarga TXT es preferible cuando necesitas conservar todo el resultado. En la integración compara longitud, decodifica una muestra de prueba y confirma la firma %PDF- del archivo recuperado.

Cuándo no utilizar Base64

Para documentos grandes o cargas frecuentes suele ser más eficiente enviar binario mediante multipart/form-data, usar una carga por partes o entregar una URL temporal protegida. Consulta la comparación entre Base64, Data URL y Blob URL antes de diseñar un flujo nuevo.

Prueba de ida y vuelta

1. Genera Base64 desde un PDF de prueba sin datos sensibles.
2. Registra la longitud del resultado.
3. Decodifícalo con Base64 a PDF.
4. Comprueba tamaño, páginas y contenido.
5. Solo entonces integra el mismo formato en tu sistema.

Ejemplo práctico para enviar un PDF como Base64

Si una API solicita un campo textual llamado documentoBase64, normalmente debes enviar la cadena limpia dentro de JSON:

No copies los puntos suspensivos del ejemplo ni agregues el prefijo Data URL salvo que el contrato lo indique expresamente. Para cargas largas, descargar el TXT evita que una consola visual recorte silenciosamente la cadena.

Estimación reproducible del tamaño

La longitud Base64 se aproxima con 4 × ceil(bytes / 3). Un PDF de 3 MB produce cerca de 4 MB de caracteres antes de contar el resto del JSON. Además, el navegador necesita memoria para el archivo original, sus bytes y la salida textual, por lo que el costo temporal puede superar ampliamente el tamaño guardado en disco.

Qué verifica esta página

Antes de codificar se comprueba que el archivo tenga firma PDF y se ofrece una vista previa. Esto permite detectar archivos renombrados con extensión .pdf que en realidad pertenecen a otro formato. La vista previa no certifica firmas digitales, accesibilidad, ausencia de malware ni integridad jurídica del documento.

Privacidad y metadatos

La operación local evita subir deliberadamente el archivo al servidor de Nexo Útil, pero Base64 conserva todos sus bytes. Autor, formularios, adjuntos y otros metadatos presentes en el PDF seguirán dentro de la cadena. Revisa y elimina información sensible en una copia autorizada antes de compartirla.

Diagnóstico cuando el receptor rechaza la cadena

1. Confirma si espera Base64 limpio o una Data URL.
2. Comprueba que el valor no tenga espacios, saltos añadidos o truncamiento.
3. Revisa el límite máximo del cuerpo HTTP después del aumento de tamaño.
4. Decodifica la misma cadena y verifica que comience por %PDF-.
5. Compara el archivo recuperado con el original antes de atribuir el fallo a la API.