MedienEin Medium abrufen
Zurück zu Sofia

Medien

Ein Medium abrufen

Liefert ein Medium der Mediathek mit einer für das aktuelle Zeitfenster gültigen signierten URL, damit Sie seine Kennung in einem Beitrag nutzen können.

GEThttps://api.sofia-post.com/api/v1/media/{id}
GET/v1/media/{id}
curl -X GET 'https://api.sofia-post.com/api/v1/media/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Autorisierungen

  • Authorizationstringerforderlich

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

Pfadparameter

  • idstringerforderlich

    Kennung des Mediums.

Antwort

200application/json

Das Medium und seine signierte URL.

  • 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

401

Das Token fehlt, ist unbekannt, abgelaufen oder widerrufen.

403

Dem Token fehlt die Berechtigung media:read.

404

media_not_found: außerhalb der Betriebe des Workspace.

4XXapplication/json

Jeder andere Fehler, im Fehlerumschlag.