← Volver al índice de esquemas

ApiUsage

Estadísticas de uso de la API y estado del servicio Banxico. Devuelto por `GET /v1/api/usage`.

Propiedades

Campo Tipo Descripción
requests_today integer Total de peticiones a la API en el día calendario actual (UTC).
requests_month integer Total de peticiones a la API en el mes calendario actual (UTC).
quota object Estado de la cuota de validaciones del plan activo.
plan_slug string Identificador del plan activo.
plan_name string Nombre legible del plan activo.
limit integer Validaciones incluidas en el plan por mes calendario.
used integer Validaciones consumidas en el mes en curso.
remaining integer Validaciones restantes en el mes en curso.
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.
recent_requests array Últimas peticiones a la API del usuario (orden cronológico inverso).
banxico_status string Estado actual del servicio Banxico CEP: `operational` — disponible y respondiendo con normalidad; `degraded` — disponible pero con errores parciales; `down` — completamente no disponible (todos los registros recientes son errores); `unknown` — sin datos recientes suficientes para determinar el estado.
usage_history array Historial de validaciones consumidas por mes calendario.

Usado en operaciones

  • GET /v1/api/usage