← Volver al índice de esquemas

`UsageSummary`

Snapshot del consumo de validaciones del usuario en el mes en curso. Devuelto por `GET /usage/summary`. `tone` mapea el porcentaje a un grupo visible (`ok`, `warn`, `danger`) que la UI usa para colorear el indicador.

Propiedades

Campo	Tipo	Descripción
`plan_slug`*	`string`	Plan vigente de la cuenta, el que fija el límite del periodo.
`plan_name`	`string`	Nombre legible del plan.
`limit`*	`integer`	Validaciones incluidas en el plan por mes calendario.
`used`*	`integer`	Validaciones consumidas en el mes en curso.
`remaining`*	`integer`	Validaciones restantes (`limit - used`, mínimo 0).
`used_percent`*	`number`	Porcentaje consumido (0-100, redondeado a 2 decimales).
`tone`*	`string`	`ok` (<70%), `warn` (70-89%), `danger` (≥90%), `none` (plan sin límite mensual).
`resets_at`*	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito. Ejemplo: `"2026-05-01T05:14:38Z"`. Cada campo `_at`, `_end`, `_start`, `_date` de la API usa esta forma. El descriptor compañero en `meta.datetime` permite afirmar el contrato en tiempo de ejecución sin volver a leer este spec. El `new Date(value)` nativo del navegador, el `datetime.fromisoformat` (≥3.11) de Python y el `time.Parse(time.RFC3339)` de Go parsean este formato directamente.
`next_reset_at`*	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito. Ejemplo: `"2026-05-01T05:14:38Z"`. Cada campo `_at`, `_end`, `_start`, `_date` de la API usa esta forma. El descriptor compañero en `meta.datetime` permite afirmar el contrato en tiempo de ejecución sin volver a leer este spec. El `new Date(value)` nativo del navegador, el `datetime.fromisoformat` (≥3.11) de Python y el `time.Parse(time.RFC3339)` de Go parsean este formato directamente.

Usado en operaciones

GET /v1/usage/summary