Referência / Proveniência

Explicação litúrgica

Veja a precedência aplicada, as transferências e a origem de cada leitura devolvida para uma data.

Conferir a origem da resposta

A resposta reúne o contexto do dia, as celebrações candidatas, as transferências, a cor e a origem de cada leitura. Use este endpoint para mostrar qual regra e qual tabela produziram o resultado.

GET/api/v1/liturgical_explanation/:year/:month/:day

Exemplo de requisição

curl -G "https://api.caminhoanglicano.com.br/api/v1/liturgical_explanation/2026/03/25" \
  -H "X-API-Key: estevao_sua_chave" \
  --data-urlencode 'preferences={"prayer_book_code":"loc_1662_en","lectionary_variant":"revised_1922"}' \
  --data-urlencode 'locale=en-US' \
  --data-urlencode 'service_type=morning_prayer'

O que muda com o BCP 1662

Quando o livro de oração declara tabelas alternativas, a resposta inclui a variante usada no guia e em cada leitura. Assim, uma aplicação pode mostrar claramente se a seleção veio da tabela original de 1662, da revisão de 1871 ou da revisão opcional de 1922.

Trecho da resposta200 OK

{
  "data": {
    "date": "2026-03-25",
    "prayer_book_code": "loc_1662_en",
    "reading_guide": {
      "lectionary": {
        "code": "revised_1922",
        "label": "Optional revised 1922"
      }
    },
    "readings": [
      {
        "slot": "first_reading",
        "reference": "Isaiah 52:7-12",
        "service_type": "morning_prayer",
        "lectionary_variant": "revised_1922",
        "lectionary_variant_label": "Optional revised 1922"
      }
    ]
  },
  "meta": { "contract_version": 1 }
}

Parâmetros

Parâmetro	Valores	Descrição
preferences	JSON	Obrigatório; informe pelo menos prayer_book_code. Para o BCP 1662, use também lectionary_variant.
locale	en-US · es · pt-BR · pt-PT · cy	Idioma das mensagens e apresentações da explicação.
service_type	eucharist · morning_prayer · evening_prayer	Restringe a explicação ao serviço escolhido.