curl --request POST \
--url 'https://api.scanova.io/analytics/report/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv"
}'
{
"id": 59,
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv",
"status": "new",
"report_file": null,
"completed_on": null,
"is_saved": false,
"saved_name": null,
"created": "2026-09-08T10:20:00Z",
"requested_by_name": "Docs"
}
Analytique et forfaits
Générer un rapport d'analyses
POST /analytics/report/
POST
/
analytics
/
report
/
curl --request POST \
--url 'https://api.scanova.io/analytics/report/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv"
}'
{
"id": 59,
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv",
"status": "new",
"report_file": null,
"completed_on": null,
"is_saved": false,
"saved_name": null,
"created": "2026-09-08T10:20:00Z",
"requested_by_name": "Docs"
}
Met en file d’attente une tâche asynchrone qui génère un rapport de données de scan et/ou d’analyses couvrant un ensemble de codes QR, une étiquette ou un dossier.
L’appel renvoie
Nécessite une clé d’API de gestion avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX) — voir la présentation de l’API de gestion — plus le quota EXPORT_ANALYTICS_REPORT et la permission ANALYTICS_CAN_EXPORT_REPORT propres au compte.string
requis
Ce que
filter_data identifie : qrcode, tag ou folder.string
requis
Une chaîne encodée en JSON identifiant la ou les cible(s) — par ex. un tableau JSON de
qrid lorsque filter_type vaut qrcode.string
requis
Date de début (
YYYY-MM-DD).string
requis
Date de fin (
YYYY-MM-DD).string
défaut:"both"
scan_data, analytics ou both.string
défaut:"csv"
Format de fichier pour la partie analyses :
csv, xls, xlsx, png, jpeg ou pdf.string
défaut:"csv"
Format de fichier pour la partie données de scan : mêmes options que
analytics_format.object
Charge JSON de filtre supplémentaire optionnelle, superposée à
filter_type/filter_data.boolean
défaut:"false"
Exclut du rapport les scans identifiés comme trafic de bots.
boolean
défaut:"false"
Indique s’il faut conserver ce rapport comme préréglage réutilisable enregistré — voir Mettre à jour un rapport d’analyses enregistré.
string
Un nom pour le préréglage enregistré, requis si
is_saved vaut true. Doit être unique par compte — un doublon renvoie 400.curl --request POST \
--url 'https://api.scanova.io/analytics/report/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv"
}'
{
"id": 59,
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv",
"status": "new",
"report_file": null,
"completed_on": null,
"is_saved": false,
"saved_name": null,
"created": "2026-09-08T10:20:00Z",
"requested_by_name": "Docs"
}
201 immédiatement une fois la tâche mise en file d’attente, avec status: "new" — le rapport lui-même est généré en arrière-plan et le compte reçoit un e-mail à la fin. Interrogez Lister les rapports d’analyses pour connaître status et report_file.
Voir aussi
- Lister les rapports d’analyses — interroger le statut de la tâche.
- Mettre à jour un rapport d’analyses enregistré — renommer ou gérer un préréglage enregistré.
- Présentation de l’API de gestion — le schéma d’authentification et l’architecture de quotas dont fait partie 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: YOUR_API_KEY. 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
201 - application/json
Report job queued.
Cette page vous a-t-elle été utile ?