Escolha a representação adequada aos dados
A ação de upload aceita texto em `content` ou dados binários codificados em `contentBase64`. Textos como uma nota Markdown ou um documento JSON podem ser enviados diretamente em content. Para PDF, imagem ou outro arquivo binário, Base64 preserva a sequência de bytes quando a API espera uma string.
Base64 é uma codificação, não criptografia nem compactação. Não codifique texto comum em Base64, a menos que a operação exija essa representação. Se você enviar a string Base64 como `content`, o objeto poderá armazenar os caracteres codificados em vez do arquivo binário original.
Preserve tipo, caminho e integridade
Escolha uma chave de objeto que indique a finalidade do arquivo e defina um tipo de conteúdo apropriado, como `application/pdf` ou `image/png`, quando o cliente permitir. O tipo informa ao software como interpretar o objeto; ele não transforma os bytes. Mantenha a chave e o tipo coerentes com o arquivo real.
Após o upload, confira a chave e o tamanho retornados e recupere ou abra o objeto para confirmar que está válido. Compare o tamanho ou um checksum quando a preservação exata for importante. Evite registrar todo o conteúdo Base64, que pode ser grande e revelar um arquivo privado; limite o diagnóstico à chave, ao tipo, ao tamanho e a um erro sanitizado.