API Православного Календаря

Добро пожаловать в документацию API Православного календаря. Этот API предоставляет данные о православном литургическом календаре, включая святых, праздники, правила поста и переходящие праздники (Пасху).

Базовый URL: https://api.ispovednik.org/api/v1

О календаре

Этот календарь основан на календаре РПЦЗ в последней редакции, известной до разделения 2007 года.

Из публикуемой версии календаря исключены:

память исповедника Якова Аркатова;
память новомученика Бориса Талантова.

Основание по Борису Талантову: Определение Архиерейского Собора Российской Православной Церкви о деканонизации Бориса Талантова.

Общие параметры

Параметр	Тип	Описание
`lang`	string	Код языка: `ru` (по умолчанию) или `en`.
`type`	integer	Фильтр святых по ID типа (например, `1` для Великих праздников).

Ограничения

Календарь + Святые: поддерживаются годы с 2000.
Пост + Переходящие праздники: поддерживаются годы 1583–3000.
Дни поминовения: поддерживаются годы 1583–4000.
Диапазоны дат (/range): максимум 366 дней.
Диапазон лет для переходящих праздников (/movable/range): максимум 100 лет.
Количество id в запросе гимнографии (/hymnography): максимум 24 id.

Доступные ресурсы

API разделен на несколько ресурсов. Нажмите на ресурс, чтобы посмотреть подробную документацию.

JavaScript-клиент (SDK)

Клиентская библиотека для потребителей API.

Журнал изменений

Выборочный журнал изменений календарных данных и документации (обновляется вручную).

Таблица предпразднств/попразднств/отданий (рабочий первоисточник)

Нормализованный текст эталонной таблицы и принятая логика расчёта для API.

OpenAPI 3.1 Viewer

Интерактивная документация: /openapi/index.html
JSON-спека: /openapi/v1.json

OpenAPI по разделам

Святые (RU): /docs/openapi/saints/
Святые (EN): /docs/en/openapi/saints/
Пасха и переходящие праздники (RU): /docs/openapi/pascha/
Пасха и переходящие праздники (EN): /docs/en/openapi/pascha/
Пост (RU): /docs/openapi/fasting/
Пост (EN): /docs/en/openapi/fasting/
Гимнография (RU): /docs/openapi/hymnography/
Гимнография (EN): /docs/en/openapi/hymnography/

JSON-спеки по разделам:

/openapi/saints.v1.ru.json
/openapi/saints.v1.en.json
/openapi/pascha.v1.ru.json
/openapi/pascha.v1.en.json
/openapi/fasting.v1.ru.json
/openapi/fasting.v1.en.json
/openapi/hymnography.v1.ru.json
/openapi/hymnography.v1.en.json

Единый календарь

Основной канал данных, объединяющий все типы информации.

День: /calendar/day/{date}
Год: /calendar/year/{year}
Месяц: /calendar/month/{year}/{month}
Диапазон: /calendar/range

Святые и Праздники

Данные о святых и неподвижных праздниках.

День: /saints/day/{date}
Год: /saints/year/{year}
Месяц: /saints/month/{year}/{month}
Диапазон: /saints/range

Пост

Правила поста и постные периоды.

День: /fasting/day/{date}
Год: /fasting/year/{year}
Месяц: /fasting/month/{year}/{month}
Диапазон: /fasting/range

Переходящие Праздники

Пасха и связанные с ней переходящие праздники.

День: /movable/day/{date}
Год: /movable/year/{year}
Диапазон: /movable/range

Дни Поминовения

Дни поминовения усопших.

Год: /memorial/year/{year}

Гимнография

Тропари, кондаки, молитвы, величания и жития по внутренним id.

По id: /hymnography/?id=...&id=...