Series temporales de validaciones del usuario

GET https://api.veriko.mx/v1/insights/trends

Audiencia: public
Autenticación: API key
Permiso: insights:read_self

Devuelve una serie temporal del usuario según el rango y la métrica seleccionados. El tamaño del bucket varía con el rango: 24h → por hora, 7d/30d → por día, 90d → por semana (inicio en lunes). La métrica volume desglosa direct vs OCR; latency devuelve percentiles p50, p95 y p99.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`metric`	query	`string`	opcional	Métrica a graficar: volumen de validaciones o latencia. Predeterminado: `volume`
`range`	query	`string`	opcional	Ventana temporal de la serie. Predeterminado: `7d`

Petición

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/insights/trends' \
  -H 'Authorization: Bearer mxcep_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200** `InsightsTrendsAttributes` — Buckets de la serie temporal para el rango y métrica solicitados.
Campo	Tipo	Descripción
`range`	`string`	Ventana de tiempo de la serie: `24h` (últimas 24 horas), `7d` (últimos 7 días), `30d` (últimos 30 días) o `90d` (últimos 90 días).
`metric`	`string`	Métrica representada: `volume` — conteos de validaciones apilados por tipo; `latency` — tiempos de procesamiento en percentiles.
`scope`	`string`	Alcance de los datos: `self` — solo validaciones del usuario; `global` — todas las validaciones de la plataforma (solo administradores).
`series`	`array`	Puntos de datos ordenados cronológicamente. La forma de cada punto depende de `metric`: para `volume` incluye `bucket`, `total`, `direct`, `ocr`, `valid`, `errored`; para `latency` incluye `bucket`, `p50`, `p95`, `p99`, `avg`.

**Códigos de respuesta** `GET /v1/insights/trends`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Buckets de la serie temporal para el rango y métrica solicitados.	Sin cuerpo
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`

**Errores de `GET /v1/insights/trends`**
Código	Clave	Detalle
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b9`
403	`forbidden`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c0`