Skip to main content
POST
Exporta registros de analíticas en bruto, por escaneo — una fila por evento de escaneo, en lugar de los desgloses agregados que devuelven Analíticas de QR y Exportar analíticas.
Este es un endpoint solo POST — una solicitud GET devuelve 405 Method Not Allowed. La especificación management-api.json lo indicaba anteriormente como GET; esto se ha corregido.
Requiere una clave de la API de gestión con cuota MANAGEMENT_API — consulta el resumen de la API de gestión — además de la cuota EXPORT_ANALYTICS_REPORT y el permiso ANALYTICS_CAN_EXPORT_RAW de la cuenta (distinto del permiso ANALYTICS_CAN_EXPORT que requiere la exportación agregada — un rol puede tener uno sin el otro). Un 403 con "Your plan does not have export analytics report quota." significa que el plan no incluye exportaciones.

​
Solicitud

Este endpoint siempre devuelve un archivo binario, no JSON.

​
Parámetros de consulta

​
string
requerido
Fecha de inicio (YYYY-MM-DD), inclusiva.
​
string
requerido
Fecha de fin (YYYY-MM-DD), inclusiva.
​
string
requerido
csv, xls o xlsx. A diferencia de Exportar analíticas, pdf no es un formato admitido aquí. Cualquier otro valor (u omitirlo) devuelve un 400 con "Invalid file format".
​
string
Pasa raw_bot para exportar solo los registros de escaneo identificados como bots en lugar de todos los escaneos. Cualquier otro valor se sobrescribe — este endpoint siempre exporta datos en bruto independientemente de lo que pases aquí.

​
Cuerpo de la solicitud

Misma forma que Analíticas de QR — q (obligatorio) y filter_by (predeterminado qrid) limitan qué escaneos en bruto de códigos QR incluir, y se aplica el mismo límite de volumen de cantidad de QR/rango de fechas.
​
array
requerido
Identificadores para limitar la exportación — el tipo depende de filter_by.
​
string
predeterminado:"qrid"
qrid, id, tags o folder.

​
Formatos de respuesta

Devuelve un único CSV (text/csv, analytics_raw.csv) de filas de escaneo en bruto.
Si la cuenta tiene habilitadas las analíticas de seguimiento de eventos y file_format no es csv, se añade automáticamente una segunda hoja/sección de registros en bruto de seguimiento de eventos (ID de sesión, marca de tiempo, ID/nombre del código QR, ID de seguimiento de eventos especificado por el usuario, hash de URL, URL). Solicitar csv siempre devuelve solo registros de escaneo — las filas de seguimiento de eventos se omiten específicamente para ese formato.

​
Relacionado

  • Analíticas de QR — el equivalente agregado en JSON de estos registros de escaneo en bruto.
  • Exportar analíticas — exporta desgloses de métricas agregadas en lugar de datos de escaneo a nivel de fila.
  • Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas de la que forma parte este endpoint.

Autorizaciones

​
Authorization
string
header
requerido

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.

Parámetros de consulta

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

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

Opciones disponibles:
raw_bot

Cuerpo

application/json
​
q
string[]
requerido
​
filter_by
enum<string>
predeterminado:qrid
Opciones disponibles:
qrid,
tags,
id,
folder

Respuesta

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