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
Management-API — Analysen & Tarife
Analysen exportieren
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
Exportiert aggregierte Analysen — jeden Metriktyp, den der Plan des Kontos erlaubt (
Dieser Endpunkt gibt immer eine Binärdatei zurück, kein JSON — siehe die Antwortformate unten.
count, date, qr, utm, device, os, browser, geography und weitere) — als herunterladbare Datei, statt als einzelne JSON-Payload, die auf einen einzigen type beschränkt ist wie bei QR-Analysen erforderlich.
Dies ist ein ausschließlich POST-Endpunkt — eine
GET-Anfrage gibt 405 Method Not Allowed zurück. Die Spezifikation management-api.json führte ihn zuvor als GET auf; dies wurde korrigiert.Erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API-Quota — siehe die Management-API-Übersicht — sowie die EXPORT_ANALYTICS_REPORT-Quota und die ANALYTICS_CAN_EXPORT-Berechtigung des Kontos. Ein 403-Fehler mit "Your plan does not have export analytics report quota." bedeutet, dass der Plan keine Exporte enthält.Anfrage
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
Query-Parameter
string
erforderlich
Startdatum (
YYYY-MM-DD), inklusive.string
erforderlich
Enddatum (
YYYY-MM-DD), inklusive.string
erforderlich
csv, xls, xlsx oder pdf. Jeder andere Wert (oder das Weglassen) gibt einen 400-Fehler mit "Invalid file format" zurück.boolean
Standard:"false"
Schließt als Bot identifizierte Scans aus dem Export aus.
Request-Body
Dieselbe Form wie bei QR-Analysen:array
erforderlich
Bezeichner, auf die der Export beschränkt wird — der Typ hängt von
filter_by ab.string
Standard:"qrid"
qrid, id, tags oder folder.Antwortformate
- csv
- xls / xlsx
- pdf
Gibt ein ZIP-Archiv (
application/zip, analytics.zip) zurück, das eine CSV-Datei pro Metriktyp enthält — keine einzelne, flache CSV-Datei. Dies ist eine echte Eigenheit des Exportformats: Das Anfordern von csv liefert Ihnen ein Zip, keine direkte .csv-Datei.Gibt eine einzelne Tabelle (
analytics.xlsx) mit einem Blatt pro Metriktyp zurück.Gibt einen gerenderten PDF-Analysebericht (
application/pdf, analytics.pdf) zurück — eine formatierte Zusammenfassung statt roher Blätter pro Metrik.Wenn das Konto Event-Tracking aktiviert hat, werden dessen
count-/engagement-Metriken automatisch als zusätzliche Blätter/Dateien in denselben Export aufgenommen — ohne zusätzlichen Parameter.Trotz der zugrunde liegenden Fehlermeldung, die “generate Analytics Export instead” nahelegt, setzt dieser Endpunkt genau dieselbe QR-Code-Zahl-/Datumsbereich-Volumengrenze durch wie QR-Analysen — alle Analyse-Endpunkte teilen sich denselben Code-Pfad zur Anfragevalidierung. Wenn Sie auf den
400-Fehler unter q stoßen, grenzen Sie q oder den Datumsbereich ein — allein der Wechsel zu diesem Endpunkt umgeht ihn nicht.Verwandte Themen
- QR-Analysen — das JSON-Äquivalent dieses Exports, beschränkt auf die von Ihnen gewählten Metriktypen.
- Rohe Analysen exportieren — exportieren Sie Datensätze auf Scan-Ebene statt dieser aggregierten Aufschlüsselungen.
- Management-API-Übersicht — das Auth-Schema und die Quota-Architektur, zu der dieser Endpunkt gehört.
Autorisierungen
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.
Abfrageparameter
Verfügbare Optionen:
csv, xls, xlsx, pdf Body
application/json
Antwort
Binary file download — application/zip for csv, spreadsheet mimetype for xls/xlsx, application/pdf for pdf.
War diese Seite hilfreich?
⌘I