Katameros 1.2.1

Ⲕⲁⲧⲁⲙⲉⲣⲟⲥ - katameros-api

API for the daily readings in the Coptic Orthodox Church. Supports multiple bible versions and langages.

https://api.katameros.app/readings/gregorian/03-05-2023?languageId=2

Website https://katameros.app/?lang=en

Front end : https://github.com/pierresaid/katameros-web-app

What is the coptic lectionnary

Usage

BaseUrl https://api.katameros.app/

Readings

Endpoint

GET /readings/{calendar}/{date}

Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | calendar | string | Yes | The calendar used for the date. Can be either gregorian or coptic. | | date | string | Yes | The date in the format dd-mm-yyyy. | | languageId | integer | No | The ID of the language to use. Can be either 1 for French, 2 for English, 3 for Arabic, 4 for Italian. If no languageId is specified, the API will default to French. | | bibleId | integer | No | The ID of the Bible to use. |

Example Requests

GET https://api.katameros.app/readings/gregorian/03-05-2023?languageId=2
GET https://api.katameros.app/readings/coptic/25-08-1739
GET https://api.katameros.app/readings/gregorian/03-05-2023?languageId=4&bibleId=5

Languages | Language | ID | | --- | --- | | French | 1 | | English | 2 | | Arabic | 3 | | Italian | 4 | | German | 6 |

Bibles | Id | Name | Language | | --- | --- | --- | | 1 | Louis Segond 1910 (LSG) - 1910, Deutérocanonique : Bible de Jérusalem (JER) - 1973 | French | | 2 | NKJV | English | | 3 | Arabic | Arabic | | 4 | Riveduta 1927 (RIV) | Italian | | 5 | CEI 2008 (Psalms RIV) | Italian | | 7| Einheitsübersetzung der Heiligen Schrift (1980) [Quadro-Bibel 5.0] | German |

Feasts

(Some feasts are missing)

Endpoint

GET /feasts/{year}/{languageId}

Example Requests

GET https://api.katameros.app/feasts/2023/2

Tech Stack:

• .Net core API
• SQL Server
• Entity Framework

Database diagram

This is not the complete diagram as there are also other tables for translations and metadata. See full schema in /Database folder

Motivation :

This project was heavily inspired by the online coptic lectionnary in php. (Just like this site)

I wanted to re-create this project in an API to be able to use the daily readings on different clients.

Run the project

Either use VisualStudio and open the project in API/Katameros.sln

Or

• Install dotnet sdk
• dotnet run in the API folder

SQLITE Database

Todo

All the readings references comes from database except the feasts some are missing see board