AstroWay/api v2.95.1 · pt
todos os sistemas normais
// astrology api · POST /v1/synastry

API de sinastria

Compare dois mapas natais numa só chamada e obtenha a grelha de aspetos cruzados que move toda a funcionalidade de compatibilidade — quem aspeta quem, com que ângulo, com que orbe, em que direção. Dois mapas à entrada, a relação entre eles à saída.

Endpoint
POST /v1/synastry
Custo
50 créditos
Latência
~250 ms
Nível
Tier 3
// 01 / O que calcula

API de sinastria

O endpoint synastry calcula ambos os mapas natais de forma independente e depois sobrepõe-nos para encontrar aspetos entre mapas: toda a relação angular em que um planeta do mapa A encontra um planeta do mapa B dentro do orbe. Cada aspeto cruzado é devolvido com ambos os corpos nomeados, o tipo de aspeto (conjunção, sextil, quadratura, trígono, oposição e os ângulos menores), o orbe exato e a direção do contacto, para que saiba a Vénus de quem está em trígono com o Marte de quem. Os conjuntos completos de planetas de ambos os sujeitos vêm em paralelo, para que possa renderizar um mapa bi-roda ou alimentar um avaliador de compatibilidade sem uma segunda ida e volta.

// 02 / Pedido ao vivo

POST/v1/synastry

curl -X POST https://api.astroway.info/v1/synastry \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "chart1": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
    "chart2": { "date": "1985-11-03", "time": "08:15:00", "timezoneOffset": 2, "latitude": 48.46, "longitude": 35.04 }
  }'
Resposta (excerto)
{
  "ok": true,
  "data": {
    "crossAspects": [
      { "planet1": "Venus", "planet2": "Mars", "type": "trine", "orb": 0.8, "direction": "A→B" }
    ],
    "chart1": { "input": { ... }, "planets": [ ... ] },
    "chart2": { "input": { ... }, "planets": [ ... ] }
  }
}
// 03 / Parâmetros

Parâmetros

nametypeObrigatório
chart1 object sim First subject — same shape as /v1/chart (date, time, timezoneOffset, latitude, longitude).
chart2 object sim Second subject — identical shape.
chart1.name / chart2.name string não Optional labels echoed back so you can tell the two subjects apart in the response.
// 04 / Quando usar

Quando usar

Este é o endpoint base para aplicações de encontros e de emparelhamento, produtos de relatórios de relacionamento e qualquer funcionalidade que responda a "como se relacionam estas duas pessoas?". Combine-o com o nosso auxiliar de pontuação de compatibilidade para transformar os aspetos cruzados em bruto numa única percentagem, ou passe a grelha a um LLM para uma leitura escrita de relacionamento. Como ambos os mapas são devolvidos por completo, uma chamada de sinastria substitui três (dois mapas natais mais a sobreposição) — calcule-a uma vez e coloque o resultado em cache indexado pelos dois momentos de nascimento. O método segue Robert Hand e Stephen Arroyo; as técnicas do mapa composto e do ponto médio de Davison vivem nos seus próprios endpoints quando precisa de um único mapa fundido em vez de uma sobreposição.

// 05 / Notas

Notas

Os aspetos cruzados usam a mesma política de orbes que a grelha de aspetos natais. Ambos os sujeitos aceitam o conjunto completo de parâmetros de /v1/chart, incluindo sistema de casas e desvio de fuso horário por sujeito. A sinastria é um endpoint de Tier 3 (dois mapas + uma varredura de sobreposição); coloque em cache de forma agressiva, pois o resultado é totalmente determinístico para um dado par de momentos de nascimento.

Experimente a API de Sinastria

Obtenha uma chave e faça a sua primeira chamada em menos de um minuto.

99.9% SLA · planos pagos · 30d status →