Para Desenvolvedores
API Católica — Ora et Labora
API REST aberta com a Bíblia Católica completa (73 livros), Regra de São Bento, Vida de São Bento (Diálogos de São Gregório), 721 Apoftegmas dos Padres do Deserto, Catecismo da Igreja Católica (2.865 parágrafos), 54 Orações Católicas, 7 Documentos da Igreja (663 parágrafos), Calendário Litúrgico, Busca Unificada, Liturgia Diária e Santo do Dia.
Base URL
https://oraetlabora.com.br/api- Formato de resposta: JSON
- Autenticação: opcional — header
x-api-keypara uso licenciado - Rate limit público: 60 req/min por IP (sem limite com API key)
- CORS: habilitado
- Método: GET apenas
Referência rápida — Todos os endpoints
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/biblia | Lista todos os 73 livros |
| GET | /api/biblia/:livro | Informações de um livro |
| GET | /api/biblia/:livro/:capitulo | Versículos de um capítulo |
| GET | /api/regra | Lista Prólogo e 73 capítulos |
| GET | /api/regra/:capitulo | Versículos de um capítulo |
| GET | /api/regra/busca?q=:termo | Busca na Regra |
| GET | /api/dialogos | Lista os 40 capítulos |
| GET | /api/dialogos/:capitulo | Parágrafos de um capítulo |
| GET | /api/apoftegmas | Lista os 92 autores |
| GET | /api/apoftegmas/:padre | Apoftegmas de um autor |
| GET | /api/catecismo | Estrutura das 4 partes |
| GET | /api/catecismo/p/:numero | Um parágrafo (§1–§2865) |
| GET | /api/oracoes | Lista todas as 54 orações |
| GET | /api/oracoes/:slug | Uma oração específica |
| GET | /api/documentos | Lista documentos da Igreja |
| GET | /api/documentos/:id | Metadados de um documento |
| GET | /api/documentos/:id/:capitulo | Capítulo de um documento |
| GET | /api/documentos/busca?q=:termo | Busca em documentos |
| GET | /api/calendario | Calendário litúrgico completo |
| GET | /api/calendario/hoje | Tempo litúrgico atual |
| GET | /api/calendario/:mes | Celebrações de um mês |
| GET | /api/busca?q=:termo | Busca unificada em todo o acervo |
| GET | /api/santo | Santo do dia |
| GET | /api/liturgia | Liturgia do dia |
Bíblia Católica
/api/bibliaLista todos os 73 livros da Bíblia Católica, separados por Antigo e Novo Testamento
Exemplo
https://oraetlabora.com.br/api/bibliaResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"total_livros": 73,
"antigo_testamento": [
{ "abbrev": "gn", "nome": "Gênesis", "capitulos": 50 },
{ "abbrev": "ex", "nome": "Êxodo", "capitulos": 40 },
{ "abbrev": "lv", "nome": "Levítico", "capitulos": 27 }
// ... 43 livros restantes
],
"novo_testamento": [
{ "abbrev": "mt", "nome": "Mateus", "capitulos": 28 },
{ "abbrev": "mc", "nome": "Marcos", "capitulos": 16 },
{ "abbrev": "lc", "nome": "Lucas", "capitulos": 24 }
// ... 24 livros restantes
]
}/api/biblia/:livroInformações de um livro específico
Parâmetros: livro — abreviação do livro (veja tabela completa abaixo)
Exemplo
https://oraetlabora.com.br/api/biblia/gnResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"abbrev": "gn",
"nome": "Gênesis",
"capitulos": 50
}/api/biblia/:livro/:capituloTodos os versículos de um capítulo específico
Parâmetros: livro — abreviação do livro · capitulo — número do capítulo
Exemplo
https://oraetlabora.com.br/api/biblia/gn/1Resposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"livro": "Gênesis",
"abbrev": "gn",
"capitulo": 1,
"versiculos": [
{ "numero": 1, "texto": "No princípio criou Deus o céu e a terra." },
{ "numero": 2, "texto": "A terra, porém, estava informe e vazia, e as trevas cobriam a face do abismo, e o Espírito de Deus movia-Se sobre as águas." },
{ "numero": 3, "texto": "E Deus disse: Exista a luz. E a luz existiu." }
// ... demais versículos
]
}Regra de São Bento
/api/regraLista o Prólogo (capítulo 0) e os 73 capítulos da Regra de São Bento
Exemplo
https://oraetlabora.com.br/api/regraResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"total": 74,
"capitulos": [
{ "numero": 0, "titulo": "Prólogo da Regra", "versiculos": 50 },
{ "numero": 1, "titulo": "Dos vários gêneros de monges", "versiculos": 13 },
{ "numero": 2, "titulo": "Das qualidades que deve ter o Abade", "versiculos": 40 }
// ... 71 capítulos restantes
]
}/api/regra/:capituloVersículos de um capítulo específico
Parâmetros: capitulo — número (0 = Prólogo, 1–73 = capítulos)
Exemplo
https://oraetlabora.com.br/api/regra/0Resposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"numero": 0,
"titulo": "Prólogo da Regra",
"versiculos": [
{ "numero": 1, "texto": "Escuta, filho, os preceitos do Mestre, e inclina o ouvido do teu coração; recebe de boa vontade e executa eficazmente o conselho de um bom pai," },
{ "numero": 2, "texto": "para que pelo trabalho da obediência tornes a Aquele de quem te afastaste pela inércia da desobediência." }
// ... 48 versículos restantes
]
}/api/regra/busca?q=:termoBusca por palavra-chave em todos os versículos da Regra
Parâmetros: q — termo de busca (mínimo 2 caracteres)
Exemplo
https://oraetlabora.com.br/api/regra/busca?q=humildadeResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"query": "humildade",
"total": 12,
"resultados": [
{
"capitulo": 7,
"titulo": "Da humildade",
"versiculo": 1,
"texto": "Clama-nos a divina Escritura, irmãos, dizendo: Todo aquele que se exalta será humilhado, e quem se humilha será exaltado."
}
// ... 11 resultados restantes
]
}Vida de São Bento (Diálogos)
Segundo Livro dos Diálogos de São Gregório Magno — a principal fonte histórica sobre a vida de São Bento.
/api/dialogosLista o Prefácio (−1), Prólogo (0) e os 38 capítulos
Exemplo
https://oraetlabora.com.br/api/dialogosResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"total": 40,
"capitulos": [
{ "numero": -1, "titulo": "Prefácio de São Gregório Magno aos Quatro Livros dos Diálogos", "paragrafos": 5 },
{ "numero": 0, "titulo": "Prólogo", "paragrafos": 3 },
{ "numero": 1, "titulo": "A infância e a juventude de Bento", "paragrafos": 12 }
// ... 37 capítulos restantes
]
}/api/dialogos/:capituloParágrafos de um capítulo, com campo interlocutor (Gregório, Pedro ou null para narrador)
Parâmetros: capitulo — número (−1 = Prefácio, 0 = Prólogo, 1–38 = capítulos)
Exemplo
https://oraetlabora.com.br/api/dialogos/1Resposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"numero": 1,
"titulo": "A infância e a juventude de Bento",
"paragrafos": [
{
"numero": 1,
"interlocutor": "Gregório",
"texto": "Houve um homem de vida venerável, abençoado pela graça e pelo nome..."
},
{
"numero": 2,
"interlocutor": null,
"texto": "Nascido de família nobre na região de Núrsia..."
}
// ... demais parágrafos
]
}Apoftegmas dos Padres do Deserto
/api/apoftegmasLista todos os 92 autores e a contagem total de apoftegmas
Exemplo
https://oraetlabora.com.br/api/apoftegmasResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"total_autores": 92,
"total_apoftegmas": 721,
"autores": [
{ "id": "antao", "nome": "Antão", "apoftegmas": 38 },
{ "id": "arsenio", "nome": "Arsênio", "apoftegmas": 44 },
{ "id": "agaton", "nome": "Ágaton", "apoftegmas": 33 }
// ... 89 autores restantes
]
}/api/apoftegmas/:padreTodos os apoftegmas de um autor específico
Parâmetros: padre — ID do autor (ex: antao, arsenio, agaton, macario, moisés)
Exemplo
https://oraetlabora.com.br/api/apoftegmas/antaoResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"id": "antao",
"nome": "Antão",
"total": 38,
"apoftegmas": [
{
"numero": 1,
"texto": "O santo Abade Antão, certa vez sentado no deserto, foi acometido de acedia e grande turbilhão de pensamentos; disse então a Deus: \"Senhor, quero ser salvo, e não me deixam os pensamentos; que farei na minha tribulação? Como serei salvo?\"..."
}
// ... 37 apoftegmas restantes
]
}Catecismo da Igreja Católica
/api/catecismoEstrutura completa: 4 Partes com suas Seções e intervalos de parágrafos
Exemplo
https://oraetlabora.com.br/api/catecismoResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"total_partes": 4,
"partes": [
{
"numero": 1,
"titulo": "A Profissão da Fé",
"paragrafos_range": [1, 1065],
"secoes": [
{ "numero": 1, "titulo": "«Eu creio» – «Nós cremos»", "paragrafos_range": [1, 184] },
{ "numero": 2, "titulo": "A profissão da fé cristã", "paragrafos_range": [185, 1065] }
]
},
{
"numero": 2,
"titulo": "A Celebração do Mistério Cristão",
"paragrafos_range": [1066, 1690],
"secoes": [
{ "numero": 1, "titulo": "A economia sacramental", "paragrafos_range": [1066, 1209] },
{ "numero": 2, "titulo": "Os sete sacramentos da Igreja", "paragrafos_range": [1210, 1690] }
]
}
// ... partes 3 e 4
]
}/api/catecismo/p/:numeroUm parágrafo específico pelo seu número (§1 a §2865)
Parâmetros: numero — número do parágrafo
Exemplo
https://oraetlabora.com.br/api/catecismo/p/1324Resposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"numero": 1324,
"texto": "A Eucaristia é «fonte e cume de toda a vida cristã». «Os demais sacramentos, assim como todos os ministérios eclesiásticos e obras de apostolado, se vinculam à sagrada Eucaristia e a ela se ordenam. Pois a santíssima Eucaristia contém todo o bem espiritual da Igreja, a saber, o próprio Cristo, nossa Páscoa».",
"localizacao": {
"parte": { "numero": 2, "titulo": "A Celebração do Mistério Cristão" },
"secao": { "numero": 2, "titulo": "Os sete sacramentos da Igreja" }
}
}Orações Católicas
54 orações em 8 categorias: beneditinas, comuns, eucarísticas, marianas, santos-anjos, momentos-dia, intencoes, novenas.
/api/oracoesLista todas as 54 orações com suas categorias. Aceita filtro por categoria.
Parâmetros: categoria (opcional) — ID da categoria (ex: beneditinas, marianas, comuns)
Exemplo
https://oraetlabora.com.br/api/oracoesResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"total": 54,
"categorias": [
{ "id": "beneditinas", "nome": "Orações Beneditinas" },
{ "id": "comuns", "nome": "Orações Comuns" },
{ "id": "eucaristicas", "nome": "Orações Eucarísticas" },
{ "id": "marianas", "nome": "Orações Marianas" },
{ "id": "santos-anjos", "nome": "Santos e Anjos" },
{ "id": "momentos-dia", "nome": "Momentos do Dia" },
{ "id": "intencoes", "nome": "Orações por Intenções" },
{ "id": "novenas", "nome": "Novenas" }
],
"oracoes": [
{ "id": "pai-nosso", "titulo": "Pai-Nosso", "categorias": ["comuns"] },
{ "id": "ave-maria", "titulo": "Ave-Maria", "categorias": ["comuns", "marianas"] }
// ... 52 orações restantes
]
}/api/oracoes/:slugUma oração específica com texto completo, versão latina e contexto histórico
Parâmetros: slug — ID da oração (ex: pai-nosso, ave-maria, salve-rainha)
Exemplo
https://oraetlabora.com.br/api/oracoes/pai-nossoResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"id": "pai-nosso",
"titulo": "Pai-Nosso",
"categorias": ["comuns"],
"texto": "Pai nosso, que estais nos céus, santificado seja o Vosso nome. Venha a nós o Vosso Reino. Seja feita a Vossa vontade, assim na terra como no céu. O pão nosso de cada dia nos dai hoje. Perdoai-nos as nossas ofensas...",
"latina": "Pater noster, qui es in caelis, sanctificetur nomen tuum...",
"contexto": "A oração do Pai-Nosso foi ensinada pelo próprio Jesus Cristo aos seus discípulos...",
"tags": ["jesus", "oração-dominical", "evangelho"]
}Documentos da Igreja
7 documentos magisteriais completos: as 4 constituições do Concílio Vaticano II, 1 instrução e 2 documentos papais pós-concílio. Total de 663 parágrafos em 57 capítulos.
/api/documentosLista todos os 7 documentos disponíveis com metadados completos (título, subtítulo, tipo, autoridade, data, contagem de capítulos e parágrafos)
Exemplo
https://oraetlabora.com.br/api/documentosResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"total": 7,
"documentos": [
{
"id": "sacrosanctum-concilium",
"titulo": "Sacrosanctum Concilium",
"subtitulo": "Constituição sobre a Sagrada Liturgia",
"tipo": "Constituição",
"autoridade": "Concílio Vaticano II",
"data": "1963",
"descricao": "Primeira constituição promulgada pelo Concílio Vaticano II...",
"totalCapitulos": 8,
"totalParagrafos": 130
},
{
"id": "lumen-gentium",
"titulo": "Lumen Gentium",
"subtitulo": "Constituição Dogmática sobre a Igreja",
"tipo": "Constituição Dogmática",
"autoridade": "Concílio Vaticano II",
"data": "1964",
"totalCapitulos": 8,
"totalParagrafos": 69
},
{
"id": "dei-verbum",
"titulo": "Dei Verbum",
"subtitulo": "Constituição Dogmática sobre a Revelação Divina",
"tipo": "Constituição Dogmática",
"autoridade": "Concílio Vaticano II",
"data": "1965",
"totalCapitulos": 7,
"totalParagrafos": 26
},
{
"id": "gaudium-et-spes",
"titulo": "Gaudium et Spes",
"subtitulo": "Constituição Pastoral sobre a Igreja no Mundo Atual",
"tipo": "Constituição Pastoral",
"autoridade": "Concílio Vaticano II",
"data": "1965",
"totalCapitulos": 12,
"totalParagrafos": 93
},
{
"id": "redemptionis-sacramentum",
"titulo": "Redemptionis Sacramentum",
"subtitulo": "Instrução sobre a Eucaristia",
"tipo": "Instrução",
"autoridade": "Congregação para o Culto Divino",
"data": "2004",
"totalCapitulos": 9,
"totalParagrafos": 186
},
{
"id": "ecclesia-de-eucharistia",
"titulo": "Ecclesia de Eucharistia",
"subtitulo": "Encíclica sobre a Eucaristia",
"tipo": "Encíclica",
"autoridade": "João Paulo II",
"data": "2003",
"totalCapitulos": 8,
"totalParagrafos": 62
},
{
"id": "sacramentum-caritatis",
"titulo": "Sacramentum Caritatis",
"subtitulo": "Exortação Apostólica sobre a Eucaristia",
"tipo": "Exortação Apostólica",
"autoridade": "Bento XVI",
"data": "2007",
"totalCapitulos": 5,
"totalParagrafos": 97
}
]
}/api/documentos/:idMetadados de um documento específico com lista completa de capítulos e contagem de parágrafos por capítulo
Parâmetros: id — slug do documento (veja tabela completa abaixo)
Exemplo
https://oraetlabora.com.br/api/documentos/sacrosanctum-conciliumResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"id": "sacrosanctum-concilium",
"titulo": "Sacrosanctum Concilium",
"subtitulo": "Constituição sobre a Sagrada Liturgia",
"tipo": "Constituição",
"autoridade": "Concílio Vaticano II",
"data": "1963",
"capitulos": [
{ "numero": 0, "titulo": "Proemio", "paragrafos": 4 },
{ "numero": 1, "titulo": "Princípios Gerais para a Reforma e Incremento da Sagrada Liturgia", "paragrafos": 42 },
{ "numero": 2, "titulo": "O Sacrossanto Mistério da Eucaristia", "paragrafos": 12 },
{ "numero": 3, "titulo": "Os Outros Sacramentos e os Sacramentais", "paragrafos": 24 },
{ "numero": 4, "titulo": "O Ofício Divino", "paragrafos": 19 },
{ "numero": 5, "titulo": "O Ano Litúrgico", "paragrafos": 10 },
{ "numero": 6, "titulo": "A Música Sacra", "paragrafos": 10 },
{ "numero": 7, "titulo": "A Arte Sacra e as Alfaias Litúrgicas", "paragrafos": 9 }
]
}/api/documentos/:id/:capituloTexto completo de um capítulo específico de um documento, com todos os parágrafos numerados
Parâmetros: id — slug do documento · capitulo — número do capítulo (0 = Proemio/Introdução)
Exemplo
https://oraetlabora.com.br/api/documentos/dei-verbum/1Resposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"documento": "Dei Verbum",
"capitulo": {
"numero": 1,
"titulo": "A Revelação em Si Mesma",
"paragrafos": [
{ "numero": 2, "texto": "Aprouve a Deus, na sua bondade e sabedoria, revelar-Se a Si mesmo e dar a conhecer o mistério da Sua vontade..." },
{ "numero": 3, "texto": "Deus, criando e conservando todas as coisas pelo Verbo, oferece aos homens um testemunho perene de Si nas coisas criadas..." },
{ "numero": 4, "texto": "Depois de ter falado muitas vezes e de muitas maneiras pelos profetas, Deus falou-nos nestes últimos dias pelo Filho..." },
{ "numero": 5, "texto": "A Deus que Se revela deve-se a obediência da fé..." },
{ "numero": 6, "texto": "Pela revelação divina quis Deus manifestar-Se e comunicar-Se a Si mesmo..." }
]
}
}/api/documentos/busca?q=:termoBusca por palavra-chave em todos os 7 documentos, retornando até 50 resultados com trecho do texto
Parâmetros: q — termo de busca (mínimo 2 caracteres, máximo 200)
Exemplo
https://oraetlabora.com.br/api/documentos/busca?q=eucaristiaResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"query": "eucaristia",
"total": 15,
"resultados": [
{
"documento": "sacrosanctum-concilium",
"tituloDocumento": "Sacrosanctum Concilium",
"capitulo": 2,
"tituloCapitulo": "O Sacrossanto Mistério da Eucaristia",
"paragrafo": 47,
"texto": "Nosso Salvador, na última Ceia, na noite em que foi entregue, instituiu o Sacrifício eucarístico do seu Corpo e Sangue..."
},
{
"documento": "ecclesia-de-eucharistia",
"tituloDocumento": "Ecclesia de Eucharistia",
"capitulo": 0,
"tituloCapitulo": "Introdução",
"paragrafo": 1,
"texto": "A Igreja vive da Eucaristia. Esta verdade não exprime apenas uma experiência quotidiana de fé..."
}
// ... demais resultados
]
}Calendário Litúrgico
Calendário litúrgico do ano 2025-2026 com tempos, solenidades, festas e memórias.
/api/calendarioRetorna o ano litúrgico completo com todos os tempos e celebrações
Exemplo
https://oraetlabora.com.br/api/calendarioResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"ano_liturgico": "2025-2026",
"ciclo_dominical": "B",
"ciclo_ferial": "II",
"tempos": [
{ "id": "advento", "nome": "Advento", "cor": "Roxo", "inicio": "2025-11-30", "fim": "2025-12-24" }
// ... demais tempos
],
"total_celebracoes": 150,
"celebracoes": [
{ "data": "2025-12-25", "nome": "Natal do Senhor", "tipo": "solenidade", "cor": "Branco", "tempo": "natal" }
// ...
]
}/api/calendario/hojeRetorna o tempo litúrgico atual e se há celebração hoje
Parâmetros: data (opcional) — data no formato YYYY-MM-DD
Exemplo
https://oraetlabora.com.br/api/calendario/hojeResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"data": "2026-03-18",
"tempo_liturgico": "Quaresma",
"cor_liturgica": "Roxo",
"celebracao": null,
"proximo_evento": {
"data": "2026-03-19",
"nome": "São José, Esposo de Nossa Senhora",
"tipo": "solenidade"
}
}/api/calendario/:mesTodas as celebrações de um mês específico
Parâmetros: mes — número do mês (1–12)
Exemplo
https://oraetlabora.com.br/api/calendario/12Resposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"mes": 12,
"nome": "Dezembro",
"total": 12,
"celebracoes": [
{ "data": "2025-12-08", "nome": "Imaculada Conceição de Nossa Senhora", "tipo": "solenidade", "cor": "Branco", "tempo": "advento" },
{ "data": "2025-12-25", "nome": "Natal do Senhor", "tipo": "solenidade", "cor": "Branco", "tempo": "natal" }
// ...
]
}Busca Unificada
/api/busca?q=:termoBusca por palavra-chave em todo o acervo: Bíblia, Catecismo, Regra, Orações e Documentos. Retorna até 10 resultados por fonte.
Parâmetros: q — termo de busca (mínimo 2 caracteres, máximo 200)
Exemplo
https://oraetlabora.com.br/api/busca?q=eucaristiaResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"query": "eucaristia",
"total": 25,
"resultados": {
"biblia": [
{ "livro": "1 Coríntios", "abbrev": "1cor", "capitulo": 11, "versiculo": 24, "texto": "..." }
],
"catecismo": [
{ "numero": 1324, "texto": "A Eucaristia é fonte e cume..." }
],
"regra": [],
"oracoes": [
{ "id": "oracao-antes-comunhao", "titulo": "Oração antes da Comunhão" }
],
"documentos": [
{ "documento": "sacrosanctum-concilium", "tituloDocumento": "Sacrosanctum Concilium", "capitulo": 2, "tituloCapitulo": "O Sacrossanto Mistério da Eucaristia", "paragrafo": 47, "texto": "..." }
]
}
}Santo do Dia
Dados obtidos em tempo real da Canção Nova. Atualiza a cada hora. Estes endpoints utilizam fonte externa e podem apresentar indisponibilidade eventual. Recomendados para uso informativo, não para integração em produção.
/api/santoRetorna o santo celebrado no dia atual
Exemplo
https://oraetlabora.com.br/api/santoResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"data": "14/03/2026",
"nome": "Santa Matilde",
"texto": "Santa Matilde, rainha da Alemanha, esposa do rei Henrique I..."
}Liturgia Diária
Dados obtidos em tempo real da Canção Nova (leituras, salmo e evangelho do dia). Atualiza a cada hora. Estes endpoints utilizam fonte externa e podem apresentar indisponibilidade eventual. Recomendados para uso informativo, não para integração em produção.
/api/liturgiaLiturgia do dia: leituras, salmo responsorial e evangelho com cor e tempo litúrgico
Exemplo
https://oraetlabora.com.br/api/liturgiaResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"data": "14 de Mar de 2026",
"diaSemana": "Sábado",
"tempoLiturgico": "3ª Semana da Quaresma",
"corLiturgica": "Roxo",
"leituras": [
{
"tipo": "1ª Leitura",
"referencia": "Os 6,1-6",
"texto": "Vinde, voltemos ao Senhor, pois ele nos despedaçou, mas nos curará..."
},
{
"tipo": "Salmo",
"referencia": "Sl 50(51)",
"texto": "R: Eu quero o amor, e não sacrifícios..."
},
{
"tipo": "Evangelho",
"referencia": "Lc 18,9-14",
"texto": "Jesus contou esta parábola para alguns que confiavam em sua própria justiça..."
}
]
}Formato de erro
Quando um recurso não é encontrado ou um parâmetro é inválido, a API retorna um JSON com o campo erro:
// 404 — Recurso não encontrado
{
"erro": "Livro não encontrado.",
"fonte": "Ora et Labora — oraetlabora.com.br"
}
// 400 — Parâmetro inválido
{
"erro": "Número de capítulo inválido.",
"fonte": "Ora et Labora — oraetlabora.com.br"
}Abreviações dos 73 livros da Bíblia
Use estas abreviações (em minúsculas) nos endpoints da Bíblia. Exemplo: /api/biblia/gn/1 para Gênesis capítulo 1.
Antigo Testamento (46 livros)
| Abrev. | Livro | Cap. |
|---|---|---|
gn | Gênesis | 50 |
ex | Êxodo | 40 |
lv | Levítico | 27 |
nm | Números | 36 |
dt | Deuteronômio | 34 |
js | Josué | 24 |
jz | Juízes | 21 |
rt | Rute | 4 |
1sm | 1 Samuel | 31 |
2sm | 2 Samuel | 24 |
1re | 1 Reis | 22 |
2re | 2 Reis | 25 |
1cr | 1 Crônicas | 29 |
2cr | 2 Crônicas | 36 |
esd | Esdras | 10 |
ne | Neemias | 13 |
tb | Tobias | 14 |
jdt | Judite | 16 |
est | Ester | 16 |
job | Jó | 42 |
sl | Salmos | 150 |
pv | Provérbios | 31 |
ec | Eclesiastes | 12 |
ct | Cântico dos Cânticos | 8 |
sb | Sabedoria | 19 |
eclo | Eclesiástico | 51 |
is | Isaías | 66 |
jr | Jeremias | 52 |
lm | Lamentações | 5 |
br | Baruc | 6 |
ez | Ezequiel | 48 |
dn | Daniel | 14 |
os | Oséias | 14 |
jl | Joel | 3 |
am | Amós | 9 |
abd | Abdias | 1 |
jon | Jonas | 4 |
mq | Miqueias | 7 |
na | Naum | 3 |
hab | Habacuc | 3 |
sof | Sofonias | 3 |
ag | Ageu | 2 |
zc | Zacarias | 14 |
ml | Malaquias | 4 |
1mc | 1 Macabeus | 16 |
2mc | 2 Macabeus | 15 |
Novo Testamento (27 livros)
| Abrev. | Livro | Cap. |
|---|---|---|
mt | Mateus | 28 |
mc | Marcos | 16 |
lc | Lucas | 24 |
jo | João | 21 |
at | Atos dos Apóstolos | 28 |
rm | Romanos | 16 |
1cor | 1 Coríntios | 16 |
2cor | 2 Coríntios | 13 |
gl | Gálatas | 6 |
ef | Efésios | 6 |
fl | Filipenses | 4 |
cl | Colossenses | 4 |
1ts | 1 Tessalonicenses | 5 |
2ts | 2 Tessalonicenses | 3 |
1tm | 1 Timóteo | 6 |
2tm | 2 Timóteo | 4 |
tt | Tito | 3 |
fm | Filemon | 1 |
hb | Hebreus | 13 |
tg | Tiago | 5 |
1pd | 1 Pedro | 5 |
2pd | 2 Pedro | 3 |
1jo | 1 João | 5 |
2jo | 2 João | 1 |
3jo | 3 João | 1 |
jd | Judas | 1 |
ap | Apocalipse | 22 |
Slugs dos 7 Documentos da Igreja
Use estes slugs nos endpoints de Documentos. Exemplo: /api/documentos/dei-verbum para a Constituição Dogmática sobre a Revelação Divina, ou /api/documentos/dei-verbum/1 para o capítulo 1.
| Slug (ID) | Documento | Tipo | Autoridade | Cap. | Par. |
|---|---|---|---|---|---|
sacrosanctum-concilium | Sacrosanctum Concilium | Constituição | Concílio Vaticano II (1963) | 8 | 130 |
lumen-gentium | Lumen Gentium | Const. Dogmática | Concílio Vaticano II (1964) | 8 | 69 |
dei-verbum | Dei Verbum | Const. Dogmática | Concílio Vaticano II (1965) | 7 | 26 |
gaudium-et-spes | Gaudium et Spes | Const. Pastoral | Concílio Vaticano II (1965) | 12 | 93 |
redemptionis-sacramentum | Redemptionis Sacramentum | Instrução | Congr. Culto Divino (2004) | 9 | 186 |
ecclesia-de-eucharistia | Ecclesia de Eucharistia | Encíclica | João Paulo II (2003) | 8 | 62 |
sacramentum-caritatis | Sacramentum Caritatis | Exortação Apostólica | Bento XVI (2007) | 5 | 97 |
| Total | 57 | 663 | |||
Exemplos de uso
JavaScript / fetch
// Buscar os versículos de Gênesis capítulo 1
fetch("https://oraetlabora.com.br/api/biblia/gn/1")
.then(res => res.json())
.then(data => {
console.log(data.livro, "—", "Capítulo", data.capitulo);
data.versiculos.forEach(v => {
console.log(`v.${v.numero}: ${v.texto}`);
});
});
// Buscar uma oração específica
fetch("https://oraetlabora.com.br/api/oracoes/pai-nosso")
.then(res => res.json())
.then(data => console.log(data.titulo, "\n", data.texto));Python
import requests
# Buscar um parágrafo do Catecismo
r = requests.get("https://oraetlabora.com.br/api/catecismo/p/1324")
data = r.json()
print(f"§{data['numero']}: {data['texto']}")
# Buscar a liturgia do dia
r = requests.get("https://oraetlabora.com.br/api/liturgia")
liturgia = r.json()
print(f"{liturgia['tempoLiturgico']} — {liturgia['corLiturgica']}")
for leitura in liturgia['leituras']:
print(f"\n{leitura['tipo']} ({leitura['referencia']})")
print(leitura['texto'][:200])cURL
# Versículos de Gênesis 1 curl https://oraetlabora.com.br/api/biblia/gn/1 # Buscar na Regra de São Bento curl "https://oraetlabora.com.br/api/regra/busca?q=humildade" # Liturgia do dia curl https://oraetlabora.com.br/api/liturgia # Oração específica curl https://oraetlabora.com.br/api/oracoes/ave-maria
PHP
<?php
// Buscar o santo do dia
$response = file_get_contents("https://oraetlabora.com.br/api/santo");
$data = json_decode($response, true);
echo $data['nome'] . "\n";
echo $data['texto'];
// Buscar um capítulo dos Diálogos
$response = file_get_contents("https://oraetlabora.com.br/api/dialogos/1");
$data = json_decode($response, true);
echo $data['titulo'] . "\n";
foreach ($data['paragrafos'] as $p) {
$speaker = $p['interlocutor'] ?? 'Narrador';
echo "[$speaker] " . $p['texto'] . "\n";
}Tipos TypeScript
Tipos para consumir a API com TypeScript. Copie e cole no seu projeto.
Tipos das respostas
/** Base de todas as respostas */
interface OraEtLaboraResponse {
fonte: string;
}
/** GET /api/biblia */
interface BibliaListResponse extends OraEtLaboraResponse {
total_livros: number;
antigo_testamento: BibliaLivro[];
novo_testamento: BibliaLivro[];
}
interface BibliaLivro {
abbrev: string;
nome: string;
capitulos: number;
}
/** GET /api/biblia/:livro/:capitulo */
interface BibliaCapituloResponse extends OraEtLaboraResponse {
livro: string;
abbrev: string;
capitulo: number;
versiculos: { numero: number; texto: string }[];
}
/** GET /api/regra */
interface RegraListResponse extends OraEtLaboraResponse {
total: number;
capitulos: { numero: number; titulo: string; versiculos: number }[];
}
/** GET /api/regra/:capitulo */
interface RegraCapituloResponse extends OraEtLaboraResponse {
numero: number;
titulo: string;
versiculos: { numero: number; texto: string }[];
}
/** GET /api/dialogos/:capitulo */
interface DialogosCapituloResponse extends OraEtLaboraResponse {
numero: number;
titulo: string;
paragrafos: {
numero: number;
interlocutor: "Gregório" | "Pedro" | null;
texto: string;
}[];
}
/** GET /api/catecismo/p/:numero */
interface CatecismoParagrafoResponse extends OraEtLaboraResponse {
numero: number;
texto: string;
localizacao: {
parte: { numero: number; titulo: string };
secao: { numero: number; titulo: string };
};
}
/** GET /api/oracoes/:slug */
interface OracaoResponse extends OraEtLaboraResponse {
id: string;
titulo: string;
categorias: string[];
texto: string;
latina?: string;
contexto?: string;
tags?: string[];
}
/** GET /api/liturgia */
interface LiturgiaResponse extends OraEtLaboraResponse {
data: string;
diaSemana: string;
tempoLiturgico: string;
corLiturgica: string;
leituras: {
tipo: string;
referencia: string;
texto: string;
}[];
}
/** GET /api/santo */
interface SantoResponse extends OraEtLaboraResponse {
data: string;
nome: string;
texto: string;
}
/** GET /api/busca?q=:termo */
interface BuscaResponse extends OraEtLaboraResponse {
query: string;
total: number;
resultados: {
biblia: BuscaResultadoBiblia[];
catecismo: BuscaResultadoCatecismo[];
regra: BuscaResultadoRegra[];
oracoes: BuscaResultadoOracao[];
documentos: BuscaResultadoDocumento[];
};
}
/** Erro da API */
interface OraEtLaboraError {
erro: string;
fonte: string;
}Notas e particularidades
- Regra de São Bento: o Prólogo é o capítulo
0. Capítulos de 1 a 73. - Diálogos: o Prefácio é o capítulo
-1, o Prólogo é0. Capítulos de 1 a 38. - Salmos: o livro de Salmos (
sl) tem 150 capítulos — o maior da Bíblia. - Catecismo: os parágrafos vão de §1 a §2865. Nem todos os números existem (há lacunas na numeração original).
- Documentos da Igreja: cada documento começa pelo capítulo
0(Proemio ou Introdução). Os parágrafos seguem a numeração oficial do Vaticano. Use/api/documentospara listar todos os slugs disponíveis. - Liturgia e Santo: dados obtidos em tempo real da Canção Nova, atualizados a cada hora. Podem estar indisponíveis fora do horário de atualização. Não recomendados para integração em produção.
- Rate limit: a API pública permite 60 requisições por minuto por IP. Requisições autenticadas com
x-api-keynão têm limite. - Cache: conteúdo estático (Bíblia, Catecismo, Regra, Orações) tem cache de 24h. Calendário litúrgico: 1h. Liturgia e Santo: 30min.
- Abreviações bíblicas: a API aceita abreviações em maiúsculas ou minúsculas (
Gn=gn).
Termos de uso
Uso público aberto
A API do Ora et Labora é aberta para uso em projetos de caráter catequético, devocional e educacional.
Ao utilizar a API, você concorda com as seguintes condições:
- Atribuição obrigatória:cite “Ora et Labora (oraetlabora.com.br)” como fonte dos dados em qualquer projeto que utilize a API.
- Sem garantia:a API é oferecida “como está”, sem garantias de disponibilidade contínua.
- Uso responsável: a API pública tem limite de 60 requisições por minuto por IP. Se precisar de acesso em volume, entre em contato.
- Respeito ao conteúdo: os textos sagrados devem ser utilizados com respeito à sua natureza religiosa.
Uso licenciado — Anjo Comunicação
A API pode ser consumida por produtos e serviços da Anjo Comunicação e seus clientes diretos (como sites paroquiais) mediante acordo de licenciamento.
- Autenticação: requisições licenciadas devem incluir o header
x-api-keycom a chave fornecida pela equipe do Ora et Labora. - Sem rate limit: requisições autenticadas não estão sujeitas ao limite de 60 req/min.
- Atribuição:não é obrigatório exibir atribuição visível ao usuário final, mas o crédito “Ora et Labora” deve constar no rodapé ou na página “Sobre” do site.
- Escopo: a licença cobre todos os endpoints de conteúdo estático (Bíblia, Catecismo, Regra, Apoftegmas, Orações, Diálogos, Documentos, Glossário e Calendário Litúrgico). Os endpoints de Liturgia Diária e Santo do Dia dependem de fonte externa e não são recomendados para integração em produção.
Para solicitar uma API key, entre em contato pelo e-mail contato@oraetlabora.com.br.
Dúvidas ou sugestões sobre a API?