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.

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 devuelta con información de paginación.
• 400 Solicitud incorrecta: verifica los parámetros de fecha o de ordenamiento enviados.