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"
}
Analítica y planes
Generar un informe de analíticas
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"
}
Encola un trabajo asíncrono que genera un informe de datos de escaneo y/o analíticas que abarca un conjunto de códigos QR, una etiqueta o una carpeta.
La llamada devuelve
Requiere una clave de API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX) — consulte el resumen de la API de gestión — más la cuota EXPORT_ANALYTICS_REPORT y el permiso ANALYTICS_CAN_EXPORT_REPORT propios de la cuenta.string
requerido
Qué identifica
filter_data: qrcode, tag o folder.string
requerido
Una cadena codificada en JSON que identifica el/los objetivo(s) — p. ej. un array JSON de
qrids cuando filter_type es qrcode.string
requerido
Fecha de inicio (
YYYY-MM-DD).string
requerido
Fecha de fin (
YYYY-MM-DD).string
predeterminado:"both"
scan_data, analytics o both.string
predeterminado:"csv"
Formato de archivo para la parte de analíticas:
csv, xls, xlsx, png, jpeg o pdf.string
predeterminado:"csv"
Formato de archivo para la parte de datos de escaneo: las mismas opciones que
analytics_format.object
Payload JSON de filtro adicional opcional, superpuesto a
filter_type/filter_data.boolean
predeterminado:"false"
Excluye del informe los escaneos identificados como tráfico de bots.
boolean
predeterminado:"false"
Si se debe conservar este informe como una configuración predefinida reutilizable — consulte Actualizar un informe de analíticas guardado.
string
Un nombre para la configuración predefinida guardada, requerido si
is_saved es true. Debe ser único por cuenta — un duplicado devuelve 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 inmediatamente una vez que el trabajo está en cola, con status: "new" — el informe en sí se genera en segundo plano y la cuenta recibe un correo electrónico al completarse. Consulte Listar informes de analíticas para conocer status y report_file.
Relacionado
- Listar informes de analíticas — consultar el estado del trabajo.
- Actualizar un informe de analíticas guardado — renombrar o gestionar una configuración predefinida guardada.
- Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas a la que pertenece este endpoint.
Autorizaciones
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.
Respuesta
201 - application/json
Report job queued.
¿Esta página le ayudó?