Logs de un administrador

[ GET ]

Visión general

Recupera el historial de acciones web de un administrador en particular, identificado por su MANAGER_ID. Los resultados pueden filtrarse por rango de fechas y ordenarse para facilitar auditorías o revisiones operativas.

• URL: https://sync.airbagtech.io/manager/{MANAGER_ID}/logs
• Compatibilidad: soporta filtros opcionales de fecha y ordenamiento.

warning

Por ahora este endpoint devuelve las acciones de todos los administradores de tu compañía, y todas aparecen con el managerId consultado. Se está corrigiendo; mientras tanto, para auditar a un administrador en particular usa Logs de administradores y filtra por su airbagId en managerId.

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 ruta

Parámetro	Tipo	Requerido	Descripción
MANAGER_ID	String	Sí	Identificador único del administrador cuyos logs se desean consultar. Acepta el ID que tu empresa usó al crearlo o el airbagId.

Parámetros de consulta

Todos los parámetros son opcionales.

Parámetro	Tipo	Descripción
limit	Number	Número máximo de registros a devolver.
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/ADM-001/logs?startDate=2024-01-01&endDate=2024-12-31' \
  --header 'Authorization: apikey ${API_KEY}'

Ejemplo de respuesta

{
  "status": true,
  "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": {}
    },
    {
      "id": "def456",
      "action": "deactivate_vehicle",
      "companyId": "company-001",
      "managerId": "ADM-001",
      "created": "2024-05-20T14:45:00Z",
      "vehicleId": "VEH-007",
      "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 interno de Airbag de la compañía a la que pertenece el registro.
managerId	String	El MANAGER_ID con el que hiciste la consulta.
created	String	Fecha y hora de la acción en formato ISO.
driverId	String	Conductor relacionado con la acción, si aplica. Es el airbagId del conductor (para el ID de tu empresa usa data.driverId).
vehicleId	String	Vehículo relacionado con la acción, si aplica. Es el airbagId del vehículo (para el ID de tu empresa usa data.vehicleId).
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. Sólo puede incluir driverId, vehicleId, schedule, name, lastName, phone, newStatus y newAppStatus, según la acción; driverId y vehicleId son los IDs definidos por tu empresa (o el airbagId si no se pudo resolver). Puede venir vacío ({}).

Actions

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 del administrador devuelta correctamente.
• 400 Solicitud incorrecta: verifica el MANAGER_ID y los parámetros enviados.
• 404 No encontrado: el MANAGER_ID no existe o no tiene registros asociados.