واجهة برمجة تطبيقات مخطط التحويلات
التقط السماء في أي تاريخ مستهدف ووضعها فوق إطار الميلاد الشخصي في طلب POST واحد. الكواكب المتحركة، الحدود الميلادية التي تقع فيها، شبكة الجوانب بين الأجسام المتحركة، بالإضافة إلى الموازيات والمضادات - دقة Swiss Ephemeris، مخرجات JSON.
واجهة برمجة تطبيقات مخطط التحويلات
نقطة نهاية التحويلات تأخذ بيانات الميلاد الشخصية - تاريخ الميلاد، الوقت، إزاحة UTC، خط العرض، خط الطول، ونظام المنازل - ومستهدف منفصل. يحل التاريخ المستهدف ووقت الساعة إلى يوم يوليان، ويطلب من محرك Swiss Ephemeris خط الطول والخطوط العريضة والسرعة لكل جسم متحرك، ثم يلقي هذه المواضع في المنازل المشتقة من موقع الميلاد. يحمل الاستجابة الكواكب المتحركة مع علاماتها ومواضع المنازل، حدود المنازل الميلادية، وشبكة الجوانب الكاملة المحسوبة بين الأجسام المتحركة نفسها، كل منها مع علامات تطبيق أو انفصال ومقاييس دقيقة. كما يعيد الموازيات والمضادات (نقاط المرآة) للجوانب في الانحراف والمحور الاستوائي. الحركة التراجعية يتم تمييزها من سرعة الجسم، حتى يمكنك رؤية أي التحويلات مباشرة، ثابتة، أو متحركة للخلف في اللحظة المطلوبة.
POST/v1/transits
curl -X POST https://api.astroway.info/v1/transits \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52,
"transitDate": "2026-06-15",
"transitTime": "12:00:00",
"transitTzOffset": 3
}'{
"ok": true,
"data": {
"input": {},
"julianDay": 2461206.875,
"planets": [
{
"name": "Sun",
"longitude": 84.29,
"sign": "Gemini",
"house": 11
}
],
"houses": {
"ascendant": 160.4,
"mc": 70.1,
"cusps": [
"…"
]
},
"aspects": [
{
"planet1": "Sun",
"planet2": "Moon",
"type": "conjunction",
"orb": 1.2,
"applying": true
}
],
"parallelAspects": [
"…"
],
"antiscia": [
"…"
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
| transitDate | string (YYYY-MM-DD) | yes | Required target date for the transit snapshot (YYYY-MM-DD). |
| transitTime | string (HH:MM:SS) | no | Optional clock time of the transit moment (HH:MM:SS). |
| transitTzOffset | number (hours) | no | Optional UTC offset for the transit moment, in hours. |
When to use it
استخدم هذا عندما تريد السماء بأكملها كما تقع فوق مخطط شخص ما في يوم معين - أداة التحويلات اليومية، لوحة 'ما فوق الرأس الآن' بأسلوب الطقس، أو الإطار الخام الذي يقرأه وكيل ذكاء اصطناعي قبل وصف المناخ الفلكي الحالي. لأنه يعيد مخطط التحويلات فوق إطار المنازل الميلادية بدلاً من قائمة مختارة من التحويلات إلى الميلاد، فهو الخيار الصحيح عندما تحتاج إلى اللقطة الهيكلية نفسها. إذا كنت بدلاً من ذلك تريد ضربات التحويل إلى الميلاد الموقعة عبر نطاق تاريخي - تواريخ دقيقة، نقاط الدخول، نقاط التوقف - توجه إلى نقطة نهاية التقويم التحويلي، التي تم بناؤها لهذه المهمة الزمنية. زوج الاثنين: هذه النقطة النهائية للمخطط في اللحظة الزمنية، والتقويم للقائمة المستقبلية للأحداث.
Notes
كن دقيقًا بشأن النطاق: هذا يعيد مخطط التحويلات الموضح فوق إطار المنازل الميلادية، وليس قائمة الجوانب المسبقة التصفية من التحويل إلى الميلاد. شبكة الجوانب محسوبة بين الأجسام المتحركة، وليس بين نقاط التحويل والملاد. للتوقيت إلى الميلاد عبر مدى من التواريخ، استخدم /transit-calendar. المنازل تتبع نظام الميلاد المختار؛ برج المواليد الاستوائي و Swiss Ephemeris على طول الطريق.
Try the مخطط التحويلات API
Grab a key and make your first call in under a minute.