Obtener el mapa de calor de validaciones por día y hora

GEThttps://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 (grupos 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` p. ej. `30`

Petición

cURLPython•JavaScript•PHP•

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

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
`data`	`object`	Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con `type`, `id`, `attributes`).
`type`	`string`	Discriminador JSON:API. Siempre `usage_heatmap`. p. ej. `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). p. ej. `30`
`max_count`	`integer`	Valor máximo de `count` entre todas las celdas; útil para escalar la intensidad del color en la UI. p. ej. `48`
`buckets`	`array`	Lista de celdas del heatmap; cada entrada es una combinación (day_of_week, hour_of_day) con su conteo.
`meta`	`object`	Metadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC.
`version`	`string`	Versión de la API que procesó la petición. p. ej. `1.47.0`
`api_version`	`string`	Versión del prefijo de ruta de la API (ej. `v1`). p. ej. `v1`
`request_id`	`string`	Identificador único de la petición (hex). p. ej. `a1b2c3d4e5f6`
`datetime`	`object`	Descriptor compañero presente en el bloque `meta` de cada respuesta (y en el `meta` del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec. p. ej. `{"timezone":"UTC","format":"ISO 8601"}`
`timezone`*	`string`	Siempre `UTC` — la zona canónica para cada campo datetime del cuerpo. p. ej. `UTC`
`format`*	`string`	Siempre `ISO 8601` — sufijo `Z` explícito en cada datetime. p. ej. `ISO 8601`
`links`	`object`	Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

**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	Ejemplo
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b9`
403	`forbidden`	No tienes permiso para acceder a este recurso. Envelope meta.request_id `d5e6f7a8b9c0`