Эндпоинт акафистов
Получение акафистов святого по внутреннему id. Каждый акафист — последовательность пронумерованных кондаков и икосов с необязательными заключительными молитвами.
Запрос
GET /akathists/?id=442
GET /akathists/?id=442&lang=cu&number=2
Параметры:
| Параметр | Тип | В | Описание |
|---|---|---|---|
id |
string | query | Внутренний id святого (обычно один). Пример: ?id=442. |
lang |
string | query | ru (по умолчанию), cu или en. Неизвестные значения трактуются как ru. |
number |
integer | query | Необязательный. Выбирает конкретный акафист по внутреннему номеру. |
Валидация:
- длина id:
1..128, шаблон^[A-Za-z0-9_][A-Za-z0-9._:-]{0,127}$; number(если задан) — одно положительное целое;0, отрицательные, дробные, нечисловые или повторяющиеся значения дают400.
Ответ
В data возвращается упорядоченный массив.
found=true: акафисты для этого id.found=false: пустойakathists+ объектnotFound(id неизвестен, нет данных для языка или запрошенныйnumberне найден).
{
"meta": {
"lang": "ru",
"format": "html",
"requestedIds": ["442"],
"count": 1
},
"data": [
{
"id": "442",
"found": true,
"akathists": [
{
"number": 1,
"title": "Акафист преподобному Амвросию Оптинскому",
"sections": [
{ "type": "kondak", "number": 1, "html": "<p>...</p>" },
{ "type": "ikos", "number": 1, "html": "<p>...</p>" }
],
"repeatEnding": true,
"prayers": [
{ "html": "<p>...</p>" }
]
}
]
}
]
}
Примечания
number— стабильный селектор в пределах святого: у святого может быть несколько акафистов, каждый со своим уникальнымnumber.?number=Nвыбирает конкретный; без него — все.sections[]содержит тело в печатном порядке: стандартный акафист — 13 кондаков + 12 икосов с чередованием, начиная с кондака 1.sections[].number— номер части.repeatEnding: trueозначает, что после кондака 13 в конце дословно повторяются икос 1 и кондак 1. В данных они не дублируются — клиент сам вставляет их изsections.prayers[](необязательно) — одна или более заключительных молитв, каждая с санитизированнымhtmlи необязательным простымtitle.- Поля
html— санитизированный HTML с разрешёнными тегами:p,br,h2,h3,ul,ol,li,strong,emи безопасные внутренние сноски черезa. - Языки:
ruиcuвсегда доступны;enопционален и пока может быть пуст —lang=enвозвращаетfound=false, пока английские тексты не добавлены.