Sinastria

L’endpoint POST /v1/synastry confronta due carte natali: calcola le asce tra i pianeti di due persone e restituisce un punteggio di compatibilità. Costo: 50 crediti (Tier 3).

Parametri della richiesta

Due oggetti annidati chart1 e chart2, ciascuno con gli stessi parametri di /v1/chart:

Parametro	Tipo	Obbligatorio	Descrizione
chart1	object	Sì	Dati della prima persona
chart2	object	Sì	Dati della seconda persona

Ogni oggetto: date, time, timezoneOffset, latitude, longitude, houseSystem, name, city.

Esempio di richiesta

cURL

curl -X POST https://api.astroway.info/v1/synastry \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "chart1": {
      "date": "1990-07-14",
      "time": "14:30:00",
      "timezoneOffset": 3,
      "latitude": 50.4501,
      "longitude": 30.5234,
      "name": "Person A"
    },
    "chart2": {
      "date": "1992-03-22",
      "time": "09:15:00",
      "timezoneOffset": 2,
      "latitude": 48.8566,
      "longitude": 2.3522,
      "name": "Person B"
    }
  }'

Node.js

const body = {
  chart1: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234, name: 'Person A' },
  chart2: { date: '1992-03-22', time: '09:15:00', timezoneOffset: 2, latitude: 48.8566, longitude: 2.3522, name: 'Person B' },
};
const res = await fetch('https://api.astroway.info/v1/synastry', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
  },
  body: JSON.stringify(body),
});
const result = await res.json();
console.log(result.compatibility);
console.log(result.crossAspects.length);

Python

import os, requests

body = {
    'chart1': {'date': '1990-07-14', 'time': '14:30:00', 'timezoneOffset': 3, 'latitude': 50.4501, 'longitude': 30.5234, 'name': 'Person A'},
    'chart2': {'date': '1992-03-22', 'time': '09:15:00', 'timezoneOffset': 2, 'latitude': 48.8566, 'longitude': 2.3522, 'name': 'Person B'},
}
r = requests.post(
    'https://api.astroway.info/v1/synastry',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json=body,
)
result = r.json()
print(result['compatibility'])

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('synastry', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'chart1' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'timezoneOffset' => 3,
            'latitude' => 50.4501,
            'longitude' => 30.5234,
            'name' => 'Person A',
        ],
        'chart2' => [
            'date' => '1992-03-22',
            'time' => '09:15:00',
            'timezoneOffset' => 2,
            'latitude' => 48.8566,
            'longitude' => 2.3522,
            'name' => 'Person B',
        ],
    ],
]);

$result = json_decode($r->getBody(), true);
print_r($result['compatibility']);

Esempio di risposta

{
  "chart1": {
    "input": { "date": "1990-07-14", "name": "Person A" },
    "planets": [ ... ],
    "houses": { ... },
    "aspects": [ ... ]
  },
  "chart2": {
    "input": { "date": "1992-03-22", "name": "Person B" },
    "planets": [ ... ],
    "houses": { ... },
    "aspects": [ ... ]
  },
  "crossAspects": [
    {
      "planet1": "Sun",
      "planet2": "Venus",
      "chart1Planet": "Sun",
      "chart2Planet": "Venus",
      "type": "trine",
      "orb": 2.14,
      "applying": false
    },
    {
      "planet1": "Moon",
      "planet2": "Mars",
      "chart1Planet": "Moon",
      "chart2Planet": "Mars",
      "type": "square",
      "orb": 0.87,
      "applying": true
    }
  ],
  "compatibility": {
    "score": 72,
    "label": "harmonious",
    "harmony": 18.5,
    "tension": 7.2
  }
}

Nota

chart1 e chart2 sono carte natali complete (gli stessi campi di /v1/chart). crossAspects sono gli aspetti tra i pianeti delle due carte. compatibility.score va da 0 a 100.

Campo compatibility

Campo	Tipo	Descrizione
score	number	Punteggio totale 0–100
label	string	harmonious, balanced, mixed, challenging
harmony	number	Somma ponderata degli aspetti armoniosi (trine, sextile)
tension	number	Somma ponderata degli aspetti tesi (square, opposition)

Endpoint correlati

Endpoint	Crediti	Funzionalità aggiuntiva
/v1/composite	50	Carta composita (punti medi)
/v1/davison	50	Carta di Davison (data media)
/v1/coalescent	50	Carta coalescente
/v1/group-synastry	100	Matrice di compatibilità per 2–10 persone
/v1/human-design/compatibility	100	Compatibilità Human Design

Approfondisci

• Carta natale — richiesta base
• Transiti — sovrapposizione transiti
• Human Design — carta HD completa
• Riferimento API — tutti gli endpoint 723