Tương hợp

Endpoint POST /v1/synastry so sánh hai lá số natal: tính toán các cross-aspect giữa các hành tinh của cả hai người và trả về điểm tương hợp. Chi phí: 50 credit (Tier 3).

Tham số request

Hai object lồng nhau chart1 và chart2, mỗi object có cùng các tham số như /v1/chart:

Tham số	Kiểu	Bắt buộc	Mô tả
chart1	object	Có	Dữ liệu của người thứ nhất
chart2	object	Có	Dữ liệu của người thứ hai

Mỗi object: date, time, timezoneOffset, latitude, longitude, houseSystem, name, city.

Ví dụ request

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

Ví dụ response

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

Ghi chú

chart1 và chart2 là các lá số natal đầy đủ (cùng các trường như trong /v1/chart). crossAspects là các aspect giữa các hành tinh của hai lá số. compatibility.score - từ 0 đến 100.

Trường compatibility

Trường	Kiểu	Mô tả
score	number	Điểm tổng 0–100
label	string	harmonious, balanced, mixed, challenging
harmony	number	Tổng có trọng số của các aspect mà mô hình coi là hài hòa
tension	number	Tổng có trọng số của các aspect mà mô hình coi là căng thẳng
top	array	Năm aspect có trọng lượng lớn nhất theo điểm, mỗi aspect có strength và sign (1 hài hòa, -1 căng thẳng)

Các endpoint liên quan

Endpoint	Credit	Thêm gì
/v1/composite	50	Lá số composite (điểm trung bình)
/v1/davison	50	Lá số Davison (ngày trung bình)
/v1/coalescent	50	Lá số coalescent
/v1/group-synastry	100	Ma trận tương hợp 2–10 người
/v1/human-design/compatibility	100	Tương hợp HD

Tiếp theo

• Lá số natal: request cơ bản
• Transit: overlay transit
• Human Design: lá số HD đầy đủ
• API reference: tất cả 771 endpoint