Actividad de la Empresa
Devuelve una lista de registros de actividad que coinciden con los criterios de búsqueda, para la empresa del usuario que ha iniciado sesión. (Solo Administradores de Empresa).
Para obtener una lista completa de las actividades que se registran, consulte Qué información se registra.
Puede recuperar todas las actividades de la empresa que se han realizado utilizando esta solicitud sin especificar ningún parámetro opcional. También puede recuperar registros para un nombre de actividad específico, UID de usuario, tipo de usuario, servicio y rango de fechas. Utilizando el parámetro q, también puede realizar una búsqueda aproximada, que se comparará parcialmente con el nombre de la actividad y el nombre de inicio de sesión del usuario.
Puede encontrar los valores de activityName en el punto final /v3/companyActivityNames. El userUid puede ser un UID de usuario o un ID de cliente de clave API. El userType puede ser uno de estos valores: USER, STAFF, API, M2M, SYSTEM.
Los valores de fecha from y to deben ingresarse en el formato de fecha ISO 8601 (YYYY-MM-DD’T’HH:MM:SSZ). Por ejemplo, 2025-07-20 especifica el 20 de agosto de 2025. Para obtener más información, consulte Formato de fecha y hora ISO 8601.
La respuesta contiene detalles que incluyen el nombre del usuario, el ID del usuario (personId), una descripción de la actividad que ocurrió, el nombre de la actividad, la fecha en que ocurrió la actividad y el tipo de usuario.
createDate se devuelve en formato de marca de tiempo UNIX. Puede usar herramientas como https://www.epochconverter.com/ o https://it-tools.tech/date-converter para convertir la fecha a un formato legible por humanos.
¿Quién puede ver las actividades?
Los Administradores de Empresa pueden recuperar todas las actividades de la empresa a la que pertenece el usuario utilizando esta solicitud. Sin embargo, la misma solicitud realizada por un usuario que no es Administrador de Empresa devolverá un error con el mensaje “Falta el permiso requerido [company_admin]”. Se devuelve el mismo resultado si un Administrador de Empresa intenta acceder a las actividades de otras empresas.
Parámetros de consulta
Objeto de paginación que utiliza los parámetros de paginación y ordenación (pageSize, pageNumber, sort). Por defecto, pageSize(10), pageNumber(1) y sort(createDate,desc). (Opcional - Booleano)
El nombre de la actividad. (Opcional - cadena)
El UID del usuario. Puede ser un UID de usuario o un ID de cliente de clave API. (Opcional - cadena)
El tipo de usuario. La búsqueda no distingue entre mayúsculas y minúsculas. Valores aceptados: USER, STAFF, API, M2M, SYSTEM. (Opcional - cadena)
El identificador único de la entidad objetivo asociada con la actividad. Por ejemplo, un Uid de servicio técnico. (Opcional - cadena)
Parámetro de búsqueda aproximada. Esto se compara parcialmente con el nombre de la actividad y el nombre de inicio de sesión del usuario. (Opcional - cadena)
La fecha de inicio para la cual se deben devolver actividades. Introduzca la fecha en formato ISO 8601: YYYY-MM-DD'T'HH:MM:SSZ. (Opcional)
La fecha de finalización para devolver actividades. Introduzca la fecha en formato ISO 8601: YYYY-MM-DD'T'HH:MM:SSZ. (Opcional)
Respuesta
Actividad de la Empresa - Toda la Actividad / Actividad de la Empresa - Actividad de Inicio de Sesión / Actividad de la Empresa - Tipo de Usuario / Actividad de la Empresa - Búsqueda por Nombre de Usuario / Actividad de la Empresa - Actividad de Servicio / Actividad de la Empresa - Actividad de Inicio de Sesión / Actividad de la Empresa - Búsqueda por Nombre de Usuario / Actividad de la Empresa - Tipo de Usuario / Actividad de la Empresa - Toda la Actividad / Actividad de la Empresa - Actividad de Servicio