Pular para o conteúdo
Bíblia CatólicaRegra de São BentoVida de São Bento
OraçõesLiturgia DiáriaSanto do Dia
MosteirosSantos BeneditinosPodcast
SobreAnotaçõesFavoritos

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-key para 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étodoEndpointDescrição
GET/api/bibliaLista todos os 73 livros
GET/api/biblia/:livroInformações de um livro
GET/api/biblia/:livro/:capituloVersículos de um capítulo
GET/api/regraLista Prólogo e 73 capítulos
GET/api/regra/:capituloVersículos de um capítulo
GET/api/regra/busca?q=:termoBusca na Regra
GET/api/dialogosLista os 40 capítulos
GET/api/dialogos/:capituloParágrafos de um capítulo
GET/api/apoftegmasLista os 92 autores
GET/api/apoftegmas/:padreApoftegmas de um autor
GET/api/catecismoEstrutura das 4 partes
GET/api/catecismo/p/:numeroUm parágrafo (§1–§2865)
GET/api/oracoesLista todas as 54 orações
GET/api/oracoes/:slugUma oração específica
GET/api/documentosLista documentos da Igreja
GET/api/documentos/:idMetadados de um documento
GET/api/documentos/:id/:capituloCapítulo de um documento
GET/api/documentos/busca?q=:termoBusca em documentos
GET/api/calendarioCalendário litúrgico completo
GET/api/calendario/hojeTempo litúrgico atual
GET/api/calendario/:mesCelebrações de um mês
GET/api/busca?q=:termoBusca unificada em todo o acervo
GET/api/santoSanto do dia
GET/api/liturgiaLiturgia do dia

Bíblia Católica

GET/api/biblia

Lista todos os 73 livros da Bíblia Católica, separados por Antigo e Novo Testamento

Exemplo

https://oraetlabora.com.br/api/biblia

Resposta

{
  "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
  ]
}
GET/api/biblia/:livro

Informações de um livro específico

Parâmetros: livro — abreviação do livro (veja tabela completa abaixo)

Exemplo

https://oraetlabora.com.br/api/biblia/gn

Resposta

{
  "fonte": "Ora et Labora — oraetlabora.com.br",
  "abbrev": "gn",
  "nome": "Gênesis",
  "capitulos": 50
}
GET/api/biblia/:livro/:capitulo

Todos 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/1

Resposta

{
  "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

GET/api/regra

Lista o Prólogo (capítulo 0) e os 73 capítulos da Regra de São Bento

Exemplo

https://oraetlabora.com.br/api/regra

Resposta

{
  "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
  ]
}
GET/api/regra/:capitulo

Versí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/0

Resposta

{
  "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
  ]
}
GET/api/regra/busca?q=:termo

Busca 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=humildade

Resposta

{
  "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.

GET/api/dialogos

Lista o Prefácio (−1), Prólogo (0) e os 38 capítulos

Exemplo

https://oraetlabora.com.br/api/dialogos

Resposta

{
  "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
  ]
}
GET/api/dialogos/:capitulo

Pará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/1

Resposta

{
  "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

GET/api/apoftegmas

Lista todos os 92 autores e a contagem total de apoftegmas

Exemplo

https://oraetlabora.com.br/api/apoftegmas

Resposta

{
  "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
  ]
}
GET/api/apoftegmas/:padre

Todos 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/antao

Resposta

{
  "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

GET/api/catecismo

Estrutura completa: 4 Partes com suas Seções e intervalos de parágrafos

Exemplo

https://oraetlabora.com.br/api/catecismo

Resposta

{
  "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
  ]
}
GET/api/catecismo/p/:numero

Um 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/1324

Resposta

{
  "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.

GET/api/oracoes

Lista 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/oracoes

Resposta

{
  "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
  ]
}
GET/api/oracoes/:slug

Uma 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-nosso

Resposta

{
  "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.

GET/api/documentos

Lista 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/documentos

Resposta

{
  "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
    }
  ]
}
GET/api/documentos/:id

Metadados 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-concilium

Resposta

{
  "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 }
  ]
}
GET/api/documentos/:id/:capitulo

Texto 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/1

Resposta

{
  "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..." }
    ]
  }
}
GET/api/documentos/busca?q=:termo

Busca 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=eucaristia

Resposta

{
  "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.

GET/api/calendario

Retorna o ano litúrgico completo com todos os tempos e celebrações

Exemplo

https://oraetlabora.com.br/api/calendario

Resposta

{
  "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" }
    // ...
  ]
}
GET/api/calendario/hoje

Retorna 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/hoje

Resposta

{
  "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"
  }
}
GET/api/calendario/:mes

Todas 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/12

Resposta

{
  "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

GET/api/busca?q=:termo

Busca 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=eucaristia

Resposta

{
  "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.

GET/api/santo

Retorna o santo celebrado no dia atual

Exemplo

https://oraetlabora.com.br/api/santo

Resposta

{
  "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.

GET/api/liturgia

Liturgia do dia: leituras, salmo responsorial e evangelho com cor e tempo litúrgico

Exemplo

https://oraetlabora.com.br/api/liturgia

Resposta

{
  "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.LivroCap.
gnGênesis50
exÊxodo40
lvLevítico27
nmNúmeros36
dtDeuteronômio34
jsJosué24
jzJuízes21
rtRute4
1sm1 Samuel31
2sm2 Samuel24
1re1 Reis22
2re2 Reis25
1cr1 Crônicas29
2cr2 Crônicas36
esdEsdras10
neNeemias13
tbTobias14
jdtJudite16
estEster16
job42
slSalmos150
pvProvérbios31
ecEclesiastes12
ctCântico dos Cânticos8
sbSabedoria19
ecloEclesiástico51
isIsaías66
jrJeremias52
lmLamentações5
brBaruc6
ezEzequiel48
dnDaniel14
osOséias14
jlJoel3
amAmós9
abdAbdias1
jonJonas4
mqMiqueias7
naNaum3
habHabacuc3
sofSofonias3
agAgeu2
zcZacarias14
mlMalaquias4
1mc1 Macabeus16
2mc2 Macabeus15

Novo Testamento (27 livros)

Abrev.LivroCap.
mtMateus28
mcMarcos16
lcLucas24
joJoão21
atAtos dos Apóstolos28
rmRomanos16
1cor1 Coríntios16
2cor2 Coríntios13
glGálatas6
efEfésios6
flFilipenses4
clColossenses4
1ts1 Tessalonicenses5
2ts2 Tessalonicenses3
1tm1 Timóteo6
2tm2 Timóteo4
ttTito3
fmFilemon1
hbHebreus13
tgTiago5
1pd1 Pedro5
2pd2 Pedro3
1jo1 João5
2jo2 João1
3jo3 João1
jdJudas1
apApocalipse22

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)DocumentoTipoAutoridadeCap.Par.
sacrosanctum-conciliumSacrosanctum ConciliumConstituiçãoConcílio Vaticano II (1963)8130
lumen-gentiumLumen GentiumConst. DogmáticaConcílio Vaticano II (1964)869
dei-verbumDei VerbumConst. DogmáticaConcílio Vaticano II (1965)726
gaudium-et-spesGaudium et SpesConst. PastoralConcílio Vaticano II (1965)1293
redemptionis-sacramentumRedemptionis SacramentumInstruçãoCongr. Culto Divino (2004)9186
ecclesia-de-eucharistiaEcclesia de EucharistiaEncíclicaJoão Paulo II (2003)862
sacramentum-caritatisSacramentum CaritatisExortação ApostólicaBento XVI (2007)597
Total57663

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/documentos para 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-key nã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:

  1. Atribuição obrigatória:cite “Ora et Labora (oraetlabora.com.br)” como fonte dos dados em qualquer projeto que utilize a API.
  2. Sem garantia:a API é oferecida “como está”, sem garantias de disponibilidade contínua.
  3. 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.
  4. 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.

  1. Autenticação: requisições licenciadas devem incluir o header x-api-key com a chave fornecida pela equipe do Ora et Labora.
  2. Sem rate limit: requisições autenticadas não estão sujeitas ao limite de 60 req/min.
  3. 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.
  4. 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?