SUTRA API v1

API для разработчиков

REST API на основе Swiss Ephemeris (NASA JPL DE441). 100+ эндпоинтов: ведическая астрология, западная астрология, Human Design. Точность расчётов — до угловой секунды.

Тарифы Эндпоинты

Быстрый старт

Все запросы отправляются на https://sutra.center/api/v1/. Для POST-эндпоинтов тело запроса — JSON. Ответ — JSON с полем "success": true.

Пример: расчёт натальной карты

curl -X POST https://sutra.center/api/v1/free/calculate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "date": "1990-06-15",
    "time": "14:30",
    "city": "москва",
    "lat": 55.7558,
    "lon": 37.6173,
    "tz": "Europe/Moscow"
  }'

Ответ

{
  "success": true,
  "planets": {
    "Sun": {
      "sign_id": 3,
      "sign": "Gemini",
      "degree": 0.87,
      "nakshatra": "Mrigashira",
      "pada": 3,
      "is_retrograde": false,
      "longitude": 60.87
    },
    "Moon": { ... },
    "Mars": { ... },
    "Mercury": { ... },
    "Jupiter": { ... },
    "Venus": { ... },
    "Saturn": { ... },
    "Rahu": { ... },
    "Ketu": { ... }
  },
  "lagna_sign": 7,
  "lagna_degree": 12.45,
  "ayanamsha": 23.7285
}

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

Для B2B-доступа необходим API-ключ. Передавайте его в заголовке:

Authorization: Bearer YOUR_API_KEY

Получить API-ключ можно на тарифе B2B (от 2000 руб/мес). Для оформления: страница тарифов или напишите на api@sutra.center.

Форматы данных

Дата рождения (POST)

Стандартная схема для большинства POST-эндпоинтов:

{
  "date": "1990-06-15",    // YYYY-MM-DD
  "time": "14:30",          // HH:MM (24h)
  "city": "москва",         // Название города (RU/EN)
  "lat": 55.7558,           // Широта (опц.)
  "lon": 37.6173,           // Долгота (опц.)
  "tz": "Europe/Moscow"     // IANA timezone (опц.)
}

Если указаны lat и lon — город игнорируется. Если указан tz — используется для коррекции исторических смещений (СССР).

Совместимость (POST)

Два набора данных рождения:

{
  "person1": {
    "date": "1990-06-15",
    "time": "14:30",
    "city": "москва"
  },
  "person2": {
    "date": "1992-03-22",
    "time": "09:15",
    "city": "санкт-петербург"
  }
}

Панчанг / Транзиты (GET)

Параметры в query string:

GET /api/v1/free/panchang
    ?date=2026-03-15
    &city=moscow
    &lat=55.7558
    &lon=37.6173

Без параметра date — расчёт на сегодня. Без координат — Москва по умолчанию.

Мухурта (POST)

Расширенная схема с параметрами рождения:

{
  "date": "2026-04-10",
  "time": "12:00",
  "city": "москва",
  "activity": "marriage",
  "birth_date": "1990-06-15",
  "birth_time": "14:30",
  "birth_city": "москва"
}

Поле activity: marriage, travel, business, medical, education, general.

Эндпоинты

106 эндпоинтов сгруппированы по категориям. Метод GET — query-параметры. POST — JSON-тело. PRO — требуется подписка.

Натальная карта

Расчёт позиций планет, лагны, аянамши. Основа для всех дальнейших анализов.

Метод	Путь	Описание
POST	/api/v1/free/calculate	Базовый расчёт натальной карты: 9 планет, лагна, аянамша
POST	/api/v1/free/navamsha	Навамша (D9) и варги — дробные карты
POST	/api/v1/free/ashtakavarga	Аштакаварга — SAV и BAV баллы по знакам
POST	/api/v1/free/shadbala	Шадбала — 6 источников силы каждой планеты
POST	/api/v1/free/avasthas	Авастхи планет: Baladi, Jagradadi, Diptadi
POST	/api/v1/free/bhava-bala	Бхава Бала — сила 12 домов гороскопа

Даша-системы

Периодизация жизни по различным даша-системам Джйотиш.

Метод	Путь	Описание
POST	/api/v1/free/dasha-calc	Вимшоттари Даша — основная 120-летняя система периодов
POST	/api/v1/free/yogini-dasha	Йогини Даша — 36-летний цикл, 8 периодов
POST	/api/v1/free/ashtottari-dasha	Аштоттари Даша — 108-летняя система
POST	/api/v1/free/narayana-dasha	Нараяна Даша — знаковая система Джаймини

Анализ карты

Углублённый анализ: йоги, караки, карма, здоровье, карьера.

Метод	Путь	Описание
POST	/api/v1/analysis/yogas	Детекция йог (Раджа, Дхана, Випарита и др.)
POST	/api/v1/free/atmakaraka	Атмакарака и 8 Чара Карак (система Джаймини)
POST	/api/v1/free/jaimini	Джаймини: Чара Караки, Арудха Пады, Каракамша, Аргала
POST	/api/v1/free/kp-analysis	KP-система: Star/Sub Lords, куспиды, сигнификаторы
POST	/api/v1/free/bhrigu-bindu	Бхригу Бинду — точка судьбы (Раху-Луна midpoint)

Совместимость

Анализ совместимости двух карт по ведическим методам.

Метод	Путь	Описание
POST	/api/v1/free/compatibility	Аштакут совместимость — 36 гун, 8 параметров
POST	/api/v1/free/marriage	Анализ брака: 7-й дом, Мангал Доша, таймлайн
POST	/api/v1/free/mangal-dosha	Мангал Доша (Куджа Доша) — детальный анализ

Сферы жизни

Специализированные расчёты по конкретным сферам жизни.

Метод	Путь	Описание
POST	/api/v1/free/karma	Карма: D60, Раху-Кету ось, кармические долги
POST	/api/v1/free/career	Карьера: 10-й дом, Дхана Йоги, профессии
POST	/api/v1/free/health	Здоровье: Tridosha, Kalapurusha, уязвимые области
POST	/api/v1/free/children	Дети: 5-й дом, Юпитер, потенциал
POST	/api/v1/free/remedies	Упайи: мантры, камни, ритуалы, практики коррекции
POST	/api/v1/free/sade-sati	Саде Сати — 7.5-летний транзит Сатурна
POST	/api/v1/free/kalasarpa-calc	Кала Сарпа Йога — замкнутость планет

Панчанг и транзиты

Ежедневные расчёты: ведический календарь, текущие позиции планет.

Метод	Путь	Описание
GET	/api/v1/free/panchang	Панчанг: титхи, накшатра, йога, карана, вара
GET	/api/v1/free/gochara	Гочара — текущие позиции 9 планет (знак, градус, накшатра, ℞)
POST	/api/v1/free/varshaphal-calc	Варшапхал (соляр): Варша Лагна, Мунтха, Таджика Йоги

Мухурта

Выбор благоприятного времени для важных дел.

Метод	Путь	Описание
POST	/api/v1/free/muhurta	Мухурта: анализ благоприятности, Раху Каал, активности
POST	/api/v1/free/muhurta-calendar	Календарь мухурт на период (лучшие окна)
POST	/api/v1/free/ghatak	Гхатак Чакра — опасные дни и комбинации

Космическая погода

Реалтайм-данные о космической обстановке.

Метод	Путь	Описание
GET	/api/v1/cosmic/weather	Космическая погода: сводка дня, планетарные часы
GET	/api/v1/cosmic/voc	Void of Course Moon — календарь на N дней
GET	/api/v1/cosmic/hours	Планетарные часы дня для координат
GET	/api/v1/cosmic/energy	Энергетический индекс дня (составной балл)

Западная астрология

Тропический зодиак, прогрессии, соляры, синастрия.

Метод	Путь	Описание
POST	/api/v1/western/solar-returnPRO	Солярный возврат — прогноз на год
POST	/api/v1/western/lunar-returnPRO	Лунный возврат — прогноз на месяц
POST	/api/v1/western/transitsPRO	Западные транзиты (тропические)
POST	/api/v1/western/progressionsPRO	Вторичные прогрессии
POST	/api/v1/western/directionsPRO	Дирекции (солнечной дуги)
POST	/api/v1/free/western-synastry	Западная синастрия — аспекты между картами

Human Design

Бодиграф, типы, профили, центры, каналы, ворота.

Метод	Путь	Описание
POST	/api/v1/free/human-design	Полный бодиграф: тип, авторитет, профиль, 9 центров, 36 каналов, 64 ворот
POST	/api/v1/free/human-design/summary	Краткая сводка: тип, профиль, авторитет

Ретрограды

Даты ретроградных периодов планет.

Метод	Путь	Описание
GET	/api/v1/retrogrades/{year}	Все ретрограды за год
GET	/api/v1/retrogrades/current	Текущие ретроградные планеты
GET	/api/v1/retrogrades/mercury/{year}	Ретрограды Меркурия за год (самый частый запрос)

Служебные

Статус сервера, поиск городов.

Метод	Путь	Описание
GET	/api/v1/status	Статус сервера и загруженных модулей
GET	/api/v1/cities/search	Поиск города по имени (300+ городов, исторические алиасы)

Лимиты и тарифы

Тариф	Запросов / мес	Доступ	Цена
Simple	100	Базовые эндпоинты (calculate, panchang, gochara)	Бесплатно
Seeker	1 000	Все Джйотиш-эндпоинты	500 руб/мес
Jyotishi	5 000	Все системы + Western + HD	2 000 руб/мес
B2B	10 000+	Все эндпоинты, приоритетная поддержка, SLA	По договору

Rate limit: 10 запросов/сек для всех тарифов. При превышении — 429 Too Many Requests. B2B-клиентам доступно увеличение лимита по запросу.

Коды ошибок

Код	Описание
200	Успешный запрос
400	Некорректные параметры (неверный формат даты, город не найден)
401	Отсутствует или невалидный API-ключ
403	Эндпоинт недоступен на вашем тарифе
429	Превышен лимит запросов
500	Внутренняя ошибка (модуль не загружен или ошибка расчёта)

При ошибке тело ответа содержит поле detail с описанием проблемы на русском языке.

Технические детали

ЭфемеридыSwiss Ephemeris (NASA JPL DE441)

АянамшаLahiri (Chitrapaksha), настраиваемая

Система домовШрипати (по умолчанию), Плацид, Кампанус, Равные

Города300+ городов, исторические алиасы (Ленинград, Свердловск)

TimezoneIANA + коррекция СССР (1970-1991)

Формат ответаJSON, UTF-8

Timeout30 секунд на запрос

Доступность99.9% SLA (B2B тариф)

Готовы интегрировать?

Напишите нам для получения API-ключа и персональной консультации по интеграции. Мы поможем подобрать оптимальный тариф под ваши задачи.

api@sutra.center Тарифы