API로 만나는 베다 점성술: 파라샤라부터 랄 키탑까지 354개 엔드포인트

베다 점성술(Jyotish)은 세계에서 가장 오래 끊기지 않고 이어져 온 점성술 전통입니다. 그 정형화된 기법(BPHS, 자이미니 수트라, 랄 키탑, KP)은 인도에서 매일 쓰입니다: 결혼 중매, 날짜 택일, 운명에 대한 선제적 진단. 하지만 양질의 계산에 프로그래밍으로 접근하는 일은 최근까지 고통스러웠습니다.

AstroWay v2.19가 이 문제를 해결합니다: 354개 이상의 베다 엔드포인트를 PyJHora(Python 레퍼런스 구현)와 교차 검증했고, 차이가 나는 부분은 문서화했습니다.

두 조디악 모두 같은 행성 위치(Swiss Ephemeris)에서 계산되지만, 개념적으로는 다릅니다:

베다는 서양 점성술의 “대안”이 아닙니다. 고유한 내적 논리 체계를 가진 별개의 시스템입니다. 여러 전통을 다루는 앱(모바일 운세, 중매 서비스, daily horoscope)을 만드는 통합 개발자는 둘 다 원하는 경우가 많고, 서드파티 API 두 개 대신 API 하나로 해결하면 비용이 크게 줄어듭니다.

경쟁사 대부분은 Vimshottari(120년 주기, 가장 대중적)만 제공합니다. AstroWay가 다루는 범위:

1. Vimshottari (120년): BPHS 표준, 전 과정 지원
2. Yogini (36년): 더 빠른 예측, 8개 행성
3. Ashtottari (108년): Ardradi 전통, 팍샤 권장
4. Kalachakra (별자리가 MD 로드): 가장 복잡한 체계, paramayu가 차트마다 다름
5. Chara (자이미니 movable): 별자리 기반 예측용
6. Tribhagi (54 = Vimshottari/2 + 추가): 가속된 Vimshottari
7. Shatabdika (100년): 출처별 계산 방식이 다양함
8. Shodashottari (116년): 팍샤가 섞인 차트용
9. Sthira (드문 고정 기간 다샤)
10. Shoola (cross-rasi 방식)

각 체계는 5단계를 지원합니다: Maha → Antar → Pratyantar → Sookshma → Prana.

분할 차트는 같은 출생 차트를 서로 다른 배율로 보는 재귀적 관점입니다. D9(Navamsha)는 결혼에 가장 중요합니다. D10(Dashamsha)은 커리어. D60(Shashtyamsha)은 가장 미세한 수준입니다.

/v1/vedic/vargas를 한 번 호출하면 16개 분할을 한꺼번에 반환하므로, 통합 개발자가 요청을 16번 따로 보낼 필요가 없습니다.

5가지 요소 + 보조 요소:

• Tithi (음력일, 달 주기를 30으로 나눈 것)
• Karana (티티의 절반, 11가지 유형)
• Yoga (day-yoga, 27가지 유형, 태양 + 달 황경의 합에 기반)
• Nakshatra (27개 달의 궁(맨션) 중 하나)
• Choghadia (낮과 밤을 각각 8개 길흉 블록으로 나눔, 블록당 약 1시간 30분)
• Hora (행성 시간)
• Rahu-kaal (매일 찾아오는 1.5시간의 불길한 시간대)

/v1/vedic/panchang/full을 호출하면 특정 날짜/장소에 대한 8개 요소를 모두 하나의 JSON으로 받을 수 있습니다.

베다에서 요가는 눈에 띄는 삶의 패턴을 만드는 특별한 행성 조합입니다. 파라샤라(BPHS)는 수백 가지를 기술하며, AstroWay는 가장 많이 인용되는 것들을 구현합니다:

• 라자: 권력/인정의 조합
• 다나: 부
• 다르마-카르마디파티: 직업적 경로
• 판차 마하푸루샤: 루차카/바드라/함사/말라비야/샤샤 (5개 행성이 자기 별자리에서 kendra 하우스에 위치)
• 가자케사리: kendra에 있는 달 + 목성
• 아디: 달로부터 6/7/8번째에 있는 수성/금성/목성

여기에 자이미니 고유 요가가 더해집니다: karaka-yoga (중요한 하우스에 있는 8개 차라 카라카), karakamsa (D9의 AK로부터 12하우스 투영), shubha-graha (BPHS Adhyaya 34 기준 기능적 길성).

도샤는 삶의 특정 영역을 어렵게 만드는 **행성의 흉작용(affliction)**입니다. AstroWay는 세 학파를 다룹니다:

• 파라샤라: Mangal Dosha (화성), Kaal Sarp (Rahu와 Ketu 사이의 행성), Pitru (조상의 karma), Shrapit, Grahan, Guru-Chandal
• 랄 키탑: Manglik (랄 키탑 고유의 해석), 그 밖에 이 학파만의 도샤
• KP (Krishnamurti Paddhati): sub-lord 기반 진단

중매 서비스가 인도 여러 지역의 고객을 상대한다면(Punjab은 LK를 자주 쓰고, Tamil Nadu는 KP, 모두가 파라샤라를 씀) API 세 개 대신 하나로 충분합니다.

전통적인 인도식 매칭 절차:

1. Ashtakoot (Guna Milan): 8가지 항목, 최대 36점. 18점 미만이면 궁합이 낮음. 북인도/중인도에서 가장 널리 쓰임.
2. Dashakoota: 10가지 항목, 남인도 변형.
3. Manglik 확인: 화성 흉작용이 있는 출생 차트에 결정적.
4. Mangal match: 화성-화성을 상쇄.
5. Bhrigu match: Bhrigu Samhita 기반의 예측 오버레이.

모두 /v1/vedic/compatibility/full 한 번의 호출로, 완전한 궁합 보고서를 받습니다.

“무후르타”는 어떤 일을 시작하기에 길한 시점입니다. 대표적인 행사:

• Marriage muhurta (결혼식)
• Vehicle purchase (자동차 구매)
• Business start (사업 개시)
• Travel (여행)
• Naming ceremony (Namakaran: 아기 이름 짓기)
• 수술, 학업 시작, 투자, 부동산 구매, griha-pravesh (집들이), 약혼, 소송

/v1/vedic/muhurat/{event}는 지정한 range 안에서 가장 길한 날짜 상위 3개를 반환합니다.

Lahiri가 기본값입니다(Chitra-Paksha, 인도 정부 공식 표준). ayanamsa 파라미터로 바꿀 수 있습니다:

• raman: B.V. Raman 전통 (KP에서 인기)
• krishnamurti: KP 전용
• yukteshwar: Sri Yukteshwar (Spica로부터의 거리)
• fagan-bradley: Fagan/Bradley (서양 sidereal)
• de-luce: De Luce
• jn-bhasin: JN Bhasin

각각 오프셋이 다릅니다(보통 23.5–24.0°). 같은 고객이라도 행성이 놓이는 별자리가 달라질 수 있으므로, 앱 아키텍처 단계에서 미리 알아 두는 것이 중요합니다.

모든 엔드포인트에는 다음이 있습니다:

• docs/AUDIT-TRAIL.md의 Status (GREEN/YELLOW)
• 출처를 명시한 소스 코드 내 inline AUDIT 헤더 (BPHS Adhyaya N, Jaimini Sutras X.Y, PyJHora reference function)
• 회귀 방지용 snapshot-test fixture

PyJHora와의 차이(있는 경우 대부분 랄 키탑처럼 저자가 한 명뿐인 기법)는 AUDIT-TRAIL에 문서화되어 있어서, 통합 개발자는 통합 전에 정확한 delta를 확인할 수 있습니다.

# Natal Vedic chart
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-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

현재 Maha-dasha 로드, MD 종료일, 이어지는 다샤의 sequence를 반환합니다. /maha → /antar → /pratyantar → … 순으로 5단계까지 내려갈 수 있습니다.

베다 보고서(PDF)는 hi, ko, ja, id, tr, vi를 포함한 20개 언어로 제공됩니다. 모두 베다 콘텐츠에 대한 실제 수요가 있는 시장입니다. 어떤 /v1/reports/* 엔드포인트든 lang=<code>를 전달하세요. 자세한 내용은 /languages/를 참고하세요.

베다 엔드포인트는 계산 내용에 따라 10, 20 또는 50 크레딧입니다: 랄 키탑과 KP는 10, 바르가와 판창 요소는 20, 파라샤라 도샤, 다샤, 샤드발라, 무후르타는 50. 무료 요금제(10 000 크레딧)에서는 월 200~1000회의 베다 호출에 해당합니다. Vedic Kundli / Lal Kitab PDF 보고서는 5000입니다.

• 베다 엔드포인트 카테고리: 8개 그룹 탐색
• Vedic API 소개: 4개 언어 코드 예제를 포함한 전체 개요
• 빠른 시작: 5분 안에 첫 요청
• 요금제: 무료부터 Enterprise까지