curl -X POST "https://api.scanova.io/user-logs/export/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "fromDate": "01/09/2026 00:00", "toDate": "07/09/2026 23:59" }'
{
"id": 483,
"message": ["User Logs Export is in progress. You will receive an email on completion."]
}
Registros de usuario y actividad
Iniciar una exportación de registros de actividad del usuario
POST /user-logs/export/
POST
/
user-logs
/
export
/
curl -X POST "https://api.scanova.io/user-logs/export/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "fromDate": "01/09/2026 00:00", "toDate": "07/09/2026 23:59" }'
{
"id": 483,
"message": ["User Logs Export is in progress. You will receive an email on completion."]
}
Encola un trabajo asíncrono que genera un CSV de la actividad de la cuenta (eventos de creación/actualización/eliminación, inicios de sesión y comparticiones) para un rango de fechas, en el host de la API de gestión (
La llamada devuelve
api.scanova.io), autenticado con su clave de API de gestión sin procesar.
POST https://api.scanova.io/user-logs/export/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
Inicio del rango de exportación, como
DD/MM/YYYY HH:MM (formato de 24 horas), exclusivo.string
Fin del rango de exportación, como
DD/MM/YYYY HH:MM (formato de 24 horas), inclusivo.curl -X POST "https://api.scanova.io/user-logs/export/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "fromDate": "01/09/2026 00:00", "toDate": "07/09/2026 23:59" }'
{
"id": 483,
"message": ["User Logs Export is in progress. You will receive an email on completion."]
}
200 inmediatamente una vez que el trabajo está en cola — id es el id del trabajo de exportación en Listar historial de exportaciones de registros de usuario, donde puede consultar status. La cuenta recibe un correo electrónico cuando la exportación se completa o falla.
fromDate/toDate no se validan de forma síncrona. Una cadena de fecha con formato incorrecto no produce un 400 aquí — el trabajo se crea y solo falla de forma asíncrona cuando el worker intenta analizarlo, terminando en status: "failed" y un correo de fallo. Verifique siempre el formato DD/MM/YYYY HH:MM antes de enviar.403 si el plan de la cuenta carece de la cuota USER_LOGS_EXPORT, o si un usuario compartido que llama a esto carece del permiso SHARED_USER_CAN_EXPORT_USER_LOGS:
403
{ "detail": "Your plan does not have user logs quota." }
Los registros de exportación completados y sus archivos CSV se conservan durante 14 días, tras los cuales se purgan automáticamente.
Relacionado
- Listar historial de exportaciones de registros de usuario — consultar el estado del trabajo.
- Eliminar un registro del historial de exportación — eliminar un trabajo antes de tiempo.
- Resumen de la API de gestión — el esquema de autenticación y las reglas de cuota que se aplican a este endpoint.
Autorizaciones
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Respuesta
200 - application/json
Export job queued.
¿Esta página le ayudó?