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. Детальніше — у довіднику помилок.