API de interpretação de astrocartografia

O endpoint calcula o conjunto completo de astrocartografia para o momento de nascimento e depois o filtra através de uma taxonomia de dezenove áreas da vida, baseada na literatura fundadora da técnica: Jim Lewis para o significado planeta-ângulo, Erin Sullivan para o que cada um dos quatro ângulos governa, e Martin Davis para o tratamento das linhas difíceis. Cada área nomeia as linhas que lhe pertencem com um peso de um a três, por isso um Sol no Meio-do-Céu tem mais prioridade que um Mercúrio no mesmo ângulo para a carreira. Cada mapeamento também inclui uma polaridade, e as linhas desafiadoras são devolvidas ao lado das linhas de apoio em vez de serem filtradas, porque uma ferramenta de relocação que mostra só linhas favoráveis deturpa a técnica. Quando forneces um ponto, as linhas fora do raio desaparecem e a força devolvida multiplica o peso astrológico pela proximidade geográfica, o que permite classificar cidades-candidata em vez de apenas listar linhas. O texto de interpretação é servido a partir de uma base de conhecimento curada que cobre todas as quarenta combinações planeta-ângulo em onze línguas, com um fallback documentado caso falte uma tradução.

curl -X POST https://api.astroway.info/v1/acg/by-category \
  -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,
  "category": "career",
  "point": { "lat": 51.5074, "lng": -0.1278 },
  "radiusDeg": 8,
  "language": "en"
}'

{
  "ok": true,
  "data": {
    "category": { "id": "career", "name": "Career" },
    "language": "en",
    "count": 3,
    "lines": [
      {
        "planet": "Jupiter",
        "type": "MC",
        "weight": 3,
        "polarity": "supportive",
        "strength": 2.31,
        "distanceDeg": 1.84,
        "pointCount": 341,
        "segments": [
          [[-85, 110.48], [-84.5, 110.48], "…"]
        ],
        "interpretation": {
          "title": "Jupiter - MC",
          "text": "Expansion of professional opportunity…",
          "lang": "en"
        }
      }
    ]
  }
}

Usa-o quando o teu produto responde a uma pergunta em linguagem normal: onde devo ir para trabalhar, qual destas três cidades é melhor para um relacionamento, o que é que esta linha sobre a minha cidade realmente significa. Três formatos cobrem a maioria das implementações. Classificação, enviando uma categoria e um ponto por cidade-candidata e ordenando pela força. Explicação, chamando /v1/acg/line-report para um único planeta e ângulo para obter o texto completo mais todas as outras áreas da vida que a linha toca. Descoberta, obtendo GET /v1/acg/categories uma vez sem créditos e construindo a tua UI a partir da taxonomia devolvida, assim uma nova categoria aparece sem necessidade de lançar o cliente. Como o texto é curado e não gerado, as respostas são determinísticas, não citam modelo e não custam nada extra em inferência: o mesmo pedido devolve as mesmas palavras amanhã.

A taxonomia cobre os dez corpos tradicionais. Quíron, Lilith e os nodos lunares aparecem na geometria /v1/acg mas ficam deliberadamente fora do mapeamento, pois a técnica, como a definiu Jim Lewis, não lhes atribui governação angular de áreas da vida. Pesos e polaridades são juízos editoriais expressos como dados, versionados no repositório e auditáveis, em vez de estarem ocultos dentro de um prompt. O texto de interpretação é uma consulta a uma base de conhecimento, não uma chamada a um modelo de linguagem, por isso é estável, reproduzível offline e livre das advertências que uma interpretação gerada exigiria.