EnvíaloSimple Transaccional — API: Listar archivos

Endpoint

GET https://api.envialosimple.email/api/v1/files

Autenticación

Authorization: Bearer <clave API>

Descripción

Devuelve una lista de todos los archivos del gestor.

Parámetros

Nombre	Tipo	Descripción
limit	Integer	Registros por página. Por defecto: 10. Máximo: 100.
page	Integer	Número de página. Por defecto: 1.
sort	String	Ordenar por: name, created_date. Por defecto: created_date.
direction	String	Ordenamiento: asc (ascendente), desc (descendente). Por defecto: asc.
filters	String	Expresión para filtrar registros. Ejemplos: {"folder":"65805d337529c705a5266ce0"} filtra por carpeta; {"created_date":{"$gt":{"$ts":1704067200000}}} filtra por fecha mayor a; {"name":{"$regex":"prueba"}} filtra por nombre que contenga "prueba".

Respuesta

Campo	Descripción
id	ID del archivo
name	Nombre del archivo
extension	Extensión del archivo
folder	ID de la carpeta en la que se encuentra
file	URL del archivo
created_date	Fecha de creación (UTC+00:00)
thumbnail	URL de la miniatura del archivo

Errores

Campo	Descripción
id	ID del archivo
name	Nombre del archivo
extension	Extensión del archivo
folder	ID de la carpeta en la que se encuentra
file	URL del archivo
created_date	Fecha de creación (UTC+00:00)
thumbnail	URL de la miniatura del archivo

Ejemplo de respuesta

{
  "total": 5,
  "limit": 2,
  "page": 1,
  "payload": [
    {
      "id": "65807eca7529c705a5211d75",
      "name": "Ejemplo",
      "extension": "png",
      "folder": "65805d337529c705a5266ce0",
      "file": "https://filemanager.envialosimple.email/public/6452b270807877b0d107e2a5/1702919182347.png",
      "created_date": "2023-12-18T17:18:02+00:00",
      "thumbnail": "https://filemanager.envialosimple.email/public/6452b270807877b0d107e2a5/1702919182347_thumbnail.png"
    },
    {
      "id": "65807eb67529c705a5233d6a",
      "name": "Logo",
      "extension": "gif",
      "folder": "65805d337529c705a5266ce0",
      "file": "https://filemanager.envialosimple.email/public/6452b330807877b0d107e2a5/1702919862233.png",
      "created_date": "2023-12-18T17:17:42+00:00",
      "thumbnail": "https://filemanager.envialosimple.email/public/6452b330807877b0d107e2a5/1702919862233_thumbnail.png"
    }
  ]
}