Nombre del servicio
GET https://api.envialosimple.email/api/v1/files
Método de autenticación
Authorization: Bearer
Para más detalle de cómo generar la clave API ver: Cómo enviar emails desde la API
Descripción
Devuelve una lista de todos los archivos del gestor.
Parámetros
|
Nombre
|
Tipo
|
Descripción
|
|
limit |
Integer | Cantidad de registros por página. Por defecto: 10. Máximo: 100. |
| page | Integer | Número de página. Por defecto: 1. |
| sort | String |
Ordenar por. Valores posibles: name ➔ Nombre. created_date ➔ Fecha de creación. Por defecto: Fecha de creación. |
| direction | String |
Tipo de ordenamiento. Valores posibles: asc ➔ Ascendente. desc ➔ Descendente. Por defecto: Ascendente. |
| filters | String |
Expresión para filtrar los registros. Ver detalle de la Generación de expresiones (*). Ejemplos: {"folder":"65805d337529c705a5266ce0"}➔ Filtra por una 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 de archivo. |
| name | Nombre del archivo. |
| extension | Extensión del archivo. |
| folder | ID de carpeta en la que se encuentra. |
| file | Url del archivo. |
| created_date | Fecha de creación. Zona horaria UTC+00:00. |
| thumbnail | Url de la miniatura del archivo. |
Errores
| Error | Descripción |
| invalid_direction | El tipo de ordenamiento es incorrecto. Verifique los posibles valores. |
| invalid_page | El número de página ingresado es incorrecto. Debe ser un número entero positivo. |
| invalid_limit |
La cantidad de registros por página es incorrecta. Debe ser un número entero positivo. |
| malformed_filter | La expresión para filtrar los registros ingresada es incorrecta. Ver detalle de la Generación de expresiones (*). |
Ejemplo de respuesta
{
"total": 5,
"limit": 2,
"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"
}
],
"page": 1
}
Comentarios
0 comentarios
El artículo está cerrado para comentarios.