Skip to main content
POST
Exporte des enregistrements d’analyse bruts, par scan — une ligne par événement de scan, plutôt que les répartitions agrégées que renvoient Analyses des QR codes et Exporter les analyses.
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_RAW (distincte de la permission ANALYTICS_CAN_EXPORT requise par l’export agrégé — un rôle peut avoir l’une sans l’autre). Une erreur 403 avec « Your plan does not have export analytics report quota. » signifie que le plan n’inclut pas les exports.

​
Requête

Cet endpoint renvoie toujours un fichier binaire, pas du JSON.

​
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 ou xlsx. Contrairement à Exporter les analyses, pdf n’est pas un format pris en charge ici. Toute autre valeur (ou son omission) renvoie une erreur 400 avec « Invalid file format ».
​
string
Passez raw_bot pour exporter uniquement les enregistrements de scans identifiés comme des bots, plutôt que tous les scans. Toute autre valeur est écrasée — cet endpoint exporte toujours des données brutes, quelle que soit la valeur transmise ici.

​
Corps de la requête

Même structure que Analyses des QR codes — q (obligatoire) et filter_by (par défaut qrid) délimitent les QR codes dont les scans bruts doivent être inclus, et le même plafond de volume QR codes/plage de dates s’applique.
​
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

Renvoie un unique CSV (text/csv, analytics_raw.csv) contenant les lignes de scans bruts.
Si le compte a les analyses de suivi d’événements activées et que file_format n’est pas csv, une seconde feuille/section d’enregistrements bruts de suivi d’événements (ID de session, horodatage, ID/nom du QR code, ID de suivi d’événement spécifié par l’utilisateur, hash d’URL, URL) est ajoutée automatiquement. Demander csv renvoie toujours uniquement les enregistrements de scans — les lignes de suivi d’événements sont omises spécifiquement pour ce format.

​
Voir aussi

Autorisations

​
Authorization
string
header
requis

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

​
from
string<date>
requis
​
to
string<date>
requis
​
file_format
enum<string>
requis
Options disponibles:
csv,
xls,
xlsx
​
type
enum<string>

Pass raw_bot for a bot-only export; any other value is overwritten to raw.

Options disponibles:
raw_bot

Corps

application/json
​
q
string[]
requis
​
filter_by
enum<string>
défaut:qrid
Options disponibles:
qrid,
tags,
id,
folder

Réponse

Binary file download — text/csv for csv, spreadsheet mimetype for xls/xlsx.