Novidade: O app Ora et Labora chegou para iPhone e Android. App disponível para iPhone e Android. Conheça →
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, o Graduale Romanum e o Calendário Litúrgico.
Base URL
https://oraetlabora.com.br/api/v1- Versionamento:
/api/v1é o contrato oficial (OpenAPI 3.1); os caminhos/apicontinuam funcionando como legado compatível, com as mesmas respostas - Contrato formal: openapi/openapi.yaml no repositório — validado contra a implementação em CI
- Formato de resposta: JSON (exceção: o folheto do Graduale retorna PDF)
- Autenticação: opcional — header
x-api-keypara uso licenciado - Rate limit: 60 req/min por IP — 600 req/min com API key
- CORS: respostas via navegador restritas às origens do próprio oraetlabora.com.br — para consumir de outro domínio, chame a API a partir do seu servidor
- Método: GET apenas (e OPTIONS para preflight)
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/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/graduale/folheto | Folheto da Missa em PDF (4 req/min) |
| GET | /api/v1/meta | Estatísticas e versão da API |
| GET | /api/v1/health | Health check (sem cache) |
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": "Evangelho Segundo São Mateus", "capitulos": 28 },
{ "abbrev": "mc", "nome": "Evangelho Segundo São Marcos", "capitulos": 16 },
{ "abbrev": "lc", "nome": "Evangelho Segundo São 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": "abade-antao", "nome": "Abade Antão", "apoftegmas": 38 },
{ "id": "abade-arsenio", "nome": "Abade Arsênio", "apoftegmas": 44 },
{ "id": "abade-agatao", "nome": "Abade Agatão", "apoftegmas": 30 }
// ... 89 autores restantes
]
}/api/apoftegmas/:padreTodos os apoftegmas de um autor específico
Parâmetros: padre — ID do autor (ex: abade-antao, abade-arsenio, abade-agatao; veja a tabela completa abaixo)
Exemplo
https://oraetlabora.com.br/api/apoftegmas/abade-antaoResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"id": "abade-antao",
"nome": "Abade 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 pensa…"
}
// ... 37 apoftegmas restantes
]
}Calendário Litúrgico
Calendário litúrgico do ano em curso com tempos, solenidades, festas e memórias. As respostas abaixo são exemplos ilustrativos — as datas reais acompanham o ano litúrgico vigente; para o dia atual, use /api/calendario/hoje.
/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" }
// ...
]
}Graduale Romanum — Folheto da Missa
Gera no servidor o folheto em PDF de uma Missa montada no Graduale (a mesma da URL compartilhável de /graduale). Por exigir renderização no servidor, tem limite próprio de 4 requisições por minuto — inclusive para requisições com API key.
/api/graduale/folhetoFolheto da Missa em PDF (A4 paisagem), pronto para impressão. Resposta binária application/pdf com Content-Disposition: attachment. Ao contrário dos demais endpoints, os erros retornam text/plain.
Parâmetros: proprio e ordinario (obrigatórios) — slugs de celebração do Graduale · opcionais: credo, asperges, seq e as escolhas por slot (introito, kyrie, gloria, gradual, aleluia, ofertorio, sanctus, agnus, communio)
Exemplo
https://oraetlabora.com.br/api/graduale/folheto?proprio=advento-1&ordinario=kyriale-missa-1Resposta
// Resposta binária — application/pdf (não JSON) // Content-Disposition: attachment; filename="folheto-advento-1.pdf" // Cache-Control: public, max-age=3600 // Erros (text/plain): // 400 — Parâmetros 'proprio' e 'ordinario' são obrigatórios. // 404 — Celebração não encontrada. // 500 — Não foi possível gerar o PDF.
Meta e Health
Endpoints de serviço, disponíveis apenas sob /api/v1. As estatísticas de /meta são contadas do acervo real a cada deploy — nunca digitadas.
/api/v1/metaVersão da API, data da última publicação e estatísticas de todos os recursos, geradas da base real em tempo de build
Exemplo
https://oraetlabora.com.br/api/v1/metaResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"name": "Ora et Labora API",
"version": "1.0.0",
"updated_at": "(data do último deploy)",
"base_url": "/api/v1",
"docs": "/desenvolvedores",
"resources": {
"biblia": { "livros": 73, "versiculos": 35602 },
"regra": { "capitulos": 74, "versiculos": 921 },
"dialogos": { "capitulos": 40 },
"apoftegmas": { "total": 721 },
"graduale": { "celebracoes": 144, "pecas": 777 }
}
}/api/v1/healthHealth check para monitoramento externo — sempre dinâmico, sem cache
Exemplo
https://oraetlabora.com.br/api/v1/healthResposta
{
"fonte": "Ora et Labora — oraetlabora.com.br",
"status": "ok",
"at": "2026-08-22T12:00:00.000Z"
}Formato de erro
Erros usam o status HTTP correspondente (400, 404, 413, 429) e um JSON com o campo erro. Toda resposta da API inclui os headers X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset; o 429 traz também Retry-After (em segundos):
// 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"
}
// 429 — Limite de requisições excedido (header Retry-After em segundos)
{
"erro": "Limite de requisições excedido. Tente novamente em instantes.",
"limite": "60 requisições por minuto",
"fonte": "Ora et Labora — oraetlabora.com.br"
}Exceção: /api/graduale/folheto retorna erros em text/plain, não em JSON.
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 | Livro De Josué | 24 |
jz | Livro Dos Juízes | 21 |
rt | Rute | 4 |
1sm | Primeiro Livro De Samuel | 31 |
2sm | Segundo Livro De Samuel | 24 |
1rs | Primeiro Livro Dos Reis | 22 |
2rs | Segundo Livro Dos Reis | 25 |
1cr | Primeiro Livro Das Crônicas | 29 |
2cr | Segundo Livro Das Crônicas | 36 |
esd | Esdras | 10 |
ne | Neemias | 13 |
tb | Tobias | 14 |
jt | Judite | 16 |
est | Ester | 16 |
1mc | Primeiro Livro Dos Macabeus | 16 |
2mc | Segundo Livro Dos Macabeus | 15 |
jó | Jó | 42 |
sl | Salmos | 150 |
pr | Provérbios | 31 |
ecl | 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 |
ab | Abdias | 1 |
jn | Jonas | 4 |
mq | Miquéias | 7 |
na | Naum | 3 |
hab | Habacuc | 3 |
sf | Sofonias | 3 |
ag | Ageu | 2 |
zc | Zacarias | 14 |
ml | Malaquias | 4 |
Novo Testamento (27 livros)
| Abrev. | Livro | Cap. |
|---|---|---|
mt | Evangelho Segundo São Mateus | 28 |
mc | Evangelho Segundo São Marcos | 16 |
lc | Evangelho Segundo São Lucas | 24 |
jo | Evangelho Segundo São João | 21 |
at | Atos Dos Apóstolos | 28 |
rm | Carta Aos Romanos | 16 |
1cor | Primeira Carta Aos Coríntios | 16 |
2cor | Segunda Carta Aos Coríntios | 13 |
gl | Carta Aos Gálatas | 6 |
ef | Carta Aos Efésios | 6 |
fl | Carta Aos Filipenses | 4 |
cl | Carta Aos Colossenses | 4 |
1ts | Primeira Carta Aos Tessalonicenses | 5 |
2ts | Segunda Carta Aos Tessalonicenses | 3 |
1tm | Primeira Carta A Timóteo | 6 |
2tm | Segunda Carta A Timóteo | 4 |
tt | Carta A Tito | 3 |
fm | Carta A Filemon | 1 |
hb | Carta Aos Hebreus | 13 |
tg | Carta De São Tiago | 5 |
1pd | Primeira Carta De São Pedro | 5 |
2pd | Segunda Carta De São Pedro | 3 |
1jo | Primeira Carta De São João | 5 |
2jo | Segunda Carta De São João | 1 |
3jo | Terceira Carta De São João | 1 |
jd | Carta De São Judas | 1 |
ap | Apocalipse De São João | 22 |
Autores dos Apoftegmas
Os 92 autores (Padres e Madres do Deserto) disponíveis em /api/apoftegmas/:padre — use o slug (ID) para obter todos os apoftegmas de um autor.
| Slug (ID) | Autor | Apoftegmas |
|---|---|---|
abade-antao | Abade Antão | 38 |
abade-arsenio | Abade Arsênio | 44 |
abade-agatao | Abade Agatão | 30 |
abade-amonas | Abade Amonas | 11 |
abade-aquilaz | Abade Aquilaz | 6 |
abade-amoes | Abade Amoés | 5 |
abade-amum-da-nitria | Abade Amum Da Nítria | 3 |
abade-anube | Abade Anube | 2 |
abade-abraao | Abade Abraão | 3 |
abade-are | Abade Aré | 1 |
abade-alonio | Abade Alônio | 4 |
abade-afi | Abade Afi | 1 |
abade-apolo | Abade Apolo | 3 |
abade-andre | Abade André | 1 |
abade-aio | Abade Aio | 1 |
abade-amonataz | Abade Amonataz | 1 |
grande-basilio | Grande Basílio | 1 |
abade-bessariao | Abade Bessarião | 12 |
abade-benjamim | Abade Benjamim | 5 |
abade-biare | Abade Biaré | 1 |
abade-gregorio-o-teologo | Abade Gregório O Teólogo | 2 |
abade-gelasio | Abade Gelásio | 6 |
abade-geroncio | Abade Gerôncio | 1 |
abade-daniel | Abade Daniel | 8 |
abade-dioscoro | Abade Dióscoro | 3 |
abade-dulaz | Abade Dulaz | 2 |
santo-epifanio-bispo-de-chipre | Santo Epifânio, Bispo De Chipre | 17 |
abade-efrem | Abade Efrém | 3 |
eucaristo-o-secular | Eucaristo, O Secular | 1 |
eulogio-o-presbitero | Eulógio, O Presbítero | 1 |
abade-euprepio | Abade Euprépio | 7 |
abade-eladio | Abade Eládio | 2 |
abade-evagrio | Abade Evágrio | 7 |
abade-eudemao | Abade Eudemão | 1 |
abade-zeno | Abade Zeno | 8 |
abade-zacarias | Abade Zacarias | 5 |
abade-isaias-1 | Abade Isaías (1) | 11 |
abade-elias | Abade Elias | 8 |
abade-heraclio | Abade Heráclio | 1 |
abade-teodoro-de-ferma | Abade Teodoro De Ferma | 29 |
abade-teodoro-de-enato | Abade Teodoro De Enato | 3 |
abade-teodoro-da-cetia | Abade Teodoro Da Cétia | 1 |
abade-teodoro-de-eleuteropolis | Abade Teodoro De Eleuterópolis | 2 |
abade-teonaz | Abade Teonaz | 1 |
arcebispo-teofilo | Arcebispo Teófilo | 5 |
madre-teodora | Madre Teodora | 7 |
abade-joao-curto | Abade João Curto | 40 |
abade-joao-o-cenobita | Abade João O Cenobita | 1 |
abade-isidoro | Abade Isidoro | 9 |
abade-isidoro-de-pelusio | Abade Isidoro De Pelúsio | 6 |
abade-isaque-o-presbitero-das-celias | Abade Isaque, O Presbítero Das Célias | 12 |
abade-jose-de-panefo | Abade José De Panefo | 11 |
abade-tiago | Abade Tiago | 4 |
abade-hieraz | Abade Hieraz | 2 |
abade-joao-o-eunuco | Abade João O Eunuco | 6 |
abade-joao-das-celias | Abade João Das Célias | 2 |
abade-isidoro-o-presbitero | Abade Isidoro O Presbítero | 7 |
abade-joao-persa | Abade João Persa | 4 |
abade-joao-tebano | Abade João Tebano | 1 |
abade-joao-o-discipulo-do-abade-paulo | Abade João, O Discípulo Do Abade Paulo | 1 |
abade-isaque-tebano | Abade Isaque Tebano | 2 |
abade-jose-tebano | Abade José Tebano | 1 |
abade-hilariao | Abade Hilarião | 1 |
abade-isquiriao | Abade Isquirião | 1 |
abade-cassiano | Abade Cassiano | 8 |
abade-cronio | Abade Crônio | 6 |
abade-cariao | Abade Carião | 2 |
abade-ciro | Abade Ciro | 1 |
abade-lucio | Abade Lúcio | 1 |
abade-lote | Abade Lote | 2 |
abade-longino | Abade Longino | 5 |
abade-macario-egipcio | Abade Macário Egípcio | 41 |
abade-moises | Abade Moisés | 18 |
abade-matoes | Abade Matoés | 13 |
abade-marcos-discipulo-do-abade-silvano | Abade Marcos, Discípulo Do Abade Silvano | 5 |
abade-milesio | Abade Milésio | 2 |
abade-mocio | Abade Mócio | 2 |
abade-megetio | Abade Megétio | 4 |
abade-mios | Abade Miós | 3 |
abade-marcos-o-egipcio | Abade Marcos, O Egípcio | 1 |
abade-macario-da-cidade | Abade Macário, Da Cidade | 3 |
abade-nilo | Abade Nilo | 10 |
abade-nisteroo | Abade Nisterôo | 5 |
abade-nisteroo-o-cenobita | Abade Nisterôo, O Cenobita | 2 |
abade-nicon | Abade Nicon | 1 |
abade-netraz | Abade Netraz | 1 |
abade-nicetas | Abade Nicetas | 1 |
abade-xoio | Abade Xoio | 2 |
abade-xantias | Abade Xântias | 3 |
abade-olimpio | Abade Olímpio | 2 |
abade-orsisio | Abade Orsísio | 2 |
abade-poimem | Abade Poimém | 149 |
| Total — 92 autores | 721 | |
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 um capítulo dos Diálogos de São Gregório
fetch("https://oraetlabora.com.br/api/dialogos/1")
.then(res => res.json())
.then(data => console.log(data.titulo, "—", data.paragrafos.length, "parágrafos"));Python
import requests
# Listar o Prólogo e os capítulos da Regra de São Bento
r = requests.get("https://oraetlabora.com.br/api/regra")
data = r.json()
print(f"{data['total']} capítulos")
for cap in data['capitulos'][:5]:
print(f"Cap. {cap['numero']}: {cap['titulo']}")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" # Apoftegmas de um padre do deserto curl https://oraetlabora.com.br/api/apoftegmas/abade-antao
PHP
<?php
// Buscar os apoftegmas de um padre do deserto
$response = file_get_contents("https://oraetlabora.com.br/api/apoftegmas/abade-antao");
$data = json_decode($response, true);
echo $data['nome'] . "\n";
echo $data['apoftegmas'][0]['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
/** Tipos de TODOS os endpoints JSON — espelham openapi/openapi.yaml. */
/** Base de todas as respostas */
interface OraEtLaboraResponse {
fonte: string;
}
interface Versiculo {
numero: number;
texto: string;
}
/* ── Bíblia ─────────────────────────────────────────────── */
/** 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 */
interface BibliaLivroResponse extends OraEtLaboraResponse, BibliaLivro {}
/** GET /api/biblia/:livro/:capitulo */
interface BibliaCapituloResponse extends OraEtLaboraResponse {
livro: string;
abbrev: string;
capitulo: number;
versiculos: Versiculo[];
}
/* ── Regra de São Bento ─────────────────────────────────── */
/** 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: Versiculo[];
}
/** GET /api/regra/busca?q= */
interface RegraBuscaResponse extends OraEtLaboraResponse {
query: string;
total: number;
resultados: {
capitulo: number;
titulo: string;
versiculo: number;
texto: string;
}[];
}
/* ── Diálogos de São Gregório ───────────────────────────── */
/** GET /api/dialogos */
interface DialogosListResponse extends OraEtLaboraResponse {
total: number;
capitulos: { numero: number; titulo: string; paragrafos: number }[];
}
/** GET /api/dialogos/:capitulo */
interface DialogosCapituloResponse extends OraEtLaboraResponse {
numero: number;
titulo: string;
paragrafos: {
numero: number;
interlocutor: "Gregório" | "Pedro" | null;
texto: string;
}[];
}
/* ── Apoftegmas ─────────────────────────────────────────── */
/** GET /api/apoftegmas */
interface ApoftegmasListResponse extends OraEtLaboraResponse {
total_autores: number;
total_apoftegmas: number;
autores: { id: string; nome: string; apoftegmas: number }[];
}
/** GET /api/apoftegmas/:padre */
interface ApoftegmasAutorResponse extends OraEtLaboraResponse {
id: string;
nome: string;
total: number;
apoftegmas: Versiculo[];
}
/* ── Calendário Litúrgico ───────────────────────────────── */
interface Celebracao {
data: string;
nome: string;
tipo: string;
cor: string;
tempo: string;
}
/** GET /api/calendario */
interface CalendarioResponse extends OraEtLaboraResponse {
ano_liturgico: string;
ciclo_dominical: string;
ciclo_ferial: string;
tempos: {
id: string;
nome: string;
cor: string;
inicio: string;
fim: string;
}[];
total_celebracoes: number;
celebracoes: Celebracao[];
}
/** GET /api/calendario/hoje */
interface CalendarioHojeResponse extends OraEtLaboraResponse {
data: string;
tempo_liturgico: string;
cor_liturgica: string;
celebracao: Celebracao | null;
proximo_evento: { data: string; nome: string; tipo: string } | null;
}
/** GET /api/calendario/:mes */
interface CalendarioMesResponse extends OraEtLaboraResponse {
mes: number;
nome: string;
total: number;
celebracoes: Celebracao[];
}
/* ── Serviço (/api/v1) ──────────────────────────────────── */
/** GET /api/v1/meta */
interface MetaResponse extends OraEtLaboraResponse {
name: string;
version: string;
updated_at: string;
base_url: string;
docs: string;
resources: {
biblia: { livros: number; versiculos: number };
regra: { capitulos: number; versiculos: number };
dialogos: { capitulos: number };
apoftegmas: { total: number };
graduale: { celebracoes: number; pecas: number };
};
}
/** GET /api/v1/health */
interface HealthResponse extends OraEtLaboraResponse {
status: "ok";
at: string;
}
/* ── Erro ───────────────────────────────────────────────── */
/** Erro da API (JSON — exceto /api/graduale/folheto, que usa text/plain) */
interface OraEtLaboraError {
erro: string;
/** Presente apenas no 429, ex.: "60 requisições por minuto" */
limite?: 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. - Rate limit: a API pública permite 60 requisições por minuto por IP. Requisições autenticadas com
x-api-keytêm limite ampliado de 600 requisições por minuto. O folheto do Graduale tem limite próprio de 4 requisições por minuto, mesmo com API key. Toda resposta traz os headersX-RateLimit-*; ao receber429, aguarde o tempo indicado emRetry-After. - Cache: conteúdo estático (Bíblia, Regra, Diálogos, Apoftegmas) tem cache de 24h no navegador e 7 dias na CDN. Calendário litúrgico: 1h no navegador e 24h na CDN. Folheto do Graduale: 1h.
- 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. - Limite ampliado: requisições autenticadas têm limite de 600 req/min, em vez das 60 req/min do acesso público. O folheto do Graduale mantém o limite próprio de 4 req/min mesmo com API key.
- 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 (Bíblia, Regra, Apoftegmas, Diálogos, Graduale Romanum e Calendário Litúrgico).
Para solicitar uma API key, entre em contato pelo e-mail contato@oraetlabora.com.br.
Dúvidas ou sugestões sobre a API?