API تحليل التوافق
قارن خريطتين للولادة في طلب واحد واحصل على الـ cross-aspect grid اللي يحدد كل ميزة توافق – من يتأثر بمن، بأي زاوية، وبأي orb، وفي أي direction. خريطتين تدخل، والعلاقة بينهم تطلع.
API تحليل التوافق
نقطة النهاية (endpoint) للـ synastry تحسب كل خريطة ولادة بشكل مستقل، ثم تدمجهم لتلاقي الـ cross-chart aspects: كل علاقة زاوية حيث كوكب في الخريطة A يلتقي بكوكب في الخريطة B داخل الـ orb. كل cross-aspect يرجع مع اسم الجسمين، نوع الـ aspect (conjunction, sextile, square, trine, opposition والزوايا الصغرى)، الـ orb الدقيق، وdirection الاتصال عشان تعرف من فين Venus يـ trine من Mars. مجموعات الكواكب الكاملة للموضوعين تُرجع جنبًا، فتقدر ترسم bi-wheel أو تغذي compatibility scorer بدون طلب ثاني.
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
هذا هو الـ endpoint الأساسي لتطبيقات المواعدة والـ matchmaking، منتجات تقارير العلاقات، وأي ميزة تجيب على سؤال "كيف يتفاعل هذين الشخصين؟". اجمعه مع أداة حساب التوافق لتحويل الـ cross-aspects الخام إلى نسبة واحدة، أو مرر الـ grid إلى LLM للحصول على قراءة مكتوبة للعلاقة. لأن كل خريطة تُرجع كاملة، مكالمة synastry وحدة تستبدل ثلاث (خريطتين natal + overlay) – احسبها مرة واحدة وخزن النتيجة بمفتاح لحظتي الولادة. الطريقة تتبع Robert Hand وStephen Arroyo؛ تقنيات الـ composite وDavison midpoint موجودة في نقاط النهاية الخاصة فيها إذا تحتاج خريطة مدمجة بدل overlay.
Notes
الـ cross-aspects تستخدم نفس سياسة الـ orb مثل شبكة الـ natal aspect. كلا الموضوعين يقبلان مجموعة معلمات /v1/chart الكاملة، بما فيها نظام البيوت لكل موضوع وإزاحة المنطقة الزمنية. Synastry هو الـ endpoint من Tier 3 (خريطتين + overlay scan)؛ cache aggressively لأن النتيجة حتمية بالكامل لزوج لحظات الولادة.
Try the تحليل التوافق API
Grab a key and make your first call in under a minute.