Sinastria

O endpoint POST /v1/synastry compara dois mapas natals: calcula os aspetos cruzados entre os planetas de duas pessoas e devolve uma pontuação de compatibilidade. Custo: 50 créditos (Tier 3).

Parâmetros da solicitação

Dois objetos aninhados chart1 e chart2, cada um com os mesmos parâmetros que o /v1/chart:

Parâmetro	Tipo	Obrigatório	Descrição
chart1	object	Sim	Dados da primeira pessoa
chart2	object	Sim	Dados da segunda pessoa

Cada objeto: date, time, timezoneOffset, latitude, longitude, houseSystem, name, city.

Exemplo de solicitação

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

Exemplo de resposta

{
  "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 são mapas natals completos (mesmos campos que o /v1/chart). crossAspects são os aspetos entre os planetas dos dois mapas. A compatibility.score varia de 0 a 100.

Campo compatibility

Campo	Tipo	Descrição
score	number	Pontuação geral de 0–100
label	string	harmonious, balanced, mixed, challenging
harmony	number	Soma ponderada de aspetos harmoniosos (trígono, sextil)
tension	number	Soma ponderada de aspetos tensos (quadratura, oposição)

Endpoints relacionados

Endpoint	Créditos	O que adiciona
/v1/composite	50	Mapa composto (pontos médios)
/v1/davison	50	Mapa de Davison (data média)
/v1/coalescent	50	Mapa coalescente
/v1/group-synastry	100	Matriz de compatibilidade para 2–10 pessoas
/v1/human-design/compatibility	100	Compatibilidade em Human Design

Próximos passos

• Mapa natal — solicitação básica
• Trânsitos — sobreposição de trânsitos
• Human Design — mapa completo de HD
• Referência da API — todos os 723 endpoints