Informazioni per l'utilizzo programmatico del calcolatore del calendario liturgico italiano cattolico.

API (Application Program Interface)

L'output del calendario può essere ottenuto in JSON chiamando la pagina:
https://www.favrin.net/misc/calendario_liturgico/
con i seguenti parametri in query string:

anno=nnnn
Anno richiesto (obbligatorio, fra 1970 e 9999)
intervallo=fine_anno | oggi | domenica | settimana | prossimasettimana | mese | tre_mesi | sei_mesi | anno
Intervallo di ricerca (opzionale, predefinito "fine_anno" per l'anno in corso, "anno" per gli altri)
colorehex=0 | false | 1 | true
Restituisce il codice #rrggbb del colore liturgico invece del nome. Se il colore non è definito, restituisce 'transparent'.
compressjson=0 | false | 1 | true
Comprime l'output JSON omettendo gli spazi e la formattazione.
eventianno=0 | false | 1 | true
Include un array con informazioni sull'anno e le timestamp delle feste più importanti (opzionale, default 1, valido solo per l'intervallo "anno")
nodto=0 | false | 1 | true
Esclude le Domeniche del Tempo Ordinario (opzionale, default 0)
nofc=0 | false | 1 | true
Esclude le feste civili (opzionale, default 0)
noinfo=0 | false | 1 | true
Esclude le informazioni su precetto, fisso, tipo, liturgia e data istituzione (opzionale, default 0)
nolink=0 | false | 1 | true
Esclude i collegamenti esterni (opzionale, default 0)
numeriromani=0 | false | 1 | true
Mostra D.T.O. e altre indicazioni numeriche con i numeri romani (opzionale, default 0)
output=html | json | csv
Output HTML, JSON oppure CSV (case insensitive, opzionale, default html)
Selezionando CSV le opzioni noinfo e nolink vengono attivate e l'opzione mumeriromani viene disattivata.
precetto=0 | false | 1 | true
Include i soli eventi di precetto e delle feste civili, se non escluse con altra opzione (opzionale, default 0)

Esempi

https://www.favrin.net/misc/calendario_liturgico/?anno=2000&output=json (prova)
https://www.favrin.net/misc/calendario_liturgico/?anno=2024&intervallo=tre_mesi&output=json (prova)
https://www.favrin.net/misc/calendario_liturgico/?anno=2024&output=csv (prova)

Solo l'indicazione dell'output JSON e dell'anno sono obbligatorie.

Attenzione: l'output JSON, per il momento, è soggetto a modifiche senza preavviso. Il campo output_json indica eventuali cambi di formato.

Script di terze parti

Chi lo desidera può utilizzare lo script realizzato da Valentino Spataro per il sito pregaognigiorno.it e reperibile su GitHub.

In futuro, probabilmente, anche il mio calcolatore andrà su GitHub.