POST/api/astro/dasha/drill/1 кредит

Детализация даши

Одна ветвь дерева даш вместо всего дерева. levels на других эндпоинтах даш ограничивает ГЛУБИНУ, но всё равно возвращает все периоды на этой глубине: levels=3 для Вимшоттари — это каждая пратьянтардаша в каждой антардаше каждой махадаши, около 95 KB. Экрану, где пользователь нажимает на одну махадашу, чтобы раскрыть её, нужна лишь одна ветвь. Передайте этому эндпоинту цепочку управителей, и он вернёт только то, что вложено в указанный период. {"lords": ["moon", "mars"], "levels": 1} возвращает пратьянтардаши внутри антардаши Марса в махадаше Луны — примерно 1.8 KB против 95 KB всего дерева. Имена управителей сравниваются без учёта регистра, а path в ответе повторяет цепочку, которая фактически совпала. Для накшатра-даш указывайте название планеты, для раши-даш Джаймини — название знака; для нераспознанного управителя возвращается 400 со списком того, что доступно на этом уровне. Это экономит ПЕРЕДАЧУ ДАННЫХ, а не ВЫЧИСЛЕНИЯ. Движок всё равно строит дерево до запрошенной глубины, а этот эндпоинт отбрасывает лишнее, поэтому детализация вычисляется не быстрее равнозначного вызова с levels=. Экономятся трафик, разбор JSON и память, которую браузер или телефон тратит на всё дерево, когда показывает из него одну ветвь.

https://api.occultapi.com/api/astro/dasha/drill/

Попробовать запрос

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

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запроса

Поле	Тип	Обязательно	Примечания
latitude	number (double)	обязательный	Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. min -90 · max 90
longitude	number (double)	обязательный	Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. min -180 · max 180
dasha_direction	string	необязательный	`forwardbackward`
dasha_start	string	необязательный	С какого цикла начинается временная шкала. `currentnextprevious`
date_time	string (date-time)	необязательный	Момент расчёта в формате ISO 8601. ВСЕГДА указывайте смещение или суффикс Z: значение без часового пояса интерпретируется как Asia/Kolkata (UTC+05:30), а не UTC, и может вернуть результат за предыдущий день со статусом 200. '2026-09-01T06:00:00Z' и '2026-09-01 06:00:00' — разные моменты, и ответы для них будут разными.
datetime	string (date-time)	необязательный	Момент расчёта в формате ISO 8601. ВСЕГДА указывайте смещение или суффикс Z: значение без часового пояса интерпретируется как Asia/Kolkata (UTC+05:30), а не UTC. То же, что date_time: другие эндпоинты называют это поле иначе.
days_in_year	number (double)	необязательный	Какой длины год используется для измерения периодов: 360 — классический год савана, 365.25 — юлианский год. min 360 · max 365.256364
levels	integer	необязательный	Сколько уровней НИЖЕ найденного периода вернуть. 1 — только непосредственно вложенные периоды. min 1 · max 4
lords	array	необязательный	Цепочка управителей периодов, по которой нужно пройти сверху, начиная с внешнего, — например, ["moon", "mars"] означает «внутри махадаши Луны, внутри её антардаши Марса». Название планеты для накшатра-даш, название знака для раши-даш. Пустая цепочка возвращает верхний уровень.
node	string	необязательный	Модель лунных узлов. Обязательна для родительского эндпоинта раши, где у неё нет значения по умолчанию; здесь оно задано. `truemean`
system	string	необязательный	Система даш. См. /api/astro/dasha/systems/. По умолчанию — Вимшоттари.
timezone_as_float	number (double)	необязательный	Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение. min -12 · max 14

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

curl -X POST https://api.occultapi.com/api/astro/dasha/drill/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"dasha_direction":"forward","dasha_start":"current","date_time":"2026-09-01 06:00:00","node":"true","timezone_as_float":5.5}'

Ответ

{
  "data": {
    "system": "Vimshottari",
    "engine_id": "VimshottariDasha",
    "family": "nakshatra",
    "lord_type": "planet",
    "levels": 1,
    "level_names": [
      "mahadasha"
    ],
    "cycle_years": 120,
    "conditional": false,
    "path": [],
    "depth": 0,
    "child_level": "mahadasha",
    "periods": [
      {
        "lord": "ketu",
        "start": "2025-11-21 14:30:19.062048+00:00",
        "end": "2032-11-21 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "venus",
        "start": "2032-11-21 08:30:19.062048+00:00",
        "end": "2052-11-21 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "sun",
        "start": "2052-11-21 08:30:19.062048+00:00",
        "end": "2058-11-21 20:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "moon",
        "start": "2058-11-21 20:30:19.062048+00:00",
        "end": "2068-11-21 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "mars",
        "start": "2068-11-21 08:30:19.062048+00:00",
        "end": "2075-11-22 02:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "rahu",
        "start": "2075-11-22 02:30:19.062048+00:00",
        "end": "2093-11-21 14:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "jupiter",
        "start": "2093-11-21 14:30:19.062048+00:00",
        "end": "2109-11-22 14:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "saturn",
        "start": "2109-11-22 14:30:19.062048+00:00",
        "end": "2128-11-22 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "mercury",
        "start": "2128-11-22 08:30:19.062048+00:00",
        "end": "2145-11-22 14:30:19.062048+00:00",
        "children": []
      }
    ],
    "metadata": {
      "calculation_time_ms": 0,
      "max_levels": 1,
      "data_size_bytes": 1171,
      "data_size_mb": 0,
      "structure": "nested_hierarchical"
    },
    "boundary_note": "The last sub-period of each period ends 18 hours before its parent does. Sibling periods are contiguous and the first child starts with its parent, but the final 18 hours of every period have no sub-period covering them. This comes from the calculation engine and is reported rather than hidden."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Записано с реального вызова ровно с этим запросом. Результаты лежат в data.

Ошибки

Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.