API de dignidades essenciais

Dado um momento e local de nascimento, o endpoint localiza cada planeta por signo e grau e depois pontua-o face às tabelas de dignidades ptolemaicas herdadas da prática medieval e helenística. Verifica as cinco dignidades essenciais por ordem decrescente de força — regência por domicílio, exaltação, regência da triplicidade para a seita do mapa, o termo ou limite em que cai o grau, e a face ou decano — e as duas debilidades essenciais, exílio e queda, onde um planeta se situa oposto à sua regência ou exaltação. Cada planeta recebe os pontos de dignidade convencionais por cada condição que satisfaz, as debilidades subtraem, e os números acumulam-se numa análise por corpo em data.dignities mais um totalScore para todo o mapa. O resultado diz-lhe não só em que signo está um planeta, mas o quão dignificado ou enfraquecido está ali, distinguindo um planeta na sua própria casa de um que está apenas a passar por um signo sobre o qual não tem direito.

curl -X POST https://api.astroway.info/v1/essential-dignities \
  -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": {
    "dignities": [
      {
        "planet": "Venus",
        "rulership": false,
        "exaltation": true,
        "triplicity": true,
        "score": 7
      }
    ],
    "totalScore": 12
  }
}

Recorra a este endpoint sempre que uma interpretação precise de ponderar a força planetária em vez de apenas relatar posições — leitores de mapas tradicionais e helenísticos, auxiliares de horária, pontuação eletiva, ou qualquer ferramenta que classifique quais planetas realmente sustentam um mapa. A pontuação total dá-lhe um escalar rápido para ordenar ou aplicar limiares, enquanto as linhas por planeta permitem explicar o porquê: esta Vénus está exaltada e em triplicidade, aquele Marte está em queda e exílio. Combina-se naturalmente com o endpoint natal-chart — tome de lá as posições de signo e grau e passe os mesmos dados de nascimento aqui para sobrepor a ponderação de dignidade. Como o esquema é baseado em regras e determinístico, a mesma entrada produz sempre as mesmas pontuações, o que o torna fiável para funcionalidades de comparação que classificam um mapa em relação a outro.

A pontuação segue a tabela de dignidades ptolemaica tal como transmitida na astrologia ocidental tradicional e medieval; a regência da triplicidade é atribuída pela seita do mapa (diurna ou noturna). As posições planetárias provêm do motor WASM do Swiss Ephemeris (Astrodienst) no zodíaco tropical, pelo que o signo e o grau em que assentam as dignidades coincidem exatamente com os endpoints natais.