Abriendo el portal

Una API de Caminho Anglicano

Consultar estado
Preguntas / API

Preguntas frecuentes

Las preguntas que aparecen antes de la primera llamada, respondidas con lo que documenta este portal.

01

¿Qué es la API Estevão?

Es una API REST de Caminho Anglicano que reúne calendario litúrgico, lecturas, colectas, libros de oración y versiones bíblicas en un mismo conjunto de endpoints, con respuestas en JSON. Las relaciones entre esos datos se mantienen: un día apunta a su tiempo litúrgico, sus celebraciones, sus colectas y sus lecturas.

02

¿Cómo consulto el calendario litúrgico por una API?

Llama a los endpoints de calendario con una fecha. /calendar/today devuelve el día actual; /calendar/2026/03/25 devuelve un día concreto; /calendar/2026 devuelve el año. También hay vistas por tiempo litúrgico, celebraciones, fechas clave y resumen del año.

03

¿La API devuelve las lecturas del día y el leccionario?

Sí. La respuesta de un día trae las lecturas elegidas por el leccionario, junto con las colectas correspondientes. La explicación litúrgica registra qué variante de leccionario se usó y de dónde vino cada lectura.

04

¿Qué libros de oración están disponibles?

La referencia de libros de oración enumera las ediciones disponibles —entre ellas la LOC 2015 y el BCP 2019— con los oficios de cada una (maitines, mediodía, vísperas y completas) y las preferencias que acepta. El endpoint /prayer_books devuelve el catálogo actualizado.

05

¿Qué versiones de la Biblia ofrece la API?

El endpoint /bible_versions enumera las traducciones disponibles, cada una con su idioma, editorial y licencia. Son más de veinte versiones, y la versión elegida acompaña a las lecturas que devuelve el calendario.

06

¿Cómo autentico una llamada?

Envía tu clave en la cabecera X-API-Key. La clave se crea en el panel del portal y debe vivir en una variable de entorno del servidor, nunca en código que corre en el navegador. Los endpoints de calendario y explicación exigen preferences con al menos prayer_book_code.

07

¿Existe un servidor MCP?

Sí. El servidor alojado está en https://mcp.caminhoanglicano.com.br/mcp y conecta Claude, Codex, Gemini CLI, VS Code, Cursor y otros clientes del Model Context Protocol. En el servidor alojado el inicio de sesión ocurre en el navegador, sin pegar la clave.

08

¿La API es gratuita?

Los primeros siete días son de prueba. Después, el plan elegido define el límite de solicitudes de cada clave y el cobro se hace por Stripe, en reales o dólares. Los planes están en la página de precios.

09

¿Cuáles son los límites de solicitudes?

Cada clave está limitada por el plan de la cuenta, con un límite diario que se reinicia cada 24 horas y un límite por minuto contra picos. Al alcanzarlo, la respuesta es un 429 con la cabecera Retry-After.

10

¿En qué idiomas se puede usar la API?

El portal y la documentación están en portugués, inglés y español. En los datos, cada versión bíblica declara su propio idioma, y las preferencias de cada libro de oración definen la tradición que se sigue.

11

¿Puedo probarla antes de integrarla?

Sí. El playground ejecuta la llamada por un proxy del propio portal: eliges el endpoint y los parámetros y lees la respuesta completa, sin exponer tu clave en el navegador.

12

¿Qué aporta la explicación litúrgica?

Muestra el razonamiento detrás de la fecha: la precedencia entre celebraciones que compiten, los traslados cuando una fiesta se mueve y el origen de cada lectura. Es el endpoint que hace verificable la respuesta en lugar de solo afirmarla.

¿Sigues con dudas?

La documentación cubre cada endpoint en detalle, y el playground ejecuta la llamada antes de que la escribas en tu código.