API de Shadbala

A partir da data de nascimento, hora, desvio UTC e local, o endpoint deriva o mapa sideral via Swiss Ephemeris sob o ayanamsa de Lahiri, depois calcula os seis componentes de força para cada um dos grahas clássicos. A Sthana bala mede a força posicional a partir da colocação no signo e divisional; a Dig bala mede a força direcional pela distância do planeta ao seu ângulo ideal; a Kala bala mede a força temporal a partir da hora de nascimento; a Cheshta bala mede a força de movimento a partir da velocidade aparente do planeta e do estado retrógrado; a Naisargika bala é a força natural fixa que cada planeta carrega; e a Drik bala mede a força aspetual líquida dos aspetos que recebe. Estas seis são somadas na Shadbala total, e a resposta devolve os valores por planeta em data.items, cada um acompanhado pela sua unidade para que as pontuações em rupa sejam inequívocas.

curl -X POST https://api.astroway.info/v1/vedic/shadbala/full \
  -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": {
    "type": "shadbala",
    "unit": "rupa",
    "items": [
      {
        "planet": "Sun",
        "total": 6.42,
        "components": {
          "sthana": 1.1,
          "dig": 0.9,
          "kala": 1.5,
          "cheshta": 0.8,
          "naisargika": 1,
          "drik": 1.1
        }
      }
    ]
  }
}

Use este endpoint sempre que uma funcionalidade precise de ponderar um planeta face a outro em vez de apenas o localizar — avaliação de yogas, escolher o planeta mais forte para realçar numa leitura, ou julgar se um senhor de dasha é suficientemente forte para cumprir os temas do seu período. Combina-se naturalmente com os endpoints de dasha e de varga: extraia o planeta regente do período ativo e depois pergunte à Shadbala o quão capaz esse planeta realmente é. Como os seis componentes são calculados em conjunto numa só chamada, obtém a análise completa de força sem juntar consultas posicionais, direcionais e temporais separadas.

A resposta relata a força em rupas (a unidade clássica, em que um rupa equivale a sessenta unidades de shashtiamsha) e rotula cada valor com a sua unidade. O cálculo segue o método padrão de Graha-bala da tradição de Parashara tal como exposto no Bṛhat Parāśara Horā Śāstra, avaliado sobre o mapa sideral com o ayanamsa de Lahiri. Todas as seis balas — Sthana, Dig, Kala, Cheshta, Naisargika e Drik — são devolvidas somadas no total por planeta.