Даші (періоди планет)

Даші - це періоди керування планет у ведичній астрології. Кожна планета «править» окремим відрізком життя людини, і саме чергування цих періодів пояснює таймінг подій. AstroWay рахує 10 систем дашів × 5 рівнів вкладеності = 50 ендпоінтів в одному API.

Що ми рахуємо

• Vimshottari: основна система (120-річний цикл, прив’язана до Місячного накшатри при народженні). Використовується ~95% сучасних джйотиш-практиків.
• Yogini: 36-річний цикл, 8 богинь-керівниць (Mangala, Pingala, Dhanya, Bhramari, Bhadrika, Ulka, Siddha, Sankata).
• Ashtottari: 108-річний цикл, прив’язаний до Сонця.
• Kalachakra: циклічна даша, базується на накшатрі, не лінійна.
• Chara: рашi-даша (правлять знаки, не планети), система Jaimini.
• Tribhagi: варіант Vimshottari з потрьоєним темпом.
• Shatabdika: 100-річний цикл (рідкісна, для довгожителів).
• Shodashottari: 116-річний цикл, прив’язаний до Tithi.
• Sthira: фіксована rasi-даша (Jaimini).
• Shoola: rasi-даша з нерівними періодами (Jaimini).

Усередині кожної системи - 5 рівнів деталізації: Maha (головний період) → Antar (під-період) → Pratyantar (під-під) → Sookshma (мікро) → Prana (наносекундний).

Ключові ендпоінти

Ендпоінт	Кредити	Призначення
/v1/vedic/dashas/vimshottari/maha	20	Vimshottari maha-даші на 120 років
/v1/vedic/dashas/vimshottari/antar	20	Antar-даші всередині поточного maha
/v1/vedic/dashas/vimshottari/pratyantar	20	Pratyantar (3-й рівень вкладеності)
/v1/vedic/dashas/vimshottari/sookshma	20	Sookshma (4-й рівень)
/v1/vedic/dashas/vimshottari/prana	20	Prana (найдрібніший, добові інтервали)
/v1/vedic/dashas/yogini/maha	20	Yogini 36-річний цикл
/v1/vedic/dashas/ashtottari/maha	20	Ashtottari 108-річний цикл
/v1/vedic/dashas/kalachakra/maha	20	Циклічна Kalachakra
/v1/vedic/dashas/chara/maha	20	Chara rasi-даша (Jaimini)
/v1/vedic/dashas/shodashottari/maha	20	Shodashottari 116-річний цикл

Повний список усіх 50 ендпоінтів - у OpenAPI (теги Vedic / Dashas).

Приклад

cURL

curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52,
    "ayanamsa": "lahiri"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/vedic/dashas/vimshottari/maha', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.45,
    longitude: 30.52,
    ayanamsa: 'lahiri',
  }),
});
const { data } = await r.json();
// startDate/endDate are 'YYYY-MM-DD HH:MM' in the birth timezone, so they compare as text
const now = new Date().toISOString().slice(0, 16).replace('T', ' ');
const current = data.periods.find((p) => p.startDate <= now && now < p.endDate);
console.log(`Current maha: ${current.planetName} until ${current.endDate}`);

Python

import os, requests
from datetime import datetime

r = requests.post(
    'https://api.astroway.info/v1/vedic/dashas/vimshottari/maha',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '1990-07-14', 'time': '14:30:00', 'timezoneOffset': 3,
        'latitude': 50.45, 'longitude': 30.52, 'ayanamsa': 'lahiri',
    },
)
data = r.json()['data']
now = datetime.now().strftime('%Y-%m-%d %H:%M')
current = next(p for p in data['periods'] if p['startDate'] <= now < p['endDate'])
print(f"Current: {current['planetName']} until {current['endDate']}")

Приклад відповіді

{
  "system": "Vimshottari",
  "level": "maha",
  "ayanamsa": 23.724844,
  "moonSiderealLongitude": 345.332629,
  "nakshatra": {
    "number": 26,
    "name": "Uttara Bhadrapada",
    "ruler": "Saturn",
    "startDeg": 333.3333,
    "endDeg": 346.6667,
    "pada": 4
  },
  "initial": {
    "initialPlanet": 6,
    "initialPlanetName": "Saturn",
    "nakshatra": 26,
    "nakshatraName": "Uttara Bhadrapada",
    "pada": 4,
    "balanceYears": 1,
    "balanceMonths": 10,
    "balanceDays": 25,
    "elapsedYears": 17.098996
  },
  "periods": [
    { "planet": 6, "planetName": "Saturn", "startDate": "1990-07-14 14:29", "endDate": "1992-06-07 22:42", "durationYears": 1.901004 },
    { "planet": 2, "planetName": "Mercury", "startDate": "1992-06-07 22:42", "endDate": "2009-06-08 04:42", "durationYears": 17 },
    { "planet": 100, "planetName": "Ketu", "startDate": "2009-06-08 04:42", "endDate": "2016-06-07 22:42", "durationYears": 7 }
  ]
}

Точність і джерела

• Канонічний текст: Brihat Parashara Hora Shastra (BPHS), розділи 46–52 - кожна система дашів описана окремо.
• Reference implementation: PyJHora (Apache 2.0) - наш кросс-чек для всіх 10 систем. Алгоритми для Vimshottari/Yogini/Ashtottari/Kalachakra повністю збігаються з PyJHora; для Sthira/Shoola є мінімальний дрейф у часі переходів через відмінності в Jaimini sign-strength helpers.
• Ayanamsa: підтримуються lahiri (за замовчуванням, MoSh/IISc), raman, krishnamurti, fagan-bradley, yukteshwar, sassanian, j2000, aldebaran, galactic-center. Lahiri є офіційним стандартом Indian Ephemeris.
• Tropical fallback: усі даші використовують сидеричні координати: якщо ваш ключ передає tropical: true, ми внутрішньо застосовуємо ayanamsa-зсув.
• Audit: окремий запис в /accuracy/ для кожної системи дашів, з датою last-fix і дрейфом vs reference.

Chú ý

Jaimini-даші vs Parashara-даші. Chara/Sthira/Shoola належать до школи Джайміні - алгоритми принципово відрізняються від Парашари (правлять знаки, не планети). Якщо ви робите класичну джйотиш-програму - використовуйте Vimshottari як основну; інші системи беріть як додаткові огляди.

Пов’язане

• Панчанг: добові ведичні параметри (tithi, karana, yoga, nakshatra)
• Shadbala: шестикратна сила планет у момент розрахунку даші
• Варги: divisional charts D1–D60 (Navamsha критична для оцінки сили правителя даші)
• Точність: лінідж, snapshot-тести, кросс-чек з swetest + PyJHora
• Кредити: повна таблиця тарифів по всіх 50 dasha-ендпоінтах
• Автентифікація: як отримати aw_live_* ключ