Публичный REST API православного Типикона и календаря — тон Октоиха, уровень поста, святые дня, богослужебные чтения. Расчёт ведёт независимый TypeScript-движок (один из трёх взаимно сверяемых свидетелей внутри самого сайта), по Александрийской пасхалии на юлианском календаре — так, как принято в Русской Православной Церкви.
Эндпоинты
GET/api/v1/date/{YYYY-MM-DD}
Полная композиция службы на дату: тон, пост, святые, чтения.
| Параметр | Обязательный | Описание |
|---|---|---|
calendar | нет | gregorian (по умолчанию) или julian (церковный стиль) |
lang | нет | языки через запятую, напр. en,ru; без параметра — по заголовку Accept-Language, иначе en |
curl "https://typikon.site/api/v1/date/2026-04-12?lang=en,ru"
GET/api/v1/calendar/{YYYY-MM}
Календарная сетка на месяц (григорианский) — тон и святые по дням.
curl "https://typikon.site/api/v1/calendar/2026-04"
GET/api/v1/openapi.yaml
Сама эта спецификация, в формате OpenAPI 3.0 YAML.
Общее
| Формат | JSON (application/json) |
| Лимит | 60 запросов/мин/IP → 429 + Retry-After |
| CORS | открыт для любого источника (/api/v1 — публичный, без cookies/авторизации) |
| Ошибки | {"error": {"message": "...", "field?": "..."}} |
Внутренний, неверсионированный API сайта (/api/service и т.д.) описан отдельно
в docs/API_CLIENT.md
— он может меняться без сохранения обратной совместимости; /api/v1 — стабильный
публичный контракт.