MediosListar los medios
Volver a Sofia

Medios

Listar los medios

Lista la biblioteca de medios de un establecimiento, los más recientes primero, por páginas, con URL firmadas para la ventana actual. Vale en prueba y 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"

Autorizaciones

  • Authorizationstringobligatorio

    Tu clave personal o token de acceso OAuth, enviado como Bearer <token>.

Parámetros de consulta

  • establishmentIdstringobligatorio

    El establecimiento cuya biblioteca de medios se lee.

  • cursorstring

    El nextCursor de la página anterior.

  • limitnumber

    Tamaño de página, de 1 a 100 (20 por defecto).

Respuesta

200application/json

Una página de medios, con nextCursor cuando hay más.

  • dataobject[]obligatorio

    Los medios de la página

    Mostrar atributos hijos
    • idstringobligatorio

      Identificador del medio, para pasar en media[].id de una publicación

    • typestringobligatorio

      Tipo del medio

      Valores permitidos: imagevideo

    • urlstringobligatorio

      Dirección firmada, válida para la ventana actual

    • fileNamestringobligatorio

      Nombre del archivo

    • contentTypestringobligatorio

      Tipo MIME del archivo

    • sizenumberobligatorio

      Tamaño en bytes

    • createdAtstring<date-time>obligatorio

      Cuándo se añadió el medio

    • thumbnailUrlstring

      Miniatura firmada (póster de un vídeo, cuadrado de una imagen)

  • nextCursorstring

    Pásalo como ?cursor= para la página siguiente; ausente al final

400

invalid_cursor, o invalid_request.

404

establishment_not_found: el establecimiento está fuera del alcance del token.

4XXapplication/json

Cualquier otro error, en el sobre de error.