Zum Hauptinhalt springen
GET
Für Datei-Uploads größer als 10 MB erhalten Sie eine presigned URL zum Hochladen einer Datei.
  • 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.
Wenn Ihre Medien bereits über eine externe URL zugänglich sind, etwa über einen S3-Bucket, können Sie den Upload der Dateien zu Ayrshare überspringen. Senden Sie einfach eine POST-Anfrage an den /post-Endpunkt mit Ihrer extern zugänglichen URL im Body-Parameter mediaURLs, und Ihre Datei wird automatisch hochgeladen.

Header-Parameter

Query-Parameter

fileName
string
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.
contentType
string
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

  • accessUrl ist die URL, unter der nach dem Upload auf die Mediendatei zugegriffen werden kann.
  • contentType ist der Content-Type, der für die hochzuladenden Medien gesetzt wurde. Verwenden Sie ihn im Header Content-Type beim Hochladen der Medien.
  • uploadUrl ist 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/uploadUrl eine uploadURL und eine accessURL ab. Siehe oben.
  • Laden Sie die Datei per PUT hoch, mit Content-Type auf den zurückgegebenen contentType gesetzt.
  • Laden Sie die Medien hoch, indem Sie --upload-file mit einer Mediendatei und der uploadUrl verwenden.
  • 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 der accessUrl im Body-Parameter mediaUrls.
  • 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.
Stellen Sie sicher, dass der beim Erstellen der 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 die uploadUrl hochzuladen. In Postman:
  1. Wählen Sie die HTTP-Methode PUT.
  2. Fügen Sie Ihre uploadUrl in 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 die uploadUrl neu generieren.
  3. Setzen Sie in Headers den Content-Type auf den Content-Type, der vom /uploadUrl-Endpunkt zurückgegeben wurde. Beispiel: Content-Type: image/png.
  4. Wählen Sie Body -> binary und wählen Sie die hochzuladende Datei aus.
  5. Klicken Sie auf Send.
  6. 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 accessUrl in einem Browser öffnen. Sie können auch den Verify-URL-Endpunkt verwenden.
Postman Binary Upload

Postman-Beispiel-JSON-Datei