REST API

Medien-Upload

Bilder und Videos über vorsignierte URLs hochladen

Der Medien-Upload ist ein zweistufiger Prozess: Zuerst fordern Sie eine vorsignierte Upload-URL an, dann laden Sie Ihre Datei direkt über diese URL hoch. Dies hält Ihre Dateien sicher und ermöglicht große Uploads.
POSThttps://api.adaptlypost.com/api/v1/upload-urls

Fordern Sie vorsignierte Upload-URLs für eine oder mehrere Dateien an. Sie können bis zu 20 URLs in einem einzigen Aufruf anfordern.

API-Schlüssel (Bearer-Token)

Body-Parameter

ParameterTypBeschreibung
filesERFORDERLICHFileUploadRequest[]Array von Dateimetadaten (1-20 Einträge)
files[].fileNameERFORDERLICHstringOriginaler Dateiname
files[].mimeTypeERFORDERLICHstringimage/jpeg, image/png, image/webp, video/mp4 oder video/quicktime

Schritt 1: Upload-URLs abrufen

Senden Sie eine POST-Anfrage mit Dateimetadaten, um vorsignierte Upload-URLs zu erhalten. Siehe das Code-Panel für eine Beispielanfrage und -antwort.

Schritt 2: Datei hochladen

Verwenden Sie die uploadUrl aus der Antwort, um Ihre Datei über eine PUT-Anfrage hochzuladen. Siehe das Code-Panel für ein Beispiel.

Schritt 3: In einem Beitrag verwenden

Übergeben Sie die publicUrl aus der Upload-Antwort als mediaUrls-Eintrag beim Erstellen eines Beitrags.

Ablauf der Upload-URL

Vorsignierte URLs laufen nach 1 Stunde ab. Laden Sie Ihre Datei vor dem expiresAt-Zeitstempel hoch oder fordern Sie eine neue URL an.

Unterstützte Formate

TypMIME-Typen
Bilderimage/jpeg, image/png, image/webp
Videosvideo/mp4, video/quicktime