API — кратко

Простой и предсказуемый JSON API для получения расписаний храмов, подписок и источников. Базовый URL:

https://api.hram.ipd.by/v1
Версия: v1
Формат

JSON

Авторизация

API key / Bearer

Поддержка

docs@ipd.by

Аутентификация

Поддерживается авторизация через Bearer token в заголовке Authorization. Пример:

curl
curl -H "Authorization: Bearer {TOKEN}" "https://api.hram.ipd.by/v1/temples"

Эндпоинты

Основные маршруты:

  • GET /temples — список храмов
  • GET /temples/{id} — информация о храме
  • GET /temples/{id}/events?from=&to= — события прихода
  • POST /sources — отправить источник (для админов)

GET /temples

Возвращает массив храмов. Параметры запроса:

ПараметрТипОписание
qstringПоиск по названию/городу
citystringФильтр по городу
has_todaybooleanТолько храмы с событиями сегодня

Формат ответа

Пример элемента массива храмов:

json
{ 
  "id": 1,
  "name": "Свято-Никольский храм",
  "city": "Брест",
  "addr": "ул. Ленина, 12",
  "events": [
    { "id": 101, "date": "2026-03-15T08:00:00+03:00", "title": "Божественная литургия" }
  ],
  "sources": ["Telegram: @parish_min_2025-09-10"]
}

Примеры запросов

Curl / JS / Python — быстрые примеры.

curl
curl -H "Authorization: Bearer {TOKEN}" "https://api.hram.ipd.by/v1/temples"
js
fetch("https://api.hram.ipd.by/v1/temples", {
  headers: {
    "Authorization": "Bearer {TOKEN}"
  }
})
  .then(res => res.json())
  .then(data => console.log(data));

Коды ошибок

Общие коды ответа:

  • 200 — OK
  • 401 — Unauthorized (проверьте токен)
  • 429 — Too Many Requests (rate limit)
  • 500 — Internal Server Error

Rate limits

По умолчанию 1000 запросов / сутки. Для интеграций — договорной план.

Changelog

2025-09-11 — v1.0.0 — initial public API

Try it — быстрый запрос

Попробуйте сделать запрос к API (бот будет эмулировать ответ при CORS/доступе).

Результат появится здесь...