Media
Große Mediendateien hochladen
Für Datei-Uploads größer als 10 MB eine presigned URL zum Hochladen einer Datei erhalten
GET
Für Datei-Uploads größer als 10 MB erhalten Sie eine presigned URL zum Hochladen einer Datei.
Stellen Sie sicher, dass der beim Erstellen der

- Maximale Upload-Dateigröße 5 GB.
- Die presigned Upload-URL ist nach ihrer Erstellung 30 Minuten lang gültig.
- Die Zugriffs-URL ist nach dem Upload 30 Tage lang verfügbar. Bereits veröffentlichte Beiträge sind in den sozialen Netzwerken davon nicht betroffen. Geplante Beiträge außerhalb dieses Zeitraums führen zum Zeitpunkt der Veröffentlichung zu Fehlern.
Header-Parameter
Query-Parameter
Wenn
contentType nicht vorhanden ist, ist ein vollständiger Dateiname mit Erweiterung erforderlich.Name der hochzuladenden Datei. Muss eine Erweiterung wie .png, .jpg, .mov, .mp4 usw. enthalten.Der Content-Type der hochzuladenden Medien. Gültige Formate sind:
mp4, mov, png, jpg oder jpeg.Beispiel: Wenn die Datei eine Quicktime-.mov-Datei ist, sollte der contentType mov lauten.Falls nicht vorhanden, wird application/octet-stream verwendet.Details zur Antwort
accessUrlist die URL, unter der nach dem Upload auf die Mediendatei zugegriffen werden kann.contentTypeist der Content-Type, der für die hochzuladenden Medien gesetzt wurde. Verwenden Sie ihn im Header Content-Type beim Hochladen der Medien.uploadUrlist die URL, an die die Mediendatei per PUT gesendet wird. Siehe unten.
Weitere Endpunkt-Beispiele
Der Prozess zum Hochladen größerer Dateien:- Rufen Sie über den Endpunkt
/media/uploadUrleineuploadURLund eineaccessURLab. Siehe oben. - Laden Sie die Datei per PUT hoch, mit Content-Type auf den zurückgegebenen
contentTypegesetzt. - Laden Sie die Medien hoch, indem Sie
--upload-filemit einer Mediendatei und deruploadUrlverwenden. - Bei einem erfolgreichen Upload wird eine
200-Antwort zurückgegeben. - Senden Sie nach dem Hochladen der Mediendatei eine POST-Anfrage an den
/post-Endpunkt mit deraccessUrlim Body-ParametermediaUrls. - Auf die presigned Upload-URL kann nur einmal hochgeladen werden. Wenn Sie eine fehlerhafte Datei gesendet haben, müssen Sie eine neue Upload-URL erstellen. Es wird keine Fehlerantwort zurückgegeben, wenn die Datei nicht erfolgreich hochgeladen wird. Siehe unten zur Überprüfung, ob die URL existiert.
uploadUrl gesetzte contentType beim PUT der Datei mit dem Content-Type und dem Dateityp übereinstimmt.
Wenn Sie beispielsweise beim Erstellen der uploadUrl den contentType auf “image/png” gesetzt haben, achten Sie darauf, Content-Type: image/png zu setzen und dass die hochgeladene Datei auf .png endet.
Bei einem erfolgreichen Upload wird eine 200-Antwort zurückgegeben.
Beispiel: Binäre Datei in Node.js hochladen
Hier ist ein Beispiel für das Hochladen einer binären Mediendatei mit Node.js und JavaScript:Beispiel: Binärdatei-Upload in Postman
Sie können auch Postman verwenden, um die Binärdatei an dieuploadUrl hochzuladen.
In Postman:
- Wählen Sie die HTTP-Methode
PUT. - Fügen Sie Ihre
uploadUrlin das URL-Feld ein. Beachten Sie, dass die URL nach einer Stunde abläuft und nur einmal verwendet werden kann. Wenn ein Aufruf fehlschlägt, müssen Sie dieuploadUrlneu generieren. - Setzen Sie in Headers den
Content-Typeauf den Content-Type, der vom /uploadUrl-Endpunkt zurückgegeben wurde. Beispiel:Content-Type: image/png. - Wählen Sie Body -> binary und wählen Sie die hochzuladende Datei aus.
- Klicken Sie auf Send.
- Wichtig: Es wird keine Rückantwort zurückgegeben, daher sollten Sie prüfen, ob der Upload erfolgreich war, indem Sie die vom /uploadUrl-Endpunkt zurückgegebene
accessUrlin einem Browser öffnen. Sie können auch den Verify-URL-Endpunkt verwenden.

