Medien

Medium importieren oder hochladen

Fügt der Mediathek eines Betriebs eine Datei (Multipart) oder eine https-URL hinzu, die Sofia abruft. Erfordert eine Live-App und ein aktives Abonnement.

POSThttps://api.sofia-post.com/api/v1/media

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

{
  "id": "string",
  "type": "image",
  "url": "string"
}

Medium importieren oder hochladen

curl --request POST \
  --url 'https://api.sofia-post.com/api/v1/media' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "establishmentId": "string",
  "url": "https://cdn.example.com/tarte-tatin.jpg"
}'

{
  "id": "string",
  "type": "image",
  "url": "string"
}

Von einer URL importieren

Sende 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.

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 sende die Datei selbst als multipart/form-data, mit einem Feld file.

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

{
  "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 ein ö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: Behalte die id und lies das Medium mit GET /v1/media/{id} erneut, wenn du eine frische URL brauchst.

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

Autorisierungen

Authorizationstringheadererforderlich
Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Header

Idempotency-Keystring
Mit demselben Body wiederholt, liefert die Anfrage dieselbe Antwort, ohne zweiten Import. Sie gilt für die Formularfelder, nicht für die Bytes der Datei.

Body

application/json, multipart/form-data

establishmentIdstringerforderlich
Der Betrieb, dessen Mediathek das Medium erhält
urlstring
JSON: die https-Adresse des Mediums, das Sofia selbst abruft (keine Datei)
filestring<binary>
multipart/form-data: die Datei (Bild oder Video), ohne url

Antwort

Das der Mediathek hinzugefügte Medium.

idstringerforderlich
Kennung des Mediums, in media[].id eines Beitrags zu übergeben
typestringerforderlich
Art des Mediums
Zulässige Werte: imagevideo
urlstringerforderlich
Signierte Adresse, für das aktuelle Zeitfenster gültig

War diese Seite hilfreich?