Календарь на День

Получение полных данных литургического календаря на конкретную дату, включая святых, правила поста, переходящие праздники и дни поминовения.

Запрос

GET /calendar/day/{date}

Параметры:

Ограничения: поддерживаются годы 2000–3000.

Ответ

Возвращает JSON-объект, содержащий метаданные и объект данных с ключом запрошенной даты.

Каждая запись дня календаря включает weekAfterPentecost как числовой индекс недели активного цикла по Пятидесятнице. Поле возвращается всегда, всегда положительное и не скрывается во время Великого поста или пасхального периода.

Все id-backed сущности в ответе зеркально содержат icons[]:

• каждый элемент в saints[]
• каждый элемент в events[]

Контракт icons[] совпадает с /hymnography: относительный path, абсолютный url, локализованные title/description и опциональные метаданные.

Для каждого элемента saints[] поля typeId и types описывают каноническую таксономию из CSV-поля type. Некоторые записи из источника также могут содержать опциональные поля презентационной классификации:

• displayTypeId: числовое значение из CSV-поля display_type
• displayTypes: структурированные метки для displayTypeId

Потребители, которым нужно размещение в интерфейсе, например баннерная группировка, могут использовать displayTypeId ?? typeId. Query-параметр type всегда фильтрует по каноническому typeId, а не по displayTypeId.

Переходящие специальные записи с kind: "saint" и kind: "icon_of_mother_of_god" переносятся в saints[]:

• записи saint вставляются в начало saints[]
• записи icon_of_mother_of_god вставляются первыми внутри группы typeId: 17
• для этих записей id строковый (movable ID), поэтому saints[].id может быть number или string
• из events[] такая запись удаляется только если она реально включена в saints[] для текущего фильтра type
• если запись исключена фильтром type, она остаётся в events[] со своим исходным kind (saint / icon_of_mother_of_god)

Примеры таких переходящих записей: abraham_bulgaria_translation_relics_fourth_sunday_pascha и tabitha_joppa_fourth_sunday_pascha на 2026-05-03. Вычисляемые специальные памяти святых обрабатываются так же; например, syrian_desert_fathers_julian_february_23 переносится в saints[] на 23 февраля по юлианскому календарю (2026-03-08 в гражданском календаре).

Внутри fasting опциональное поле allowedFood возвращается только если на этот день есть конкретное разрешение по трапезе. Для fasting.type = NO_FAST API возвращает явное описание отсутствия поста (Поста нет / No fast), чтобы потребители не получали пустое значение. Возможные значения:

• ru: Пища без мяса, Рыба, горяч. пища с раст. маслом, Горяч. пища с раст. маслом, Горяч. пища без раст. масла, Сухоядение. Холод. пища без раст. масла, неподогретое питьё, Воздержание от пищи, разрешается икра
• en: meat-free food, fish, hot food with vegetable oil, hot food with vegetable oil, hot food without vegetable oil, cold food without vegetable oil, unheated drink, abstinence from food, caviar

{
  "meta": {
    "from": "2026-04-25",
    "to": "2026-04-25",
    "count": 1,
    "lang": "ru"
  },
  "data": {
    "2026-04-25": {
      "gregorianDate": "2026-04-25",
      "julianDate": "2026-04-12",
      "dayOfWeek": "Суббота",
      "weekAfterPentecost": 46,
      "saints": [
        {
          "id": 735,
          "name": "Воспоминание перенесения честного пояса Богоматери в Константинополь (942)",
          "typeId": 16,
          "types": [{ "id": 16, "label": "Богородичные праздники" }],
          "displayTypeId": 101,
          "displayTypes": [{ "id": 101, "label": "Исторические события" }],
          "icons": []
        }
      ],
      "fasting": {
        "isFasting": true,
        "type": "NO_FAST",
        "isSolidWeek": false,
        "description": "Поста нет"
      },
      "events": [
        {
          "kind": "week",
          "id": "second_week_after_easter",
          "dateFrom": "2026-04-20",
          "dateTo": "2026-04-25",
          "label": "2-я седмица по Пасхе",
          "icons": []
        }
      ]
    }
  }
}

Пример (JavaScript)

const date = '2026-04-25';
fetch(`https://api.ispovednik.org/api/v1/calendar/day/${date}?lang=ru`)
  .then(response => response.json())
  .then(data => console.log(data));