واجهة برمجة تطبيقات عودة الشمس
احسب الخريطة للّحظة الدقيقة اللي ترجع فيها الشمس لدرجة ميلادها في سنة تختارها - عيد ميلادك الفلكي. أعطِ خريطة ميلاد وسنة، واحصل على خريطة عودة الشمس لهذا الدورة. دقة استوائية، من الشمس إلى الشمس المولودة، باستخدام Swiss Ephemeris، وتخرج بالـ JSON.
واجهة برمجة تطبيقات عودة الشمس
نقطة النهاية solar-return أولاً تقرأ خط الطول الفلكي الدقيق للشمس المولودة من بيانات الميلاد المُعطاة، بعدين تدور في السنة المحددة على اللحظة الدقيقة اللي ترجع فيها الشمس المتنقلة لنفس الخط - عادةً خلال يوم أو يومين من تاريخ الميلاد في التقويم. تحوّل هاللحظة إلى يوم جولياني، وتستخرج المواقع الجيوцентрية والسرعات من محرك Swiss Ephemeris، وتولد خريطة كاملة: الكواكب العائدة مع الأبراج ومواقعها في البيوت، قُمم البيوت، وشبكة الجوانب الكاملة مع علامات التطبيق والانفصال والحدود الدقيقة. المطابقة استوائية ومن الشمس إلى الشمس المولودة، بدون تصحيح الانحراف بشكل افتراضي، فالشمس العائدة تكون على درجة الشمس المولودة الاستوائية. الخريطة الناتجة تُقرأ كخريطة الموضوع السائد للسنة من عيد ميلاد لعيد ميلاد.
POST/v1/solar-return
curl -X POST https://api.astroway.info/v1/solar-return \
-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,
"year": 2026
}'{
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Sun",
"longitude": 54.23,
"sign": "Taurus",
"house": 9
}
],
"houses": {
"ascendant": 188.2,
"mc": 95,
"cusps": [
"…"
]
},
"aspects": [
"…"
]
}
}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). |
| year | number | yes | Required integer year in which to find the Sun's return to its natal longitude. |
When to use it
استخدم عودة الشمس للتنبؤ السنوي - تقرير 'سنة قدام'، ميزة خريطة عيد الميلاد، أو تدفق AI يبني نظرة 12 شهر من خريطة واحدة بتاريخ. هي العمود الفقري للتنبؤ بالعودة: الزوايا، البيت اللي تقع فيه الشمس العائدة، وأقوى الجوانب تُقرأ كموضوعات رئيسية للسنة الشمسية. ادمجها مع العبور والتقدم لتعمق، لكن عودة الشمس لوحدها تعطي لمحة سنوية نظيفة ومستقلة مرتبطة بعيد ميلاد الشخص مش بالتقويم. لأنك تعطي فقط بيانات الميلاد وسنة، تندمج بسهولة مع مشغلات الذكرى وإيميلات سنوية مجدولة - أعد الحساب كل سنة لتحديث التوقع.
Notes
المطابقة استوائية، من الشمس إلى الشمس المولودة، وما فيها تصحيح الانحراف بشكل افتراضي، فبتعكس عودة الشمس الغربية التقليدية مش النسخة المصححة للبدائي. تُحسب للموضع المولود المُعطى؛ عوائد الشمس المنقولة تحتاج إعادة حساب في مكان مختلف. البروج الاستوائي وSwiss Ephemeris طوال الوقت.
Try the عودة الشمس API
Grab a key and make your first call in under a minute.