Synastrie

L’endpoint POST /v1/synastry compare deux thèmes natals : il calcule les aspects croisés entre les planètes des deux personnes et renvoie un score de compatibilité. Coût : 50 crédits (Tier 3).

Paramètres de la requête

Deux objets imbriqués chart1 et chart2, chacun avec les mêmes paramètres que /v1/chart :

Paramètre	Type	Obligatoire	Description
chart1	object	Oui	Données de la première personne
chart2	object	Oui	Données de la deuxième personne

Chaque objet : date, time, timezoneOffset, latitude, longitude, houseSystem, name, city.

Exemple de requête

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']);

Exemple de réponse

{
  "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
  }
}

Note

chart1 et chart2 sont des thèmes natals complets (mêmes champs que /v1/chart). crossAspects contient les aspects entre les planètes des deux thèmes. compatibility.score est une note sur 100.

Champ compatibility

Champ	Type	Description
score	number	Note globale sur 100
label	string	harmonious, balanced, mixed, challenging
harmony	number	Somme pondérée des aspects harmonieux (trine, sextile)
tension	number	Somme pondérée des aspects tendus (square, opposition)

Endpoints associés

Endpoint	Crédits	Fonctionnalité ajoutée
/v1/composite	50	Carte composite (points moyens)
/v1/davison	50	Carte de Davison (date moyenne)
/v1/coalescent	50	Carte coalescente
/v1/group-synastry	100	Matrice de compatibilité pour 2 à 10 personnes
/v1/human-design/compatibility	100	Compatibilité en Human Design

Pour aller plus loin

• Thème natal — requête de base
• Transits — superposition des transits
• Human Design — carte HD complète
• Référence API — tous les endpoints 723