Zum Hauptinhalt springen
POST
Dieser Endpunkt ermöglicht es Ihnen, eine Datei bzw. ein Bild oder ein kleines Video hochzuladen, das in Ihren Beitrag eingefügt werden soll. Zurückgegeben wird die URL zum Bild, die im /post-Endpunkt verwendet werden kann. Sie können die Datei entweder als Multipart-Form-Data als Formularparameter oder als Base64-kodierte Datei als Body-Parameter übergeben. Wichtige Hinweise zu Medien-Uploads:
  1. Für die beste Performance empfehlen wir:
    • Hosten Sie Mediendateien auf Ihrem eigenen Server (z. B. AWS S3).
    • Übergeben Sie die Medien-URL direkt im Parameter mediaUrls des Endpunkts /post.
    • Dieser Ansatz ist schneller als das Hochladen von Dateien über diesen Endpunkt.
  2. Aufbewahrung von Mediendateien
    • Hochgeladene Dateien werden 90 Tage lang gespeichert.
    • Nach 90 Tagen:
      • Veröffentlichte Beiträge in sozialen Netzwerken bleiben unberührt.
      • Geplante Beiträge können nicht veröffentlicht werden, wenn sie auf abgelaufene Medien verweisen.
  3. Dateigrößenbeschränkungen
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

Content-Type
string
erforderlich
Verwenden Sie multipart/form-data, wenn Sie Multipart-Form-Data senden – siehe unten. Andernfalls senden Sie das übliche application/json.

Body-Parameter

file
string or object
erforderlich
Maximale Dateigröße 30 MB.Wir empfehlen, die Datei als Multipart-Form-Data-Objekt zu senden anstelle einer Base64-Kodierung.
fileName
string
Der Name der hochzuladenden Datei.
description
string
Eine Beschreibung der Datei.

Als Multipart-Form-Data senden

Senden Sie die Mediendatei als Multipart-Form-Data-Objekt. Achten Sie darauf, den Content-Type wie oben erwähnt anzugeben.

Als Base64 senden

Senden Sie die Mediendatei als Base64-kodierten String im Data-URI-Format. Der String sollte mit data:content/type;base64 beginnen. Beispiel-Kodierung mit Ausgabeformat Data URI: Hinweis: Der /post-Endpunkt akzeptiert größere Dateien über eine externe URL mit dem Parameter mediaUrls.