← Volver al índice de esquemas

`SpeiCalendarResponse`

Respuesta de `GET /v1/public/spei-calendar/{year}`. Un único recurso con los días inhábiles SPEI del año y su fuente, y en `meta.covered_years` los años que tienen calendario. Un año sin calendario responde `404`, no este cuerpo.

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 de recurso JSON:API. Siempre `spei_calendar`.
`id`*	`string`	Año del calendario (cuatro dígitos).
`attributes`*	`object`	Datos del calendario del año.
`year`*	`integer`	Año del calendario (cuatro dígitos). Mismo valor que `id`.
`non_business_days`*	`array`	Días inhábiles que caen de lunes a viernes (`YYYY-MM-DD`), de menor a mayor. Los sábados y los domingos también son inhábiles y no se repiten aquí.
`source`*	`object`	Disposición oficial de la que sale el calendario.
`issuer`*	`string`	Siglas de la autoridad que emite la disposición, por ejemplo `CNBV`.
`published_in`*	`string`	Siglas del medio oficial en el que se publicó la disposición, por ejemplo `DOF`.
`published_on`*	`string (date)`	Fecha de publicación de la disposición (`YYYY-MM-DD`).
`title`*	`string`	Título oficial de la disposición, en español.
`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/public/spei-calendar/{year}