Ⲕⲁⲧⲁⲙⲉⲣⲟⲥ - 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}

Parameter	Type	Format
year	integer	YYYY
languageId	integer	1-7

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

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

pierresaid/katameros-api