Para Desenvolvedores

API Católica — Ora et Labora

API REST gratuita e aberta com a Bíblia Católica completa (73 livros), Regra de São Bento, 721 Apoftegmas dos Padres do Deserto e o Catecismo da Igreja Católica (2.865 parágrafos).

Base URL

https://oraetlabora.com.br/api

Formato de resposta: JSON
Autenticação: nenhuma (acesso livre)
CORS: habilitado (qualquer origem)
Método: GET apenas

Bíblia Católica

GET/api/biblia

Lista todos os 73 livros (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 },
    ...
  ],
  "novo_testamento": [
    { "abbrev": "mt", "nome": "Mateus", "capitulos": 28 },
    ...
  ]
}

GET/api/biblia/:livro

Informações de um livro específico

Parâmetros: livro — abreviação do livro (ex: gn, mt, sl)

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

Versículos de um capítulo específico

Parâmetros: livro — abreviação · 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 os céus e a terra." },
    ...
  ]
}

Regra de São Bento

GET/api/regra

Lista o Prólogo e os 73 capítulos

Exemplo

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

Resposta

{
  "fonte": "Ora et Labora — oraetlabora.com.br",
  "total": 74,
  "capitulos": [
    { "numero": 0, "titulo": "Prólogo", "versiculos": 50 },
    { "numero": 1, "titulo": "Dos vários gêneros de monges", "versiculos": 13 },
    ...
  ]
}

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",
  "versiculos": [
    { "numero": 1, "texto": "Escuta, filho, os preceitos do mestre..." },
    ...
  ]
}

GET/api/regra/busca?q=:termo

Busca por palavra-chave em todos os versículos

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": "..."
    },
    ...
  ]
}

Apoftegmas dos Padres do Deserto

GET/api/apoftegmas

Lista todos os 92 autores e contagem 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 },
    ...
  ]
}

GET/api/apoftegmas/:padre

Todos os apoftegmas de um autor específico

Parâmetros: padre — ID do autor (ex: antao, 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": "..." },
    ...
  ]
}

Catecismo da Igreja Católica

GET/api/catecismo

Estrutura completa: 4 Partes e suas Seções

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": "...", "paragrafos_range": [1, 184] },
        ...
      ]
    },
    ...
  ]
}

GET/api/catecismo/p/:numero

Um parágrafo específico pelo 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 é o memorial da Páscoa de Cristo...",
  "localizacao": {
    "parte": { "numero": 2, "titulo": "A Celebração do Mistério Cristão" },
    "secao": { "numero": 2, "titulo": "..." }
  }
}

Exemplos de uso

JavaScript / fetch

fetch("https://oraetlabora.com.br/api/regra/7")
  .then(res => res.json())
  .then(data => {
    console.log(data.titulo);
    data.versiculos.forEach(v => {
      console.log(`v.${v.numero}: ${v.texto}`);
    });
  });

Python

import requests

r = requests.get("https://oraetlabora.com.br/api/catecismo/p/1324")
data = r.json()
print(f"§{data['numero']}: {data['texto']}")

cURL

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

Termos de uso

A API do Ora et Labora é gratuita e aberta para uso em projetos de caráter catequético, devocional, educacional ou sem fins lucrativos.

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.
Uso não comercial: os dados não podem ser revendidos ou redistribuídos como produto comercial próprio.
Sem garantia: a API é oferecida “como está”, sem garantias de disponibilidade contínua.
Uso responsável: evite requisições excessivas. Se precisar de acesso em volume, entre em contato.
Respeito ao conteúdo: os textos sagrados devem ser utilizados com respeito à sua natureza religiosa.

Para projetos comerciais ou uso em grande escala, entre em contato pelo e-mail suporte@anjocomunicacao.com.br.

Dúvidas ou sugestões sobre a API?

suporte@anjocomunicacao.com.br·GitHub: ojotagui/oraetlabora