5. Clientes
Instrucciones, comprobaciones y pasos de esta sección del manual.
Prueba esta ruta en el laboratorio
Abre el laboratorio estilo Postman, indica la URL de tu panel y envía la petición. Recuerda activar la API en Ajustes → Gestión de personal.
Activar, suspender o retirar actualiza el estado en la base de datos y aplica el corte o la reactivación en routers/RADIUS, con el mismo motor que el panel. La respuesta incluye network con el resultado de esa aplicación.
GET /customers
Lista clientes. Filtros: q, status. Permiso: clientes.usuarios.menu.
POST /customers
Permiso: clientes.usuarios.nuevo.
{
"name": "Joel Garcia",
"document": "3900914",
"email": "joel@ejemplo.com",
"phone": "",
"mobile": "04141234567",
"address": "Calle 1",
"status": "ACTIVO"
}
GET /customers/{id}
Detalle de un cliente. Permiso: clientes.usuarios.menu.
PUT /customers/{id}
Mismos campos que el alta; todos opcionales. Permiso: clientes.usuarios.editar.
DELETE /customers/{id}
Permiso: clientes.usuarios.eliminar.
POST /customers/{id}/activate
POST /customers/{id}/suspend
POST /customers/{id}/retire
curl -X POST https://TU-DOMINIO/api/v1/customers/12/suspend \
-H "Authorization: Bearer TOKEN" \
-H "Accept: application/json"