SANCTORUM

Endpoints Disponíveis

O Sanctorum oferece acesso programático ao calendário litúrgico tradicional através dos seguintes endpoints:

Estrutura de Dados

Os dados litúrgicos retornados seguem esta estrutura:

{
  "data": {"annus": 2025, "mensis": 6, "dies": 13},
  "celebratio": {
    "id": "quattuor-tempora-pentecostes-6",
    "nomen": "Feria VI Quattuor Temporum Pentecostes",
    "classis": 1,
    "color": "rubeus",
    "octava": true,
    "feria": true
  },
  "commemorationes": [
    {
      "id": "infra-octavam-pentecostes-5",
      "nomen": "Infra Octavam Pentecostes",
      "classis": 1,
      "color": "rubeus",
      "octava": true
    },
    {
      "id": "antonius-padua",
      "nomen": "S. Antonius de Padua",
      "classis": 3,
      "color": "albus",
      "tituli": ["C", "D"]
    }
  ],
  "sancti_diei": [
    {
      "id": "antonius-padua",
      "nomen": "S. Antonius de Padua",
      "classis": 3,
      "color": "albus",
      "tituli": ["C", "D"]
    }
  ],
  "tempus": {
    "id": "octava-pentecostes",
    "nomen": "Octava Pentecostes",
    "color": "rubeus"
  },
  "color": "rubeus",
  "metadata": {
    "diesSeptimanae": 5,
    "nomenDiei": "Feria sexta",
    "numerusHebdomadae": null,
    "estInfraOctavam": false
  }
}

Uso em Aplicações

Para integrar o calendário litúrgico em sua aplicação:

// Exemplo em JavaScript
fetch('https://sanctorum.app/api/dies?annus=2023&mensis=12&dies=25')
  .then(response => response.json())
  .then(celebratio => {
    console.log(`Celebração: ${celebratio.celebratioPrincipalis.nomen}`);
    console.log(`Cor litúrgica: ${celebratio.celebratioPrincipalis.color}`);
  });

Sobre o Sanctorum

O Sanctorum implementa com precisão o calendário litúrgico tradicional segundo as rubricas do Missale Romanum de 1962, incluindo:

• Calendário Litúrgico: Cálculo automático de festas móveis baseadas na Páscoa
• Precedência: Aplicação das regras do Codex Rubricarum
• Missale Romanum: 21+ missas do Proprium de Tempore implementadas
• Ordo Missae: Sistema completo com 5 formas de missa
• Liber Usualis: Kyriale e cantus gregorianos autênticos (edição 1961)
• Cores litúrgicas: Classes de celebrações conforme tradição
• Santos do dia: Lista completa (sancti_diei), independentemente da precedência