Logs de todos los administradores

[ GET ]

Visión general

Recupera el historial de acciones web de todos los administradores de la compañía. Los resultados se entregan de forma paginada, con un máximo de 200 registros por página, y pueden filtrarse por fecha y ordenarse según las necesidades del reporte.

• URL: https://sync.airbagtech.io/manager/logs
• Compatibilidad: soporta paginación y filtros opcionales de fecha y ordenamiento.

Autenticación

Requiere el encabezado Authorization: apikey {API_KEY}. Las claves se solicitan a soporte de Airbag Tech y se renuevan periódicamente para mantener un control riguroso de accesos.

Encabezados

Encabezado	Valor	Descripción
Authorization	apikey {API_KEY}	Clave entregada por soporte para autorizar la operación.

Parámetros de consulta

Todos los parámetros son opcionales.

Parámetro	Tipo	Descripción
limit	Number	Número de registros por página. Máximo permitido: 200. Valor por defecto: 200.
page	Number	Número de página a consultar. Valor por defecto: 1.
sort	String	Campo por el cual ordenar los resultados.
direction	String	Dirección del ordenamiento: asc o desc.
startDate	String	Fecha de inicio del rango en formato ISO YYYY-MM-DD.
endDate	String	Fecha de fin del rango en formato ISO YYYY-MM-DD.

Ejemplo de solicitud

curl --location -g --request GET 'https://sync.airbagtech.io/manager/logs?page=1&limit=50&startDate=2024-01-01&endDate=2024-12-31' \
  --header 'Authorization: apikey ${API_KEY}'

Ejemplo de respuesta

{
  "status": true,
  "message": "Logs retrieved successfully",
  "page": 1,
  "limit": 50,
  "length": 2,
  "logs": [
    {
      "id": "abc123",
      "action": "update_driver",
      "companyId": "company-001",
      "managerId": "ADM-001",
      "created": "2024-06-15T10:32:00Z",
      "driverId": "DRV-042",
      "fullName": "Rosa González",
      "operationSuccess": true,
      "source": "web",
      "data": {}
    }
  ]
}

Campos del log

Campo	Tipo	Descripción
id	String	Identificador único del log.
action	String	Nombre de la acción ejecutada por el administrador.
companyId	String	Identificador de la compañía a la que pertenece el registro.
managerId	String	Identificador del administrador que realizó la acción.
created	String	Fecha y hora de la acción en formato ISO.
driverId	String	Conductor relacionado con la acción, si aplica.
vehicleId	String	Vehículo relacionado con la acción, si aplica.
scheduleId	String	Horario relacionado con la acción, si aplica.
routeId	String	Ruta relacionada con la acción, si aplica.
phone	String	Teléfono del recurso afectado, si aplica.
email	String	Correo del recurso afectado, si aplica.
fullName	String	Nombre completo del recurso afectado, si aplica.
status	String	Estado resultante del recurso tras la acción, si aplica.
operationSuccess	Boolean	Indica si la operación se completó correctamente.
source	String	Origen desde donde se ejecutó la acción (p. ej. web).
data	Object	Datos adicionales asociados a la acción.

Acciones disponibles

El campo action de cada log toma uno de los siguientes valores. Usa el buscador o navega por categoría para encontrar el que te interesa.

36 acciones

Usuarios

Altas, ediciones y cambios de estado sobre conductores y usuarios.

• user-created
• user-edited
• user-deleted
• user-disabled-enabled
• visited-specific-user
• send-lost-wa-template

Vehículos

Gestión de la flota vehicular.

• vehicle-created
• vehicle-edited
• vehicle-disabled

Rutas y horarios

Cambios en rutas y horarios asignados a la operación.

• route-created
• route-edited
• schedule-edited

Aplicación

Cambios de estado global de la app de Airbag.

• change-app-status

Navegación

Páginas del portal visitadas por el administrador.

• visited-users-page
• visited-vehicles-page
• visited-trips-page
• visited-routes-page
• visited-activities-page
• visited-analytics-page
• visited-performance-page
• visited-ranking-page
• visited-reports-page

Manuales y ayuda

Consultas al centro de ayuda y manuales por sección.

• view-manuals-page
• opened-airbag-xray
• opened-manual-airbag-xray
• opened-manual-analytics
• opened-manual-drivers
• opened-manual-driver-1
• opened-manual-driver-2
• opened-manual-groups
• opened-manual-home
• opened-manual-main-pdf
• opened-manual-map
• opened-manual-ranking
• opened-manual-reports
• opened-manual-routes

Respuestas

• 200 OK: lista de logs devuelta con información de paginación.
• 400 Solicitud incorrecta: verifica los parámetros de fecha o de ordenamiento enviados.