Vimshottari Mahadasha API

이 endpoint는 출생 날짜, 시각, UTC 오프셋을 율리우스일로 변환한 뒤, Swiss Ephemeris에 달의 지구중심 황경을 조회하고 Lahiri ayanamsa를 적용해 열대황도에서 항성황도로 변환해. 그 항성황도 황경이 출생 nakshatra와 그 안에서 이미 경과한 비율을 결정하고, 이를 통해 출생 시점에 첫 번째 지배 행성의 기간이 얼마나 남았는지가 정해져. 거기서부터 Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury라는 정규 순서로 전체 120년 Vimshottari 시퀀스를 배열하고, 각 Mahadasha는 할당된 기간과 구체적인 시작·종료 날짜를 담고 있어. 응답에는 출생 nakshatra, 달의 항성황도 황경, 사용된 ayanamsa 값도 함께 반환되므로 타임라인 전체를 검증할 수 있어.

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

{
  "ok": true,
  "data": {
    "system": "vimshottari",
    "level": "maha",
    "ayanamsa": 23.85,
    "moonSiderealLongitude": 258.97,
    "nakshatra": "Purva Ashadha",
    "periods": [
      {
        "lord": "Venus",
        "start": "1986-02-11",
        "end": "2006-02-11"
      },
      {
        "lord": "Sun",
        "start": "2006-02-11",
        "end": "2012-02-11"
      }
    ]
  }
}

일 단위 세부 정보가 아니라 인생의 장을 구성하는 거시적 기간, 즉 최상위 dasha 골격이 필요할 때 이 endpoint를 사용해. 예측 타임라인의 첫 호출로 자연스러워: 주요 기간의 시퀀스를 렌더링하고, 특정 날짜에 현재 활성화된 기간을 하이라이트한 뒤, 사용자가 거기서 더 깊이 들어가게 하면 돼. 전체 체인이 하나의 달 위치에서 결정론적으로 도출되므로, 가입 시점에 한 번만 계산해서 무기한 캐시할 수 있어. 특정 Mahadasha 안의 중첩된 하위 기간이 필요하면 같은 Vimshottari 패밀리 아래의 전용 antardasha, pratyantar, sookshma, prana endpoint로 분기하면 돼.

이 route는 Mahadasha(주요 기간) 레이어만 반환해. 더 세밀한 하위 구분인 antardasha, pratyantar, sookshma, prana는 /v1/vedic/dashas/vimshottari/* 아래의 별도 endpoint에 있어. 계산은 Bṛhat Parāśara Horā Śāstra에 체계화된 Parashara 전통을 따르며, 항성황도와 Lahiri ayanamsa를 기본 기준 프레임으로 사용해.