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

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

Запрос

GET /calendar/day/{date}

Параметры:

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

Ответ

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

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

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

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

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

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

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

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

Поле liturgicalRank присутствует всегда. Оно содержит объект с code, group и локализованным согласно lang полем label либо null, если чин не подтверждён. Допустимые коды: great, vigil, polyeleos, doxology, six_stichera, no_sign.

Переходящие специальные записи с 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 в гражданском календаре). Уникальный переходящий ID anna_kashinskaya вычисляется для памяти преподобной Анны Кашинской в воскресенье после 12 июля; отдельное событие Собора святых не добавляется. Фиксированный ID 1372 остаётся первым обретением её мощей 21 июля по юлианскому календарю (3 августа до 2099 года). Эндпоинты контента используют для переходящего ID те же тексты и иконы, но сохраняют anna_kashinskaya в ответе.

Внутри 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": "Исторические события" }],
          "liturgicalRank": null,
          "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));