Browse Roman Catholic liturgical calendar through a web interface or obtain it's data in JSON format through an API.
Powered by calendarium-romanum and grape.
Church Calendar API is a more or less RESTful read-only JSON API.
API documentation with URI examples and live links to API endpoints: http://calapi.inadiutorium.cz/api-doc
In case you want to run your own instance of the API, either for development or to make your own public instance of the service:
- install dependencies using Bundler
$ bundle install - start application by
$ rackup
Probably the easiest production deployment is to Heroku. The application works as is, you only need to create a new application in your Heroku dashboard and push the code.
Typical reasons for running your own instance include:
- availability/reliability requirements (the reference instance is self-hosted by the author and only maintained as free time permits)
- very high traffic expected
- custom calendar data that cannot be released as open-source (e.g. because it is copyrighted by the diocese)
Anyone intending to run a public instance is kindly asked to update contact information displayed on the web app.
In the data directory you will only find data for the General Roman Calendar in English. More data files (General Roman Calendar in Latin, calendars of the dioceses of the Czech Republic), together with a description of the data format, can be found in the repository of the calendarium-romanum gem.
In order to add a new calendar:
- put it's data file(s) in the
datadirectory - create a new record in
config/calendars.yml
For a complete example configuration with several calendars, including calendars composed of several "layered" data files, see configuration used at the author's instance of the API.
GNU/LGPL 3 or later