Documentação

API Ordinarium

API Própria

Backend — Paróquias

Base URL: https://api.ordinarium.com.br

API REST para consulta de paróquias da Arquidiocese de Teresina. Desenvolvida com NestJS e Drizzle ORM.

Endpoints

Método	Rota	Descrição
GET	/api/v1/paroquias	Listar todas as paróquias
GET	/api/v1/paroquias/:id	Obter paróquia por ID

Listar Paróquias

Retorna a lista completa de paróquias cadastradas, incluindo endereço, contato, coordenadas geográficas e dados eclesiais.

GET /api/v1/paroquias

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/paroquias

Exemplo de resposta

[
  {
    "id": 1,
    "forania": "Forania Centro",
    "tipo": "paroquia",
    "nome": "Paróquia São José",
    "endereco": "Rua Direita, 480 - Centro, Teresina - PI",
    "bairro": "Centro",
    "cep": "64000-040",
    "telefone": "(86) 3211-1234",
    "email": "paroquia.sjose@arquiteresina.com.br",
    "latitude": "-5.0892",
    "longitude": "-42.8019",
    "imagemUrl": "https://example.com/paroquia.jpg"
  }
]

Paróquia por ID

Retorna uma paróquia específica pelo seu ID numérico.

GET /api/v1/paroquias/:id

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/paroquias/1

Exemplo de resposta

{
  "id": 1,
  "forania": "Forania Centro",
  "tipo": "paroquia",
  "nome": "Paróquia São José",
  "endereco": "Rua Direita, 480 - Centro, Teresina - PI",
  "bairro": "Centro",
  "cep": "64000-040",
  "telefone": "(86) 3211-1234",
  "email": "paroquia.sjose@arquiteresina.com.br",
  "instagram": "@paroquiasjose",
  "paroco": "Pe. Carlos Mendes",
  "vigarios": ["Pe. João Lima"],
  "diaconos": ["Diácono Pedro Souza"],
  "latitude": "-5.0892",
  "longitude": "-42.8019"
}

Modelo de Dados — Parish

Campo	Tipo	Descrição
id	integer	ID único auto-incremental
forania	string	Forania à qual pertence
tipo	string	paroquia, capela, capelania, diaconia, area_pastoral, santuario
nome	string	Nome oficial da paróquia
endereco	string \| null	Endereço completo
bairro	string \| null	Bairro
cep	string \| null	CEP
telefone	string \| null	Telefone(s) de contato
email	string \| null	E-mail de contato
instagram	string \| null	Perfil do Instagram
site	string \| null	Site oficial
paroco	string \| null	Pároco atual
vigarios	string[]	Vigários
diaconos	string[]	Diáconos
latitude	number \| null	Latitude geográfica
longitude	number \| null	Longitude geográfica

API Própria

Orações e Exame de Consciência

Base URL: https://api.ordinarium.com.br

Endpoints

Método	Rota	Descrição
GET	/api/v1/health	Verificar integridade da API
GET	/api/v1/prayers	Listar todas as orações
GET	/api/v1/prayers?category={categoria}	Filtrar orações por categoria
GET	/api/v1/prayers/search?q={termo}	Buscar orações por termo
GET	/api/v1/prayers/random	Obter uma oração aleatória
GET	/api/v1/prayers/{slug}	Obter oração pelo slug
GET	/api/v1/examination	Exame de consciência completo
GET	/api/v1/examination/categories	Listar categorias do exame
GET	/api/v1/examination/{categoria}	Perguntas de uma categoria

Health Check

Verificar se a API está funcionando.

GET /api/v1/health

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/health

Exemplo de resposta

{
  "status": "healthy",
  "project": "Ordinarium Prayers API",
  "version": "1.0.0"
}

Listar Orações

Retorna todas as orações cadastradas. Suporta filtro opcional por categoria.

GET /api/v1/prayers

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/prayers

Exemplo de resposta

[
  {
    "id": 1,
    "slug": "sinal-da-cruz",
    "title": "Sinal da Cruz",
    "category": "Orações Fundamentais",
    "text": "Pelo sinal da Santa Cruz...",
    "source": "Tradição da Igreja",
    "language": "pt-BR"
  }
]

Filtrar por categoria:

curl "https://api.ordinarium.com.br/api/v1/prayers?category=Orações Marianas"

Buscar Orações

Pesquisa case-insensitive por título, texto ou categoria (ignorando acentos).

GET /api/v1/prayers/search?q={termo}

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/prayers/search?q=espirito

Exemplo de resposta

[
  {
    "id": 8,
    "slug": "vinde-espirito-santo",
    "title": "Vinde Espírito Santo",
    "category": "Orações ao Espírito Santo",
    "text": "Vinde, Espírito Santo, enchei os corações...",
    "source": "Liturgia das Horas",
    "language": "pt-BR"
  }
]

Oração Aleatória

Retorna uma oração selecionada aleatoriamente.

GET /api/v1/prayers/random

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/prayers/random

Exemplo de resposta

{
  "id": 6,
  "slug": "salve-rainha",
  "title": "Salve Rainha",
  "category": "Orações Marianas",
  "text": "Salve, Rainha, Mãe de misericórdia...",
  "source": "Tradição da Igreja (Hermann de Reichenau)",
  "language": "pt-BR"
}

Oração por Slug

Retorna os detalhes completos de uma oração pelo seu slug único.

GET /api/v1/prayers/{slug}

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/prayers/pai-nosso

Exemplo de resposta

{
  "id": 2,
  "slug": "pai-nosso",
  "title": "Pai Nosso",
  "category": "Orações Fundamentais",
  "text": "Pai nosso que estais nos céus...",
  "source": "Mateus 6, 9-13 / Catecismo",
  "language": "pt-BR"
}

Exame de Consciência Completo

Retorna todas as categorias do exame de consciência com suas perguntas reflexivas.

GET /api/v1/examination

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/examination

Exemplo de resposta

[
  {
    "category": "Introdução",
    "questions": [
      {
        "text": "Busco sinceramente aproximar-me de Deus...",
        "response": false
      }
    ]
  }
]

Categorias do Exame

Lista apenas os nomes das categorias disponíveis.

GET /api/v1/examination/categories

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/examination/categories

Exemplo de resposta

[
  "Introdução",
  "Amor a Deus",
  "Vida sacramental",
  "Família",
  "Trabalho",
  "Caridade",
  "Pureza",
  "Justiça",
  "Encerramento"
]

Perguntas por Categoria

Retorna as perguntas de uma categoria específica do exame de consciência.

GET /api/v1/examination/{categoria}

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/examination/Família

Exemplo de resposta

{
  "category": "Família",
  "questions": [
    "Fui desobediente, desrespeitoso ou desatencioso com meus pais...",
    "Tenho sido paciente, amoroso e compreensivo com meu cônjuge..."
  ]
}

Modelos de Dados

Prayer

Campo	Tipo	Descrição
id	integer	ID único da oração
slug	string	Identificador URL-friendly
title	string	Título da oração
category	string	Categoria temática
text	string	Texto completo da oração
source	string	Origem/fonte da oração
language	string	Idioma (padrão: pt-BR)

ExaminationCategory

Campo	Tipo	Descrição
category	string	Nome da categoria
questions	array	Perguntas reflexivas (`{text, response}`)

Códigos de Erro

Status	Descrição
404	Oração ou categoria não encontrada
422	Parâmetros inválidos (ex: query string vazia)

API Própria

Bíblia Sagrada

Base URL: https://api.ordinarium.com.br

Bíblia Sagrada Católica completa — 73 livros (incluindo deuterocanônicos) com busca textual, capítulos e versículos. Suporta busca por nome ou abreviação do livro.

Endpoints

Método	Rota	Descrição
GET	/api/v1/bible/books	Listar os 73 livros da Bíblia
GET	/api/v1/bible/books/{book}	Detalhes de um livro
GET	/api/v1/bible/search?q={termo}	Busca textual (mín. 3 caracteres)
GET	/api/v1/bible/{book}/{chapter}	Capítulo completo
GET	/api/v1/bible/{book}/{chapter}/{verse}	Versículo específico

Listar Livros

Retorna os 73 livros da Bíblia Católica (incluindo deuterocanônicos), com nome, abreviação, quantidade de capítulos e testamento.

GET /api/v1/bible/books

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/bible/books

Exemplo de resposta

[
  {
    "name": "Gênesis",
    "abbrev": "gn",
    "chapters_count": 50,
    "testament": "Antigo"
  },
  {
    "name": "Evangelho segundo S. João",
    "abbrev": "joao",
    "chapters_count": 21,
    "testament": "Novo"
  }
]

Detalhes do Livro

Retorna informações resumidas sobre um livro específico, identificado por nome ou abreviação.

GET /api/v1/bible/books/{book}

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/bible/books/gn

Exemplo de resposta

{
  "name": "Gênesis",
  "abbrev": "gn",
  "chapters_count": 50,
  "testament": "Antigo"
}

Busca Textual

Busca uma palavra ou frase em toda a Bíblia, retornando as ocorrências com livro, capítulo e versículo.

GET /api/v1/bible/search?q={termo}

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/bible/search?q=amor

Exemplo de resposta

[
  {
    "book": "Evangelho segundo S. João",
    "abbrev": "joao",
    "chapter": 3,
    "verse": 16,
    "text": "Porque Deus amou o mundo de tal modo..."
  }
]

O termo de busca deve conter pelo menos 3 caracteres.

Capítulo Completo

Retorna todos os versículos de um capítulo de um livro específico.

GET /api/v1/bible/{book}/{chapter}

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/bible/joao/3

Exemplo de resposta

{
  "chapter": 3,
  "verses": [
    { "number": 1, "text": "Havia um homem dos fariseus..." },
    { "number": 2, "text": "Este foi ter de noite com Jesus..." },
    { "number": 16, "text": "Porque Deus amou o mundo de tal modo..." }
  ]
}

Versículo Específico

Retorna o texto de um versículo específico de um capítulo e livro selecionados.

GET /api/v1/bible/{book}/{chapter}/{verse}

Exemplo de chamada

curl https://api.ordinarium.com.br/api/v1/bible/joao/3/16

Exemplo de resposta

{
  "number": 16,
  "text": "Porque Deus amou o mundo de tal modo, que deu o seu Filho Unigênito, para que todo aquele que nele crê não pereça, mas tenha a vida eterna."
}

API Própria

Santo do Dia

Base URL: https://api.ordinarium.com.br

API de web scraping que obtém informações sobre o santo do dia a partir do site A12. Retorna nome, imagem, história, reflexão e oração.

Endpoints

Método	Rota	Descrição
GET	/	Santo do dia atual
GET	/dia={dia}&mes={mes}	Santo de uma data específica

Santo do Dia Atual

Retorna o(s) santo(s) celebrado(s) no dia atual, com nome, imagem, história, reflexão e oração.

GET /santo-do-dia/

Exemplo de chamada

curl https://api.ordinarium.com.br/santo-do-dia/

Exemplo de resposta

{
  "results": [
    {
      "nome": "São João Bosco",
      "imagem": "https://www.a12.com/caminho-para-imagem.jpg",
      "historia": "João Bosco nasceu em 16 de agosto de 1815...",
      "reflexao": "A vida de São João Bosco nos ensina...",
      "oracao": "Ó Deus, que concedestes a São João Bosco..."
    }
  ]
}

Santo por Data

Retorna o(s) santo(s) celebrado(s) em uma data específica.

GET /santo-do-dia/dia={dia}&mes={mes}

Exemplo de chamada

curl https://api.ordinarium.com.br/santo-do-dia/dia=5&mes=6

Exemplo de resposta

{
  "results": [
    {
      "nome": "Santo Inácio de Loyola",
      "imagem": "https://www.a12.com/caminho-para-imagem.jpg",
      "historia": "Inácio de Loyola nasceu em 1491...",
      "reflexao": "São Inácio nos ensina a buscar Deus em todas as coisas...",
      "oracao": "Ó Deus, que pelo ministério..."
    }
  ]
}

Parâmetros de rota:

dia Dia do mês (1-31) mes Mês do ano (1-12)

Observações

• O web scraping pode falhar caso o site de origem (A12) altere sua estrutura HTML.
• Pode haver variação no tempo de resposta dependendo do carregamento da página de origem.

API de Terceiros

Liturgia Diária

API pública mantida por Dancrf. Código fonte disponível no GitHub.

Esta API fornece as orações e leituras do dia da Santa Missa (liturgia diária). Suporta consulta por data específica, período de dias, e versões alternativas de leituras.

liturgia.up.railway.app/v2 Documentação v2 Documentação v3 (beta)

Endpoints (v2)

Método	Rota	Descrição
GET	/v2/	Liturgia do dia atual
GET	/v2/?dia={dia}&mes={mes}&ano={ano}	Liturgia de data específica
GET	/v2/{dia}-{mes}	Liturgia via parâmetro de rota
GET	/v2/?periodo={dias}	Liturgia de um período (máx: 7 dias)

Exemplo de resposta

{
  "data": "19/04/2025",
  "liturgia": "Sábado Santo - Vigília Pascal",
  "cor": "Branco",
  "oracoes": {
    "coleta": "...",
    "oferendas": "...",
    "comunhao": "..."
  },
  "leituras": {
    "primeiraLeitura": [...],
    "salmo": [...],
    "segundaLeitura": [...],
    "evangelho": [...]
  },
  "antifonas": {
    "entrada": "...",
    "comunhao": "..."
  }
}

Consulte a documentação oficial para detalhes completos de todos os campos.