API synastrii

Endpoint synastrii oblicza oba horoskopy natalne niezależnie, a następnie nakłada je na siebie, aby znaleźć aspekty międzyhoroskopowe: każdą relację kątową, w której planeta w horoskopie A spotyka planetę w horoskopie B w granicach orbu. Każdy aspekt wzajemny jest zwracany z nazwami obu ciał, typem aspektu (koniunkcja, sekstyl, kwadratura, trygon, opozycja oraz aspekty mniejsze), dokładnym orbem i kierunkiem kontaktu, dzięki czemu wiesz, czyja Wenus tworzy trygon z czyim Marsem. Pełne zestawy planet dla obu osób zwracane są obok, więc możesz wyrenderować podwójny krąg lub zasilić moduł oceny dopasowania bez drugiego zapytania.

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 }
  }'

{
  "ok": true,
  "data": {
    "crossAspects": [
      { "planet1": "Venus", "planet2": "Mars", "type": "trine", "orb": 0.8, "direction": "A→B" }
    ],
    "chart1": { "input": { ... }, "planets": [ ... ] },
    "chart2": { "input": { ... }, "planets": [ ... ] }
  }
}

To podstawowy endpoint dla aplikacji randkowych i swatających, produktów z raportami relacji oraz każdej funkcji odpowiadającej na pytanie „jak te dwie osoby się odnoszą do siebie?”. Połącz go z naszym pomocniczym modułem oceny dopasowania, aby zamienić surowe aspekty wzajemne w pojedynczy procent, lub przekaż siatkę do LLM, aby uzyskać tekstowe odczytanie relacji. Ponieważ oba horoskopy zwracane są w całości, jedno wywołanie synastrii zastępuje trzy (dwa horoskopy natalne plus nałożenie) — oblicz je raz i zapisz wynik w pamięci podręcznej z kluczem opartym na obu momentach narodzin. Metoda podąża za Robertem Handem i Stephenem Arroyo; techniki kompozytu i punktu środkowego Davisona mają własne endpointy, gdy zamiast nałożenia potrzebujesz jednego scalonego horoskopu.

Aspekty wzajemne stosują tę samą politykę orbów co natalna siatka aspektów. Oba podmioty przyjmują pełny zestaw parametrów /v1/chart, w tym system domów i przesunięcie strefy czasowej per osoba. Synastria to endpoint Tier 3 (dwa horoskopy + skanowanie nałożenia); buforuj agresywnie, ponieważ wynik jest w pełni deterministyczny dla danej pary momentów narodzin.