← Volver al índice de esquemas

`BanxicoPublicStatusResponse`

Respuesta de `GET /v1/status/banxico`. Vista pública reducida del estado del servicio Banxico CEP, sin detalles internos. Cacheada 60s (por `Cache-Control` en la respuesta) — pensada para health badges en dashboards de clientes.

Propiedades

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`	Tipo del recurso JSON:API. Siempre `banxico_status`.
`id`*	`string`	Identificador fijo `current` (la entrada del estado actual).
`attributes`*	`object`	Estado público del servicio Banxico CEP. Devuelto por `GET /v1/banxico/status` sin autenticación. Muestra el estado operativo actual y una explicación legible.
`status`*	`string`	Estado agregado del servicio: `operational` — todos los checks pasan y la latencia es normal; `degraded` — problemas parciales (latencia elevada, errores intermitentes); `down` — servicio inaccesible; `unknown` — aún no hay datos de health checks disponibles.
`status_label`*	`string`	Etiqueta legible del estado actual, resuelta al idioma del request.
`message`*	`string`	Explicación corta del estado actual del servicio, resuelta al idioma del request.
`last_verified_at`*	`TimestampUTC \| null`	Timestamp del último health check ejecutado. `null` si aún no se ha ejecutado ningún check.
`estimated_recovery_at`	`TimestampUTC \| null`	Tiempo estimado de recuperación del servicio. Solo se establece cuando el estado es `degraded` y se conoce una ventana de recuperación esperada. `null` en todos los demás estados.
`check_interval_seconds`	`integer`	Cadencia (en segundos) del health check automático completo — la fuente de verdad que la página de estado usa para mostrar "se actualiza cada X" y la cuenta regresiva al próximo chequeo. Se toma en vivo de la tarea programada editable `health-banxico-check`, así que un admin puede retunearla sin desplegar. Cae a 300 cuando la tarea no existe o usa un calendario cron.
`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.
`api_version`	`string`	Versión del prefijo de ruta de la API (ej. `v1`).
`request_id`	`string`	Identificador único de la petición (hex).
`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.
`timezone`*	`string`	Siempre `UTC` — la zona canónica para cada campo datetime del cuerpo.
`format`*	`string`	Siempre `ISO 8601` — sufijo `Z` explícito en cada datetime.
`links`	`object`	Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

Usado en operaciones

GET /v1/status/banxico