Saltar al contenido principal

GET | /

Función que Realiza

Devuelve un array con un listado de clientes que cumplen con las siguientes condiciones:

  • No está suspendido.
  • Su "ol" es false.
  • Su frecuencia no debe ser "Deposito".

Funcionamiento

  • URL Completa: {domain}/api/v1/clients/
  • Acción: GET
  • Requiere Api-Key?: Si
  • Requiere una Sesión?: Si
  • Recibe datos mediante: Query
    • Cantidad de datos: 7
  • Responde con contenido?: Si
  • Responde únicamente con código de estado?: No
    • Código: 200 | Ok
  • Códigos de error: Vea la sección Errores

Contenido que recibe por Query

frequency = Enum('Lunes', 'Martes', 'Miercoles', 'Jueves', 'Viernes', 'Sábado'),
search? = String,
channel? = String,
gec? = String,
route? = String,
page = Int,
pageSize = Int
info
  1. No importa si se ingresa la fecuencia con mayúsculas, minúsculas o con tildes, la api convierte todo a minúsculas y remueve las tildes al verificar.

  2. El campo de busqueda va a filtrar por estas 3 propiedades: codigocliente, razon_social y frecuencia.

    • Se va a filtrar por la propiedad "codigocliente" únicmanete cuando se ingrese un número.

Contenido que devuelve por Body

{
"meta": {
"page": Int,
"pageSize": Int,
"count": Int,
"total": Int
},
"clients": [
{
"id": Int,
"socialReason": "String",
"address": "String",
"groupingChannel": "String",
"status": "String",
"frequency": "String",
"gec": "String",
"coords": {
"latitude": "String",
"longitude": "String"
}
}
]
}

Códigos de Error

HTTP CodeCustom CodeMessage
422INVALID_REQUEST_DATALos datos enviados son inválidos o insuficientes.
422INVALID_PAGE_NUMBERLa página debe ser un número.
422INVALID_PAGESIZE_NUMBEREl tamaño de página debe ser un número.
500UNEXPECTED_ERRORNo fue posible extraer el usuario de la solicitud.
401INVALID_API_KEYLa API Key proporcionada no es válida.
401INVALID_SESSIONLa sesión no es válida o ha expirado.
401INSUFFICIENT_PERMISSIONSNo tienes los permisos suficientes para acceder.