← Volver al índice de esquemas
UsageSummary
Cuota de validaciones de la cuenta para el ciclo de suscripción vigente.
Propiedades
| Campo | Tipo | Descripción |
|---|---|---|
plan_slug* | string | Identificador único y legible del plan. Corresponde al plan activo del usuario. |
plan_name | string | Nombre del plan que muestran las interfaces. |
limit* | integer | Límite efectivo de validaciones para el ciclo actual. |
used* | integer | Validaciones consumidas en el ciclo actual. |
remaining* | integer | Validaciones disponibles en el ciclo actual (`max(0, limit - used)`). |
used_percent* | number | Porcentaje del límite consumido en el ciclo actual, redondeado a 2 decimales. Puede pasar de 100 si hay excedente. |
tone* | string | Nivel de alerta según el consumo: `ok` (<70 %), `warn` (70–89 %), `danger` (≥90 % o cuota agotada). |
resets_at* | string (date-time) | Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo, `"2026-05-01T05:14:38Z"`. Los campos `*_at`, `*_end`, `*_start` y `*_date` adoptan esta forma. `meta.datetime` describe el mismo contrato en la respuesta. |
next_reset_at* | string (date-time) | Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo, `"2026-05-01T05:14:38Z"`. Los campos `*_at`, `*_end`, `*_start` y `*_date` adoptan esta forma. `meta.datetime` describe el mismo contrato en la respuesta. |
quota_kind | string | Origen de esta cuota: `cycle` (ciclo de suscripción de siempre) o `trial` (asignación de prueba inicial de una cuenta sin reclamar el plan). Aditivo. |
renews | boolean | `true` cuando esta cuota se repone al iniciar el siguiente ciclo. `false` para `quota_kind=trial`. |
Usado en operaciones
GET /v1/usage/summary