Synastrie

L’endpoint POST /v1/synastry compare deux cartes natales : 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	Requis	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 { data: 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()['data']
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)['data'];
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": 51,
    "label": "mixed",
    "harmony": 15.8,
    "tension": 16.8,
    "top": [
      { "aspect": { "planet1": "Venus", "planet2": "Moon", "type": { "name": "Square", "angle": 90 } }, "strength": 2.09, "sign": -1 }
    ]
  }
}

Note

chart1 et chart2 sont des cartes natales complètes (les mêmes champs que dans /v1/chart). crossAspects représente les aspects entre les planètes des deux cartes. compatibility.score va de 0 à 100.

Champ compatibility

Champ	Type	Description
score	number	Score global de 0 à 100
label	string	harmonious, balanced, mixed, challenging
harmony	number	Somme pondérée des aspects que le modèle considère comme harmonieux
tension	number	Somme pondérée des aspects que le modèle considère comme tendus
top	array	Les cinq aspects les plus importants par score, chacun avec strength et sign (1 pour harmonie, -1 pour tension)

Endpoints associés

Endpoint	Crédits	Ce qu’il ajoute
/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é HD

Suivant

• Carte natale: requête de base
• Transits: overlay transitoire
• Human Design: carte HD complète
• Référence API: tous les 771 de l’API