Die passende Darstellung für die Daten wählen
Die Upload-Aktion akzeptiert Text in `content` oder kodierte Binärdaten in `contentBase64`. Text wie eine Markdown-Notiz oder ein JSON-Dokument kann direkt als Inhalt übergeben werden. Bei PDFs, Bildern und anderen Binärdateien bewahrt Base64 die Bytefolge, wenn die API eine Zeichenkette erwartet.
Base64 ist eine Kodierung, weder Verschlüsselung noch Komprimierung. Kodieren Sie normalen Text nicht in Base64, sofern der Vorgang diese Darstellung nicht ausdrücklich verlangt. Wird die Base64-Zeichenfolge als `content` übergeben, kann das Objekt die Zeichen der Kodierung statt der ursprünglichen Binärdatei enthalten.
Typ, Pfad und Integrität erhalten
Wählen Sie einen Objektschlüssel, der den Zweck der Datei beschreibt, und setzen Sie, wenn der Client dies unterstützt, einen passenden Inhaltstyp wie `application/pdf` oder `image/png`. Der Typ sagt der Software, wie sie das Objekt interpretieren soll; er verändert die Bytes nicht. Schlüssel und Typ sollten zur tatsächlichen Datei passen.
Prüfen Sie nach dem Upload den zurückgegebenen Schlüssel und die Größe und rufen Sie das Objekt ab oder öffnen Sie es. Vergleichen Sie Größe oder Prüfsumme, wenn jedes Byte erhalten bleiben muss. Protokollieren Sie nicht die gesamte Base64-Nutzlast: Sie kann groß sein und private Dateiinhalte offenlegen. Für Diagnosen genügen Schlüssel, Typ, Größe und eine bereinigte Fehlermeldung.