API de Vimshottari Mahadasha

O endpoint converte a data de nascimento, a hora de relógio e o desvio UTC num dia juliano, depois consulta o Swiss Ephemeris para a longitude geocêntrica da Lua e aplica o ayanamsa de Lahiri para a deslocar do zodíaco tropical para o sideral. Essa longitude sideral fixa o nakshatra natal e a fração já decorrida dentro dele, o que determina quanto resta ao nascimento do período do primeiro planeta regente. A partir daí, dispõe a sequência completa de 120 anos de Vimshottari na ordem canónica — Ketu, Vénus, Sol, Lua, Marte, Rahu, Júpiter, Saturno, Mercúrio — cada Mahadasha carregando o seu período atribuído e datas concretas de início e fim. A resposta devolve também o nakshatra de nascimento, a longitude sideral da Lua e o valor do ayanamsa utilizado, para que a cronologia seja totalmente auditável.

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"
      }
    ]
  }
}

Use este endpoint quando precisar do esqueleto de dasha de nível superior — os macroperíodos que enquadram os capítulos da vida de uma pessoa — em vez do detalhe ao nível do dia. É a primeira chamada natural para uma cronologia preditiva: renderize a sequência de grandes períodos, destaque qual está atualmente ativo para uma dada data e deixe os utilizadores aprofundar a partir daí. Como toda a cadeia decorre de forma determinística de uma só posição da Lua, pode calculá-la uma vez no registo e mantê-la em cache indefinidamente. Quando precisar dos subperíodos aninhados dentro de uma dada Mahadasha, ramifique para os endpoints dedicados antardasha, pratyantar, sookshma e prana sob a mesma família Vimshottari.

Esta rota devolve apenas a camada de Mahadasha (grande período). As subdivisões mais finas — antardasha, pratyantar, sookshma e prana — vivem em endpoints separados sob /v1/vedic/dashas/vimshottari/*. O cálculo segue a tradição de Parashara tal como codificada no Bṛhat Parāśara Horā Śāstra, com o zodíaco sideral e o ayanamsa de Lahiri como estrutura de referência predefinida.