Skip to content

pierresaid/katameros-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

92 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

image

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

SQLITE Database

Todo

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

About

API for the daily readings in the Coptic Orthodox Church

Resources

License

Stars

Watchers

Forks

Languages