REST APIPOST

Medien-Upload

Laden Sie Bilder und Videos mit vorsignierten URLs hoch

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://post.adaptlypost.com/post/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
Upload-URLs abrufen
curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/upload-urls \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "files": [
      {
        "fileName": "product-photo.jpg",
        "mimeType": "image/jpeg"
      }
    ]
  }'
Datei hochladen
curl --request PUT \
  --url "https://storage.adaptlypost.com/presigned/abc123..." \
  --header 'Content-Type: image/jpeg' \
  --data-binary @product-photo.jpg
200
{
  "urls": [
    {
      "fileName": "product-photo.jpg",
      "uploadUrl": "https://storage.adaptlypost.com/presigned/abc123...",
      "publicUrl": "https://cdn.adaptlypost.com/uploads/product-photo.jpg",
      "key": "uploads/usr_001/product-photo.jpg",
      "expiresAt": "2026-03-14T13:00:00Z"
    }
  ]
}