API REST pública

Datos del Calendario Litúrgico CEP-PR 2026

API JSON pública, sin autenticación, con CORS abierto. Ideal para apps católicas en Puerto Rico que necesiten datos litúrgicos oficiales.

Endpoints

GET /api/dia/{YYYY-MM-DD}

Día litúrgico completo (DiaLiturgicoCEP) para la fecha indicada.

Ejemplo: /api/dia/2026-07-13

GET /api/mes/{year}/{month}

Array de días del mes (1-12) con metadata mínima.

Ejemplo: /api/mes/2026/7

GET /api/buscar?q={query}

Búsqueda de texto sobre nombre, propio, lecturas y elogio. Mínimo 3 caracteres.

Ejemplo: /api/buscar?q=Carlos+Manuel

Rate limiting

100 requests por hora por dirección IP. Headers de respuesta:

X-RateLimit-Limit · capacidad por hora
X-RateLimit-Remaining · requests restantes
X-RateLimit-Reset · timestamp UNIX del reset
Retry-After · segundos hasta reintentar (solo en 429)

Caché

Cada respuesta incluye Cache-Control: public, s-maxage=86400, stale-while-revalidate=604800. Los datos del año litúrgico no cambian; podés cachear agresivamente del lado del cliente.

Atribución requerida

Cualquier consumidor de esta API debe acreditar la fuente:

Datos litúrgicos del Calendario Pastoral CEP-PR 2026, servidos por liturgia.mansus.ai (servicio donado por Mansus AI a la Iglesia Católica en Puerto Rico).

Esquema de datos

La forma exacta del objeto DiaLiturgicoCEP se documenta en el paquete @etbeducation/cep-clp-pr-2026 v1.0.0. Los campos principales son: fecha, celebracion (nombre, rango, color, tiempo, misa, oficio, elogio del Martirologio), lecturas (primera, salmo, segunda opcional, aclamación, evangelio), propio_cep_pr (cuando aplica), metadata_ingesta.

Contacto

Para reportar errores en los datos o sugerir mejoras: hola@mansus.ai.