واجهة برمجة تطبيقات فيمشوتاري ماهاداشا
فيمشوتاري هي دورة كوكبية مدتها 120 عامًا تشكل أساس التوقيت الفيدي. تقوم هذه الواجهة بقراءة مواقع القمر الاستوائي عند الولادة، وتحدد النكشاترة التي يشغلها، ومن تلك النقطة الفردية تُفكك السلسلة المرتبطة من ماهاداشاس - فترات الحياة الرئيسية، كل منها يحكمه واحد من التسعة Grahas - مع التواريخ التقويمية الدقيقة التي تحدها.
واجهة برمجة تطبيقات فيمشوتاري ماهاداشا
تقوم الواجهة بتحويل تاريخ الميلاد، وقت الساعة، وموجة UTC إلى يوم يوليان، ثم تستعلم Swiss Ephemeris عن خط طول القمر المركزي الأرضي وتطبق Lahiri ayanamsa لنقله من البروج الاستوائية إلى البروج الاستعراضية. يحدد هذا الخط الاستعراضي النكشاترة الميلادية والجزء المنقضي بالفعل فيها، مما يحدد مقدار فترة الكوكب الحاكم المتبقية عند الولادة. من هناك، تُوضح التسلسل الكامل لدورة فيمشوتاري البالغة 120 عامًا بالترتيب القياسي - Ketu، Venus، Sun، Moon، Mars، Rahu، Jupiter، Saturn، Mercury - حيث تحمل كل ماهاداشا مدتها المخصصة وتواريخ البداية والنهاية المحددة. تُرجع الاستجابة أيضًا النكشاترة الميلادية، خط طول القمر الاستعراضي، وقيمة ayanamsa المستخدمة، مما يجعل الجدول الزمني قابلًا للمراجعة بالكامل.
POST/v1/vedic/dashas/vimshottari/maha
curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
-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
}'{
"ok": true,
"data": {
"system": "vimshottari",
"level": "maha",
"ayanamsa": 23.85,
"moonSiderealLongitude": 258.97,
"nakshatra": "Purva Ashadha",
"periods": [
{
"lord": "Venus",
"start": "1986-02-11",
"end": "2006-02-11"
},
{
"lord": "Sun",
"start": "2006-02-11",
"end": "2012-02-11"
}
]
}
}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). |
When to use it
استخدم هذه الواجهة عندما تحتاج الهيكل العظمي لداشا - الفترات الكبرى التي تشكل فصول حياة الشخص - بدلاً من التفاصيل على مستوى اليوم. إنها الاستدعاء الطبيعي الأول للجدول الزمني التنبؤي: عرض تسلسل الفترات الرئيسية، وتحديد الفترة النشطة حاليًا لتاريخ معين، والسماح للمستخدمين بالغوص من هناك. بما أن السلسلة بأكملها تتبع بشكل دترميني من موقع قمر واحد، يمكنك حسابها مرة واحدة عند التسجيل وتخزينها مؤقتًا إلى الأبد. عندما تحتاج إلى الفترات الفرعية المتداخلة داخل ماهاداشا معينة، اتجه إلى الواجهات المخصصة لـ antardasha، pratyantar، sookshma، و prana ضمن نفس عائلة فيمشوتاري.
Notes
تُرجع هذه المسار فقط طبقة ماهاداشا (الفترة الرئيسية). تقسيمات الأدق - antardasha، pratyantar، sookshma، و prana - موجودة في واجهات منفصلة ضمن /v1/vedic/dashas/vimshottari/*. يتبع الحساب تقليد Parashara كما هو مُرمز في Bṛhat Parāśara Horā Śāstra، مع البروج الاستعراضية و ayanamsa من Lahiri كإطار مرجعي افتراضي.
Try the دورة فيمشوتاري ماهاداشا API
Grab a key and make your first call in under a minute.