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.

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.

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 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.

Actions

action
change-app-status
opened-airbag-xray
opened-manual-airbag-xray
opened-manual-analytics
opened-manual-driver-1
opened-manual-driver-2
opened-manual-drivers
opened-manual-groups
opened-manual-home
opened-manual-main-pdf
opened-manual-map
opened-manual-ranking
opened-manual-reports
opened-manual-routes
route-created
route-edited
schedule-edited
send-lost-wa-template
user-created
user-deleted
user-disabled-enabled
user-edited
vehicle-created
vehicle-disabled
vehicle-edited
view-manuals-page
visited-activities-page
visited-analytics-page
visited-performance-page
visited-ranking-page
visited-reports-page
visited-routes-page
visited-specific-user
visited-trips-page
visited-users-page
visited-vehicles-page

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.