MedienMedien auflisten
Zurück zu Sofia

Medien

Medien auflisten

Listet die Mediathek eines Betriebs auf, neueste zuerst, seitenweise, mit URLs, die für das aktuelle Zeitfenster signiert sind. Funktioniert im Test und live.

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

Autorisierungen

  • Authorizationstringerforderlich

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

Abfrageparameter

  • establishmentIdstringerforderlich

    Der Betrieb, dessen Mediathek gelesen wird.

  • cursorstring

    Der nextCursor der vorherigen Seite.

  • limitnumber

    Seitengröße von 1 bis 100 (Standard 20).

Antwort

200application/json

Eine Seite Medien, mit nextCursor, wenn weitere folgen.

  • dataobject[]erforderlich

    Die Medien der Seite

    Untergeordnete Attribute anzeigen
    • 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

    • fileNamestringerforderlich

      Name der Datei

    • contentTypestringerforderlich

      MIME-Typ der Datei

    • sizenumbererforderlich

      Größe in Bytes

    • createdAtstring<date-time>erforderlich

      Wann das Medium hinzugefügt wurde

    • thumbnailUrlstring

      Signiertes Vorschaubild (Poster eines Videos, Quadrat eines Bildes)

  • nextCursorstring

    Als ?cursor= für die nächste Seite übergeben; am Ende fehlt er

400

invalid_cursor oder invalid_request.

404

establishment_not_found: Der Betrieb ist für das Token nicht erreichbar.

4XXapplication/json

Jeder andere Fehler, im Fehlerumschlag.