← Volver al índice de esquemas
BanxicoPublicTimeseriesResponse
Respuesta de `GET /v1/status/banxico/timeseries`. Puntos de datos agrupados por grupo de tiempo para la métrica y ventana solicitadas. Solo expone métricas seguras (`probe_latency`, `verdict`); valores de query inválidos caen silenciosamente a los defaults (`probe_latency`, `24h`).
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_public_timeseries`. |
id* | string | Identificador derivado del par métrica/ventana (`<metric>_<window>`). |
attributes* | object | Serie temporal de métricas de salud del servicio de verificación de Banxico, agrupada por intervalos de tiempo, tal como la devuelve `GET /v1/status/banxico/timeseries`. |
metric | string | Métrica reportada — `probe_latency`: Promedio de latencia de las pruebas (en milisegundos); `verdict`: Veredicto Banxico del grupo (codificado como número). |
window | string | Ventana de tiempo total cubierta por la serie (`1h`, `8h`, `12h`, `24h` o `7d`). |
unit | string | Unidad de los valores — `ms`: Milisegundos, cuando `metric` es `probe_latency`; `verdict`: Código categórico y no una magnitud, cuando `metric` es `verdict`. |
bucket_size_minutes | integer | Tamaño de cada intervalo en minutos — `1`: Para la ventana `1h`; `60`: Para las ventanas `8h`, `12h`, `24h` y `7d`. |
points | array | Puntos de datos ordenados cronológicamente. Cada punto contiene `ts`, la marca de tiempo de inicio del intervalo, y `value`, que es un número en milisegundos para `probe_latency` y un código de veredicto para `verdict`. |
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/timeseries