Abriendo el portal

Una API de Caminho Anglicano

Consultar estado
Documentación / API v2

Endpoints de la v2

Todas las rutas son GET, responden JSON y exigen X-API-Key. Cada una se abre en el sandbox del playground con los parámetros del ejemplo ya cargados.

Días

GET/api/v2/days/{date}

Un día litúrgico

Tiempo, color, semana, nombre del domingo, ayuno y la celebración que prevaleció. Lecturas, colecta, celebraciones concurrentes y explicación entran por include.

ParámetroDóndeDescripción
dateobligatoriorutaFecha en formato AAAA-MM-DD, o today.
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.
includequeryLista separada por comas de los subrecursos a calcular. Un hijo implica al padre: readings.text ya trae readings. readingsreadings.textreadings.morningreadings.eveningreadings.alternativescollectcollect.textcelebrationsexplanation
servicequeryOficio cuyas lecturas se usan: daily (por defecto), eucharist, morning, evening o, en las lecturas, all para todos a la vez. dailyeucharistmorningevening
fields[day]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.
fields[reading]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.
fields[collect]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.
If-None-MatchencabezadoETag de una respuesta anterior. Si nada cambió, la API responde 304 sin cuerpo.

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/days/2026-03-25" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_2015" \
  --data-urlencode "include=readings,collect"
Probar en el sandbox
GET/api/v2/days

Varios días a la vez

El mismo recurso de /days/:date para un rango, con from y to o year. Ideal para armar un calendario mensual o anual en una llamada.

ParámetroDóndeDescripción
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.
fromqueryPrimera fecha del rango (AAAA-MM-DD).
toqueryÚltima fecha del rango, inclusive.
yearqueryAño civil completo, en lugar de from y to.
includequeryLista separada por comas de los subrecursos a calcular. Un hijo implica al padre: readings.text ya trae readings. readingsreadings.textreadings.morningreadings.eveningreadings.alternativescollectcollect.textcelebrationsexplanation
servicequeryOficio cuyas lecturas se usan: daily (por defecto), eucharist, morning, evening o, en las lecturas, all para todos a la vez. dailyeucharistmorningevening
fields[day]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.
fields[reading]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.
fields[collect]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/days" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_2015" \
  --data-urlencode "from=2026-03-01" \
  --data-urlencode "to=2026-03-31" \
  --data-urlencode "fields[day]=date,season,color,celebration"
Probar en el sandbox

Lecturas y textos

GET/api/v2/days/{date}/readings

Lecturas de un oficio

Las lecturas de una fecha como lista de slots. service=all devuelve todos los oficios a la vez, en services. Con include=text, el texto viene en la versión de bible y en el formato de text_format.

ParámetroDóndeDescripción
dateobligatoriorutaFecha en formato AAAA-MM-DD, o today.
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.
servicequeryOficio cuyas lecturas se usan: daily (por defecto), eucharist, morning, evening o, en las lecturas, all para todos a la vez. dailyeucharistmorningeveningall
includequeryLista separada por comas de los subrecursos a calcular. Un hijo implica al padre: readings.text ya trae readings. textalternatives
text_formatqueryFormato del texto bíblico: verses (por defecto, versículos estructurados), plain o markdown (una cadena en content). versesplainmarkdown
fields[reading]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/days/2026-03-25/readings" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_2015" \
  --data-urlencode "include=text" \
  --data-urlencode "text_format=plain"
Probar en el sandbox
GET/api/v2/collects/{date}

Colectas de una fecha

Las colectas del día sin el resto del calendario. Por defecto, solo título, tipo y referencia; include=text trae el cuerpo y el prefacio.

ParámetroDóndeDescripción
dateobligatoriorutaFecha en formato AAAA-MM-DD, o today.
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.
includequeryLista separada por comas de los subrecursos a calcular. Un hijo implica al padre: readings.text ya trae readings. text
fields[collect]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/collects/2026-03-25" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_2015" \
  --data-urlencode "include=text"
Probar en el sandbox
GET/api/v2/passages

Texto bíblico suelto

Cualquier pasaje, en cualquier versión disponible, sin depender del leccionario. No exige book.

ParámetroDóndeDescripción
refobligatorioqueryReferencia bíblica, como Juan 3:16-21.
bibleobligatorioqueryVersión bíblica de los textos, como nvi o kjv. Por defecto, la versión preferida del libro. Consulta GET /api/v2/bible-versions.
text_formatqueryFormato del texto bíblico: verses (por defecto, versículos estructurados), plain o markdown (una cadena en content). versesplainmarkdown
Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/passages" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "ref=João 3:16-21" \
  --data-urlencode "bible=nvi" \
  --data-urlencode "text_format=verses"
Probar en el sandbox
GET/api/v2/liturgical-explanations/{date}

Explicación litúrgica

Por qué el día se resolvió como se resolvió: precedencia, traslados, color, tiempo y la procedencia de cada lectura, para el oficio elegido en service.

ParámetroDóndeDescripción
dateobligatoriorutaFecha en formato AAAA-MM-DD, o today.
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.
servicequeryOficio cuyas lecturas se usan: daily (por defecto), eucharist, morning, evening o, en las lecturas, all para todos a la vez. dailyeucharistmorningevening

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/liturgical-explanations/2026-03-25" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_1662_en" \
  --data-urlencode "lectionary=revised_1922" \
  --data-urlencode "service=morning"
Probar en el sandbox

Año litúrgico

GET/api/v2/years/{year}

Visión general del año

Ciclo litúrgico, ciclos dominical y ferial, tiempos y fechas clave del año en una respuesta.

ParámetroDóndeDescripción
yearobligatoriorutaAño de cuatro dígitos.
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.
fields[annual_overview]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.
fields[season]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.
fields[key_date]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/years/2026" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_2015"
Probar en el sandbox
GET/api/v2/years/{year}/seasons

Tiempos del año

Los tiempos litúrgicos del año con sus fechas de inicio y fin.

ParámetroDóndeDescripción
yearobligatoriorutaAño de cuatro dígitos.
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.
fields[season]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/years/2026/seasons" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_2015"
Probar en el sandbox
GET/api/v2/years/{year}/key-dates

Fechas clave

Las fechas móviles de las que depende el año, como Miércoles de Ceniza, Pascua y Pentecostés.

ParámetroDóndeDescripción
yearobligatoriorutaAño de cuatro dígitos.
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.
fields[key_date]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/years/2026/key-dates" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_2015"
Probar en el sandbox
GET/api/v2/years/{year}/lectionary-cycle

Ciclo del leccionario

Los ciclos dominical y ferial del leccionario para el año.

ParámetroDóndeDescripción
yearobligatoriorutaAño de cuatro dígitos.
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.
fields[lectionary_cycle]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/years/2026/lectionary-cycle" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_2015"
Probar en el sandbox

Catálogos

GET/api/v2/celebrations

Buscar celebraciones

El catálogo de celebraciones del libro, con búsqueda por nombre y filtros por tipo, mes, día y movilidad. Con year, resuelve las fechas efectivas e incluye los domingos. Paginado por cursor.

ParámetroDóndeDescripción
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.
qqueryBúsqueda por nombre de la celebración.
typequeryTipo de celebración. sunday exige year, porque los domingos dependen del calendario del año. principal_feastmajor_holy_dayfestivallesser_feastcommemorationsunday
monthqueryMes (1 a 12).
dayqueryDía del mes. Exige month o year.
yearqueryResuelve las fechas efectivas con el calendario de ese año e incluye los domingos.
movablequerytrue para solo las móviles, false para solo las fijas. truefalse
limitqueryElementos por página, de 1 a 100. Por defecto: 50.
cursorqueryCursor opaco de links.next. Reutilízalo con los mismos filtros y el mismo book.
fields[celebration]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/celebrations" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_2015" \
  --data-urlencode "month=3" \
  --data-urlencode "limit=20"
Probar en el sandbox
GET/api/v2/celebrations/{id}

Una celebración

Los detalles de una celebración del libro. El id viene del listado de celebraciones.

ParámetroDóndeDescripción
idobligatoriorutaIdentificador numérico de la celebración, obtenido de GET /api/v2/celebrations.
bookobligatorioqueryCódigo del libro de oración, como loc_2015 o loc_1662_en. Obligatorio en todo recurso cuyo contenido depende del libro; la v2 no tiene libro por defecto. Consulta GET /api/v2/prayer-books.

También acepta los parámetros de contexto bible, psalter, lectionary, reading_type y lang.

Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/celebrations/{id}" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "book=loc_2015"
Probar en el sandboxReemplaza el tramo entre llaves por un valor real antes de ejecutar.
GET/api/v2/celebrations/types

Tipos de celebración

Los tipos aceptados por el filtro type, con el nombre en el idioma pedido.

ParámetroDóndeDescripción
langqueryIdioma de la respuesta, como pt-BR o en. Por defecto, el idioma del libro. En los catálogos, filtra por idioma.
fields[celebration_type]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.
Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/celebrations/types" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "lang=pt-BR"
Probar en el sandbox
GET/api/v2/prayer-books

Libros de oración

El catálogo de libros disponibles para claves de API, con idioma, jurisdicción, año y capacidades.

ParámetroDóndeDescripción
langqueryIdioma de la respuesta, como pt-BR o en. Por defecto, el idioma del libro. En los catálogos, filtra por idioma.
fields[prayer_book]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.
Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/prayer-books" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "fields[prayer_book]=code,name,language,year"
Probar en el sandbox
GET/api/v2/prayer-books/{code}

Un libro de oración

Los detalles de un libro, con las capacidades tipadas: variantes y tipos de lectura del leccionario y los oficios que tiene.

ParámetroDóndeDescripción
codeobligatoriorutaCódigo del libro de oración.
Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/prayer-books/loc_2015" \
  -H "X-API-Key: $ESTEVAO_API_KEY"
Probar en el sandbox
GET/api/v2/prayer-books/{code}/preferences

Preferencias de un libro

Las preferencias que acepta el libro, con opciones y valores por defecto. De aquí salen los valores válidos de bible, lectionary y reading_type.

ParámetroDóndeDescripción
codeobligatoriorutaCódigo del libro de oración.
Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/prayer-books/loc_2015/preferences" \
  -H "X-API-Key: $ESTEVAO_API_KEY"
Probar en el sandbox
GET/api/v2/bible-versions

Versiones de la Biblia

Las versiones bíblicas activas, con idioma, editorial y licencia. lang también acepta idiomas compatibles: en-CA encuentra las versiones en.

ParámetroDóndeDescripción
langqueryIdioma de la respuesta, como pt-BR o en. Por defecto, el idioma del libro. En los catálogos, filtra por idioma.
fields[bible_version]queryLista separada por comas de los atributos a devolver para ese tipo de recurso. Recorta la respuesta sin cambiar lo que se calcula.
Ejemplo
curl -G "https://api.caminhoanglicano.com.br/api/v2/bible-versions" \
  -H "X-API-Key: $ESTEVAO_API_KEY" \
  --data-urlencode "lang=pt"
Probar en el sandbox