← 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 | Slug del plan activo. |
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