Referencia / Fuentes

Libros de oración

Lista las ediciones disponibles y consulta los oficios, recursos y preferencias propios de cada libro.

Estructura litúrgica

El catálogo identifica cada libro por código e informa idioma, jurisdicción, oficios disponibles y preferencias compatibles. El BCP 1662 en inglés, por ejemplo, expone sus variantes de leccionario como opciones del mismo libro.

GET/api/v1/prayer_books

Fragmento de la respuesta200 OK

{
  "data": [
    {
      "id": "loc_2015",
      "code": "loc_2015",
      "name": "IEAB - 2015",
      "full_name": "IEAB - 2015",
      "description": "LOC atual da IEAB, parte de uma nova geração de Livros de Oração",
      "language": "pt-BR",
      "jurisdiction": "Igreja Episcopal Anglicana do Brasil",
      "year": 2015,
      "thumbnail_url": "https://caminhoanglicano.com.br/locs/thumbs/loc-2015.png",
      "pdf_url": "https://caminhoanglicano.com.br/locs/pdfs/loc-2015.pdf",
      "supports_family_rite": true,
      "available_offices": ["morning", "midday", "evening", "compline"],
      "office_definitions": {
        "standard": [
          { "key": "morning", "name": "Matutino" }
        ],
        "family": [
          { "key": "morning", "name": "De Manhã" }
        ]
      },
      "is_recommended": true,
      "premium_required": false,
      "is_accessible": true
    }
  ]
}

Preferencias por libro

Las opciones no quedan fijas en el cliente. Consulta el catálogo de preferencias del libro para armar los controles y enviar solo valores que la API acepta.

GET/api/v1/prayer_books/:prayer_book_code/preferences

Ejemplo — BCP 1662

{
  "prayer_book_id": "loc_1662_en",
  "categories": [
    {
      "key": "daily_office",
      "preferences": [
        {
          "key": "lectionary_variant",
          "type": "select_one",
          "default_value": "original_1662",
          "options": [
            { "value": "original_1662", "is_default": true },
            { "value": "revised_1871", "is_default": false },
            { "value": "revised_1922", "is_default": false }
          ]
        }
      ]
    }
  ]
}

Nota: las tres tablas del BCP 1662 son variantes del mismo libro (loc_1662_en), no libros separados. La preferencia psalm_translation también aparece en ese catálogo, con las opciones bible_version y coverdale.

Descripción de los campos

Campo	Descripción
id / code	Identificador único del libro (ej: loc_2015).
jurisdiction	Entidad eclesiástica que lo autoriza (Iglesia, Diócesis o Provincia).
thumbnail_url	Enlace a la miniatura de la portada del libro.
image_url	Enlace a la imagen principal de la portada, cuando está disponible.
pdf_url	Enlace al archivo PDF oficial del libro de oración.
available_offices	Lista técnica de los oficios contenidos en el libro (morning, midday, evening, compline).
supports_family_rite	Indica si el libro ofrece las formas familiares del oficio.
office_definitions	Nombres amigables para cada oficio en los distintos modos de oración.
is_recommended	Indica si este es el libro por defecto sugerido para el idioma.
premium_required	Si es true, el acceso requiere una cuenta premium en la app Estêvão.
is_accessible	Indica si el libro está disponible para el nivel de acceso de la clave actual.
preferences	Catálogo devuelto por /prayer_books/:prayer_book_code/preferences, con tipo, valor por defecto y opciones de cada preferencia.