MedienMedium importieren oder hochladen
Zurück zu Sofia

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
POST/v1/media

Diese Anfrage wirkt auf Ihr echtes Konto.

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"}'

Autorisierungen

  • Authorizationstringerforderlich

    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

201application/json

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

400

Fehlerhafter Body.

401

Das Token fehlt, ist unbekannt, abgelaufen oder widerrufen.

402

subscription_required.

403

live_mode_required bei einer Test-Anwendung, oder die Berechtigung media:write fehlt.

404

Betrieb außerhalb des Workspace des Tokens.

413

payload_too_large: über der Größenbeschränkung der App.

422

media_import_refused, mit Grund: private_address, too_large, unsupported_media, unreachable, timeout, invalid_url, redirect_limit oder removed_from_library. media_upload_refused bei einer Datei.

4XXapplication/json

Jeder andere Fehler, im Fehlerumschlag.