Heatmap de validaciones por día y hora

GET https://api.veriko.mx/v1/usage/heatmap

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

Agrega las validaciones del usuario por día de la semana y hora del día para los últimos N días (máximo 90). Devuelve solo las combinaciones con al menos una validación (buckets sparsos); el cliente densifica en una grilla 7×24. day_of_week: 0 = domingo, 6 = sábado. hour_of_day: 0–23 hora del servidor.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`days`	query	`integer`	opcional	Número de días a incluir en el heatmap. Predeterminado: `30`

Petición

cURLPython•JavaScript•PHP•

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

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200** `GetUsageHeatmapResponse` — Buckets sparsos del heatmap con conteo por día×hora.
Campo	Tipo	Descripción
`type`	`string`	Discriminador JSON:API. Siempre `usage_heatmap`.
`attributes`	`object`	Densidad de uso por (día de la semana, hora del día) sobre la ventana consultada.
`days`	`integer`	Ventana del heatmap en días (típicamente 30 o 90).
`max_count`	`integer`	Valor máximo de `count` entre todas las celdas; útil para escalar la intensidad del color en la UI.
`buckets`	`array`	Lista de celdas del heatmap; cada entrada es una combinación (day_of_week, hour_of_day) con su conteo.

**Códigos de respuesta** `GET /v1/usage/heatmap`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Buckets sparsos del heatmap con conteo por día×hora.	`GetUsageHeatmapResponse`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`

**Errores de `GET /v1/usage/heatmap`**
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`