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

Listar los medios

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

Listar los medios

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

Los archivos de un establecimiento se devuelven con los más recientes primero, página a página: consulta la paginación.

La url de cada archivo está firmada y caduca: conserva el id, y vuelve a leer el archivo con `GET /v1/media/{id}` cuando necesites una URL nueva.

Autorizaciones

Authorizationstringheaderobligatorio
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

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

¿Te ha resultado útil esta página?