MédiasLister les médias
Retour à Sofia

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
GET/v1/media
curl -X GET 'https://api.sofia-post.com/api/v1/media' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Autorisations

  • Authorizationstringrequis

    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

200application/json

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

400

invalid_cursor, ou invalid_request.

404

establishment_not_found : l’établissement n’est pas accessible au jeton.

4XXapplication/json

Toute autre erreur, dans l’enveloppe d’erreur.