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"
}
Analysen & Tarife
Analytics-Bericht generieren
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"
}
Stellt einen asynchronen Job in die Warteschlange, der einen Scan-Daten- und/oder Analytics-Bericht über eine Reihe von QR-Codes, ein Tag oder einen Ordner hinweg erzeugt.
Der Aufruf gibt sofort
Erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota — siehe die Übersicht über die Management API — sowie die eigene EXPORT_ANALYTICS_REPORT-Quota und ANALYTICS_CAN_EXPORT_REPORT-Berechtigung des Kontos.string
erforderlich
Was
filter_data identifiziert: qrcode, tag oder folder.string
erforderlich
Ein JSON-kodierter String, der das/die Ziel(e) identifiziert — z. B. ein JSON-Array von
qrids, wenn filter_type qrcode ist.string
erforderlich
Startdatum (
YYYY-MM-DD).string
erforderlich
Enddatum (
YYYY-MM-DD).string
Standard:"both"
scan_data, analytics oder both.string
Standard:"csv"
Dateiformat für den Analytics-Teil:
csv, xls, xlsx, png, jpeg oder pdf.string
Standard:"csv"
Dateiformat für den Scan-Daten-Teil: dieselben Optionen wie
analytics_format.object
Optionale zusätzliche JSON-Filter-Payload, die über
filter_type/filter_data gelegt wird.boolean
Standard:"false"
Schließt als Bot-Traffic erkannte Scans aus dem Bericht aus.
boolean
Standard:"false"
Ob dieser Bericht als wiederverwendbare gespeicherte Voreinstellung beibehalten werden soll — siehe Gespeicherten Analytics-Bericht aktualisieren.
string
Ein Name für die gespeicherte Voreinstellung, erforderlich, wenn
is_saved true ist. Muss pro Konto eindeutig sein — ein Duplikat gibt 400 zurück.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 zurück, sobald der Job in die Warteschlange gestellt wurde, mit status: "new" — der Bericht selbst wird im Hintergrund erzeugt, und das Konto wird bei Abschluss per E-Mail benachrichtigt. Fragen Sie Analytics-Berichte auflisten für status und report_file ab.
Verwandte Themen
- Analytics-Berichte auflisten — den Job-Status abfragen.
- Gespeicherten Analytics-Bericht aktualisieren — eine gespeicherte Voreinstellung umbenennen oder verwalten.
- Übersicht über die Management API — das Authentifizierungsschema 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. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Antwort
201 - application/json
Report job queued.
War diese Seite hilfreich?