Choisir une représentation adaptée aux données
L’action de téléversement accepte du texte dans `content` ou des données binaires encodées dans `contentBase64`. Du texte tel qu’une note Markdown ou un document JSON peut être transmis directement comme contenu. Pour un PDF, une image ou un autre fichier binaire, Base64 préserve la suite d’octets lorsque l’API attend une chaîne.
Base64 est un encodage, pas un chiffrement ni une compression. N’encodez pas du texte ordinaire en Base64 sauf si l’opération exige cette représentation. Si vous transmettez la chaîne Base64 dans `content`, l’objet peut contenir les caractères encodés au lieu du fichier binaire d’origine.
Préserver le type, le chemin et l’intégrité
Choisissez une clé d’objet qui décrit l’usage du fichier et, si le client le permet, indiquez un type de contenu adapté, comme `application/pdf` ou `image/png`. Ce type indique aux logiciels comment interpréter l’objet ; il ne transforme pas les octets. Gardez la clé et le type cohérents avec le fichier réel.
Après l’envoi, vérifiez la clé et la taille renvoyées, puis récupérez ou ouvrez l’objet pour confirmer sa validité. Comparez la taille ou une somme de contrôle si la préservation exacte est importante. Évitez d’inscrire tout le contenu Base64 dans les journaux : il peut être volumineux et révéler un fichier privé. Les diagnostics peuvent se limiter à la clé, au type, à la taille et à une erreur expurgée.