curl --request POST \
--url 'https://management.scanova.io/analytics/qr/export/?from=2026-07-01&to=2026-08-16&file_format=xlsx' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output analytics.xlsx
API de gestion — Analytique et forfaits
Exporter les analyses
POST /analytics/qr/export/
POST
/
analytics
/
qr
/
export
/
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/export/?from=2026-07-01&to=2026-08-16&file_format=xlsx' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output analytics.xlsx
Exporte des analyses agrégées — chaque type de métrique autorisé par le plan du compte (
Cet endpoint renvoie toujours un fichier binaire, pas du JSON — voir les formats de réponse ci-dessous.
count, date, qr, utm, device, os, browser, geography, et plus) — sous forme de fichier téléchargeable, plutôt qu’une seule charge utile JSON limitée à un seul type comme l’exige Analyses des QR codes.
Il s’agit d’un endpoint POST uniquement — une requête
GET renvoie 405 Method Not Allowed. La spécification management-api.json le listait auparavant comme GET ; ceci a été corrigé.Nécessite une clé Management API avec le quota
MANAGEMENT_API — voir la vue d’ensemble de la Management API — ainsi que le quota EXPORT_ANALYTICS_REPORT du compte et la permission ANALYTICS_CAN_EXPORT. Une erreur 403 avec « Your plan does not have export analytics report quota. » signifie que le plan n’inclut pas les exports.Requête
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/export/?from=2026-07-01&to=2026-08-16&file_format=xlsx' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output analytics.xlsx
Paramètres de requête
string
requis
Date de début (
YYYY-MM-DD), incluse.string
requis
Date de fin (
YYYY-MM-DD), incluse.string
requis
csv, xls, xlsx ou pdf. Toute autre valeur (ou son omission) renvoie une erreur 400 avec « Invalid file format ».boolean
défaut:"false"
Exclut de l’export les scans identifiés comme des bots.
Corps de la requête
Même structure que Analyses des QR codes :array
requis
Identifiants pour délimiter l’export — le type dépend de
filter_by.string
défaut:"qrid"
qrid, id, tags ou folder.Formats de réponse
- csv
- xls / xlsx
- pdf
Renvoie une archive ZIP (
application/zip, analytics.zip) contenant un CSV par type de métrique — et non un seul CSV plat. C’est une véritable particularité du format d’export : demander csv vous donne un zip, pas directement un fichier .csv.Renvoie un tableur unique (
analytics.xlsx) avec une feuille par type de métrique.Renvoie un rapport d’analyses PDF généré (
application/pdf, analytics.pdf) — un résumé mis en forme plutôt que des feuilles brutes par métrique.Si le compte a les analyses de suivi d’événements activées, ses métriques
count/engagement sont ajoutées automatiquement sous forme de feuilles/fichiers supplémentaires dans le même export — aucun paramètre supplémentaire n’est nécessaire.Malgré le message d’erreur sous-jacent suggérant de « générer un Export d’analyses à la place », cet endpoint applique exactement le même plafond de volume QR codes/plage de dates que Analyses des QR codes — tous les endpoints d’analyses partagent le même chemin de code de validation des requêtes. Si vous rencontrez l’erreur
400 sous q, réduisez q ou la plage de dates ; passer uniquement à cet endpoint ne l’évitera pas.Voir aussi
- Analyses des QR codes — l’équivalent JSON de cet export, limité aux types de métriques que vous choisissez.
- Exporter les analyses brutes — exportez des enregistrements de scans ligne par ligne plutôt que ces répartitions agrégées.
- Vue d’ensemble de la Management API — 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: 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. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Paramètres de requête
Options disponibles:
csv, xls, xlsx, pdf Corps
application/json
Réponse
Binary file download — application/zip for csv, spreadsheet mimetype for xls/xlsx, application/pdf for pdf.
Cette page vous a-t-elle été utile ?
⌘I