Médias

Lister les médias

Liste la médiathèque d’un établissement, les plus récents d’abord, page par page, avec des URL signées pour la fenêtre en cours. Fonctionne en test et en live.

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

Lister les médias

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

Lister les médias

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

Les médias d’un établissement sont renvoyés les plus récents d’abord, page par page : voir la pagination.

L’url de chaque média est signée et expire : conservez l’id, et relisez le média avec `GET /v1/media/{id}` quand il vous faut une URL fraîche.

Autorisations

Authorizationstringheaderrequis
Votre clé personnelle ou jeton d’accès OAuth, envoyé sous la forme Bearer <token>.

Paramètres de requête

establishmentIdstringrequis
L’établissement dont la médiathèque est lue.
cursorstring
Le nextCursor de la page précédente.
limitnumber
Taille de page, de 1 à 100 (20 par défaut).

Réponse

Une page de médias, avec nextCursor quand il y en a d’autres.

dataobject[]requis
Les médias de la page
Afficher les attributs enfants
- idstringrequis
  Identifiant du média, à passer dans media[].id d’une publication
- typestringrequis
  Type du média
  Valeurs autorisées : imagevideo
- urlstringrequis
  Adresse signée, valable pour la fenêtre en cours
- fileNamestringrequis
  Nom du fichier
- contentTypestringrequis
  Type MIME du fichier
- sizenumberrequis
  Taille en octets
- createdAtstring<date-time>requis
  Moment où le média a été ajouté
- thumbnailUrlstring
  Miniature signée (affiche d’une vidéo, carré d’une image)
nextCursorstring
À passer en ?cursor= pour la page suivante ; absent à la fin

Cette page vous a-t-elle aidé ?