Medien

Endpoints

POST/v1/mediaGET/v1/mediaGET/v1/media/{id}DELETE/v1/media/{id}

Von einer URL importieren

Senden Sie JSON mit der establishmentId und einer öffentlichen https-url. Sofia lädt die Datei selbst herunter, prüft sie und legt sie in der Mediathek ab.

bash

curl -X POST https://api.sofia-post.com/api/v1/media \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"establishmentId":"'$ESTABLISHMENT_ID'","url":"https://images.example.com/tatin.jpg"}'

Eine Datei hochladen

Oder senden Sie die Datei selbst als multipart/form-data mit einem Feld file.

bash

curl -X POST https://api.sofia-post.com/api/v1/media \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -F establishmentId=$ESTABLISHMENT_ID \
  -F file=@tatin.jpg

json

{
  "id": "393d5aa4-16f1-430f-b1d8-1fb1473076ef",
  "type": "image",
  "url": "https://…/393d5aa4-16f1-430f-b1d8-1fb1473076ef.jpg?X-Amz-…"
}

Was akzeptiert wird

Bilder und Videos bis 200 MB.
Eine URL muss öffentliches https sein: Eine private Adresse, mehr als 3 Weiterleitungen oder mehr als 30 Sekunden Download werden abgelehnt.
Die zurückgegebene url ist signiert und läuft ab: Behalten Sie die id und lesen Sie das Medium mit GET /v1/media/{id} erneut, wenn Sie eine frische URL brauchen.

Eine abgelehnte Datei antwortet mit 422 media_import_refused oder media_upload_refused, mit dem Grund in details und dem weiteren Vorgehen in message.