Календарь на Год

Получение полных данных литургического календаря на весь год.

Запрос

GET /calendar/year/{year}

Параметры:

Параметр	Тип	Где	Описание
`year`	число	путь	Год в формате `YYYY` (напр., `2024`).
`lang`	строка	query	`ru` (по умолчанию) или `en`.
`type`	число	query	Фильтр святых по ID типа.

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

Ответ

Возвращает JSON-объект с метаданными и объектом data, содержащим записи для каждого дня года.

Каждая запись дня включает weekAfterPentecost как всегда присутствующий числовой номер недели цикла по Пятидесятнице. Все id-backed сущности внутри saints[] и events[] содержат icons[] того же формата, что и /calendar/day/{date} и /hymnography.

{
  "meta": {
    "year": 2024,
    "from": "2024-01-01",
    "to": "2024-12-31",
    "count": 366,
    "lang": "ru"
  },
  "data": {
    "2024-01-01": { /* Данные дня */ },
    "2024-01-02": { /* ... */ }
    // ...
  }
}

Пример (JavaScript)

const year = 2024;
fetch(`https://api.ispovednik.org/api/v1/calendar/year/${year}?lang=ru`)
  .then(response => response.json())
  .then(data => console.log(data));