Abrindo o portal
Uma API do Caminho Anglicano
Consultar statusAs perguntas que aparecem antes da primeira chamada, respondidas com o que está documentado neste portal.
01
É uma API REST do Caminho Anglicano que reúne calendário litúrgico, leituras, coletas, livros de oração e versões bíblicas em um mesmo conjunto de endpoints, devolvendo JSON. As relações entre esses dados são preservadas: um dia aponta para seu tempo litúrgico, suas celebrações, suas coletas e suas leituras.
02
Chame os endpoints de calendário informando a data. /calendar/today devolve o dia corrente; /calendar/2026/03/25 devolve um dia específico; /calendar/2026 devolve o ano. Há ainda recortes por tempo litúrgico, celebrações, datas-chave e visão geral do ano.
03
Sim. A resposta de um dia traz as leituras selecionadas pelo lecionário, junto das coletas correspondentes. A explicação litúrgica registra qual variante de lecionário foi usada e de onde veio cada leitura.
04
A documentação de livros de oração lista as edições disponíveis — entre elas a LOC 2015 e o BCP 2019 — com os ofícios de cada uma (matinas, meio-dia, vésperas e completas) e as preferências aceitas. O endpoint /prayer_books devolve o catálogo atualizado.
05
O endpoint /bible_versions lista as traduções disponíveis, cada uma com idioma, editora e licença. São mais de vinte versões, e a escolha da versão acompanha as leituras devolvidas pelo calendário.
06
Envie a sua chave no cabeçalho X-API-Key. A chave é criada no painel do portal e deve ficar em uma variável de ambiente no servidor, nunca no código que roda no navegador. Os endpoints de calendário e explicação exigem preferences com pelo menos prayer_book_code.
07
Sim. O servidor hospedado fica em https://mcp.caminhoanglicano.com.br/mcp e conecta Claude, Codex, Gemini CLI, VS Code, Cursor e outros clientes compatíveis com o Model Context Protocol. No servidor hospedado o login acontece no navegador, sem colar a chave.
08
Os primeiros sete dias são de teste. Depois disso, o plano escolhido define o limite de requisições de cada chave e a cobrança acontece em reais ou dólares, pelo Stripe. Os planos estão na página de preços.
09
Cada chave é limitada pelo plano da conta, com um limite diário que reinicia a cada 24 horas e um limite por minuto contra picos. Quando o limite é atingido, a resposta é 429 com o cabeçalho Retry-After.
10
O portal e a documentação estão em português, inglês e espanhol. Nos dados, cada versão bíblica declara o próprio idioma, e as preferências de cada livro de oração definem a tradição seguida.
11
Sim. O playground executa a chamada por um proxy do próprio portal, escolhendo o endpoint e os parâmetros, e mostra a resposta completa sem expor a chave no navegador.
12
Ela mostra o raciocínio por trás da data: a precedência entre celebrações concorrentes, as transferências quando uma festa é deslocada e a origem de cada leitura. É o endpoint que torna a resposta conferível em vez de apenas afirmada.
A documentação cobre cada endpoint em detalhe, e o playground executa a chamada antes de você escrevê-la no código.