Elige la representación adecuada para los datos
La acción de carga admite texto en `content` o datos binarios codificados en `contentBase64`. Puedes pasar directamente como contenido textos como una nota Markdown o un documento JSON. Para un PDF, una imagen u otro archivo binario, Base64 conserva la secuencia de bytes cuando la API espera una cadena.
Base64 es una codificación, no un cifrado ni un método de compresión. No codifiques texto normal en Base64 salvo que la operación requiera esa representación. Si envías la cadena Base64 como `content`, el objeto podría contener los caracteres codificados en lugar del archivo binario original.
Conserva el tipo, la ruta y la integridad
Elige una clave de objeto que describa su propósito y establece un tipo de contenido adecuado, como `application/pdf` o `image/png`, cuando el cliente lo permita. El tipo indica al software cómo interpretar el objeto, pero no transforma sus bytes. Mantén la clave y el tipo coherentes con el archivo real.
Después de cargarlo, revisa la clave y el tamaño devueltos, y recupera o abre el objeto para confirmar que es válido. Compara el tamaño o una suma de comprobación si necesitas preservar cada byte. Evita registrar toda la carga Base64 porque puede ser grande y revelar un archivo privado; limita el diagnóstico a la clave, el tipo, el tamaño y un error saneado.