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

Medien auflisten

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

{
  "data": [
    {
      "id": "string",
      "type": "image",
      "url": "string",
      "fileName": "tarte-tatin.jpg",
      "contentType": "image/jpeg",
      "size": 482113,
      "createdAt": "2026-11-02T10:00:00.000Z"
    }
  ]
}

Medien auflisten

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/media?establishmentId=<establishmentId>' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "type": "image",
      "url": "string",
      "fileName": "tarte-tatin.jpg",
      "contentType": "image/jpeg",
      "size": 482113,
      "createdAt": "2026-11-02T10:00:00.000Z"
    }
  ]
}

Die Medien eines Betriebs werden mit den neuesten zuerst zurückgegeben, Seite für Seite: siehe die Paginierung.

Die url jedes Mediums 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.

Autorisierungen

Authorizationstringheadererforderlich
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

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

War diese Seite hilfreich?