Listar carpetas

Soporte Donweb
Soporte Donweb
  • Actualización

Nombre del servicio

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

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 todas las carpetas de 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.

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:

{"id":"65788b8f4a1c0010b000076c"} ➔ Filtra por un ID de carpeta

{"name":{"$regex":"prueba"}} ➔ Filtra por nombre que contenga “prueba”

Respuesta

Campo Descripción
id ID de carpeta.
name Nombre de carpeta.

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": "65788b8f4a1c0000b000076c",
"name": "Productos"
},
{
"id": "65805d337529c705a5266ce0",
"name": "Logos"
}
],
"page": 1
}

¿Fue útil este artículo?

Usuarios a los que les pareció útil: 0 de 0

¿Tiene más preguntas? Enviar una solicitud

Comentarios

0 comentarios

El artículo está cerrado para comentarios.