Synastry API
So sánh hai bản đồ sinh trong một lần gọi và nhận lưới cross-aspect điều khiển mọi tính năng tương thích - ai tương tác với ai, với góc nào, với orb nào, theo hướng nào. Hai bản đồ vào, mối quan hệ giữa chúng ra.
Synastry API
Endpoint synastry tính toán cả hai bản đồ natal độc lập, sau đó chồng lên nhau để tìm các khía cạnh giữa các bản đồ: mọi mối quan hệ góc mà một hành tinh trong bản đồ A gặp một hành tinh trong bản đồ B trong phạm vi orb. Mỗi cross-aspect được trả về với cả hai thiên thể được đặt tên, loại khía cạnh (conjunction, sextile, square, trine, opposition và các góc phụ), orb chính xác, và hướng tiếp xúc để bạn biết Venus của ai đang trining Mars của ai. Bộ hành tinh đầy đủ cho cả hai đối tượng cũng được trả về, để bạn có thể vẽ bi-wheel hoặc đưa vào bộ tính điểm tương thích mà không cần vòng gọi thứ hai.
POST/v1/synastry
curl -X POST https://api.astroway.info/v1/synastry \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"chart1": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
"chart2": { "date": "1985-11-03", "time": "08:15:00", "timezoneOffset": 2, "latitude": 48.46, "longitude": 35.04 }
}'{
"ok": true,
"data": {
"crossAspects": [
{ "planet1": "Venus", "planet2": "Mars", "type": "trine", "orb": 0.8, "direction": "A→B" }
],
"chart1": { "input": { ... }, "planets": [ ... ] },
"chart2": { "input": { ... }, "planets": [ ... ] }
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| chart1 | object | yes | First subject - same shape as /v1/chart (date, time, timezoneOffset, latitude, longitude). |
| chart2 | object | yes | Second subject - identical shape. |
| chart1.name / chart2.name | string | no | Optional labels echoed back so you can tell the two subjects apart in the response. |
When to use it
Đây là endpoint cốt lõi cho các app hẹn hò và matchmaking, sản phẩm báo cáo quan hệ, và bất kỳ tính năng nào trả lời "hai người này liên quan như thế nào?". Kết hợp nó với công cụ tính điểm tương thích của chúng tôi để biến các cross-aspect thô thành một phần trăm duy nhất, hoặc chuyển lưới cho LLM để có bản đọc quan hệ bằng văn bản. Vì cả hai bản đồ đều được trả về đầy đủ, một lần gọi synastry thay thế ba lần (hai bản đồ natal cộng overlay) - tính một lần và lưu cache kết quả dựa trên hai thời điểm sinh. Phương pháp theo Robert Hand và Stephen Arroyo; các kỹ thuật composite và Davian midpoint có endpoint riêng khi bạn cần một bản đồ hợp nhất thay vì overlay.
Notes
Cross-aspects sử dụng cùng chính sách orb như lưới aspect natal. Cả hai đối tượng đều chấp nhận toàn bộ bộ tham số /v1/chart, bao gồm hệ thống nhà cho mỗi đối tượng và độ lệch múi giờ. Synastry là endpoint Tier 3 (hai bản đồ + một lần quét overlay); hãy cache mạnh mẽ vì kết quả hoàn toàn quyết định cho một cặp thời điểm sinh nhất định.
Try the Synastry API
Grab a key and make your first call in under a minute.