Estado del servicio Banxico (vista pública)

GET https://api.veriko.mx/v1/status/banxico

Audiencia: public
Autenticación: API key

Devuelve el estado operativo actual del servicio de verificación CEP de Banxico, derivado de chequeos periódicos de salud. Pensado para health badges en dashboards de clientes; oculta los detalles internos del monitoreo. La respuesta se cachea 60 s en cliente vía Cache-Control (configurable por deploy). Requiere autenticación por API key para identificar al llamador en logs y métricas, pero no exige un permiso específico — cualquier usuario autenticado puede consultarlo. Cuando el estado es degraded o down, las validaciones síncronas pueden devolver 503 banxico_rate_limit_exhausted; configura PUT /v1/validations/{id}/retry-policy para reintentar automáticamente al volver el servicio.

Petición

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/status/banxico' \
  -H 'Authorization: Bearer mxcep_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200** `BanxicoPublicStatusResponse` — Estado actual del servicio Banxico CEP.
Campo	Tipo	Descripción
`type` *	`string`	Tipo del recurso JSON:API.
`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` *	`union`	Timestamp del último health check ejecutado. `null` si aún no se ha ejecutado ningún check.
`estimated_recovery_at`	`union`	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.

**Códigos de respuesta** `GET /v1/status/banxico`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Estado actual del servicio Banxico CEP.	`BanxicoPublicStatusResponse`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`

**Cabeceras de respuesta** `200`
Cabecera	Tipo	Descripción
`Cache-Control`	`string`	TTL de caché para la vista pública (configurable; default 60 s).
`Vary`	`string`	Indicador de variación por Origin (CORS).

**Errores de `GET /v1/status/banxico`**
Código	Clave	Detalle
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b9`