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."]
}
Journaux utilisateur et activité
Déclencher un export des journaux d'activité utilisateur
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."]
}
Met en file d’attente une tâche asynchrone qui génère un CSV de l’activité du compte (événements de création/mise à jour/suppression, connexions et partages) pour une plage de dates, sur l’hôte de l’API de gestion (
L’appel renvoie
api.scanova.io), authentifié avec votre clé d’API de gestion brute.
POST https://api.scanova.io/user-logs/export/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
Début de la plage d’export, au format
DD/MM/YYYY HH:MM (24 heures), exclusif.string
Fin de la plage d’export, au format
DD/MM/YYYY HH:MM (24 heures), inclusif.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 immédiatement une fois la tâche mise en file d’attente — id est l’id de la tâche d’export dans Lister l’historique des exports de journaux utilisateur, où vous interrogez status. Le compte reçoit un e-mail lorsque l’export se termine ou échoue.
fromDate/toDate ne sont pas validés de manière synchrone. Une chaîne de date mal formée ne produit pas de 400 ici — la tâche est créée et échoue seulement de manière asynchrone lorsque le worker tente de l’analyser, aboutissant à status: "failed" et un e-mail d’échec. Vérifiez toujours le format DD/MM/YYYY HH:MM avant l’envoi.403 si le plan du compte ne dispose pas du quota USER_LOGS_EXPORT, ou si un utilisateur partagé appelant cet endpoint ne dispose pas de la permission SHARED_USER_CAN_EXPORT_USER_LOGS :
403
{ "detail": "Your plan does not have user logs quota." }
Les enregistrements d’export terminés et leurs fichiers CSV sont conservés 14 jours, après quoi ils sont purgés automatiquement.
Voir aussi
- Lister l’historique des exports de journaux utilisateur — interroger le statut de la tâche.
- Supprimer un enregistrement de l’historique d’export — supprimer une tâche prématurément.
- Présentation de l’API de gestion — le schéma d’authentification et les règles de quota applicables à cet endpoint.
Autorisations
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.
Réponse
200 - application/json
Export job queued.
Cette page vous a-t-elle été utile ?