Shadbala API
Shadbala - حرفيًا 'قوة ستية' - هي الطريقة الكلاسيكية لتحديد مقدار ما يمكن للكوكب أن يوفّيه من وعوده في الخريطة. هذه endpoint تحسب القوة الكلية لكل graha كمجموع الـ six balas المكوّنة، وتعيد نتيجة لكل كوكب بوحدات rupas حتى تقدر ترتّب الكواكب حسب مدى قوتها في الموقع.
Shadbala API
من تاريخ الميلاد، الوقت، فرق UTC، والمكان، تستخرج هذه endpoint الخريطة النجمية عبر Swiss Ephemeris تحت نظام Lahiri ayanamsa، ثم تحسب مكوّنات القوة الست لكل graha كلاسيكي. Sthana bala تقيس القوة الموضعية من العلامة والموقع التقسيمي؛ Dig bala تقيس القوة الاتجاهية بمسافة الكوكب من زاويته المثالية؛ Kala bala تقيس القوة الزمنية من وقت الولادة؛ Cheshta bala تقيس القوة الحركية من السرعة الظاهرة للكوكب وحالته الرجعية؛ Naisargika bala هي القوة الطبيعية الثابتة التي يحملها كل كوكب؛ و Drik bala تقيس القوة الجوانبية الصافية من الجوانب التي يتلقاها. تُجمع هذه الستة لتكوّن Shadbala الكلية، وتُرجع الاستجابة أرقام كل كوكب تحت data.items، مع وحدتها لتكون نتائج rupas واضحة.
POST/v1/vedic/shadbala/full
curl -X POST https://api.astroway.info/v1/vedic/shadbala/full \
-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": {
"type": "shadbala",
"unit": "rupa",
"items": [
{
"planet": "Sun",
"total": 6.42,
"components": {
"sthana": 1.1,
"dig": 0.9,
"kala": 1.5,
"cheshta": 0.8,
"naisargika": 1,
"drik": 1.1
}
}
]
}
} 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
استخدم هذه endpoint كلما احتجت تقارن كوكب بآخر بدل ما تكتفي بتحديد موقعه - لتقييم اليوغا، اختيار أقوى كوكب لتسليط الضوء في القراءة، أو الحكم إذا كان حاكم الداشا قوي كفاية لتطبيق مواضيع فترته. تتكامل طبيعيًا مع endpoints الداشا والڤارغا: اسحب كوكب الحاكم للفترة النشطة، ثم اسأل Shadbala عن مدى قدرة هذا الكوكب. لأن الست مكوّنات تُحسب معًا في طلب واحد، تحصل على تحليل كامل للقوة دون الحاجة لدمج استعلامات موضعية، اتجاهية وزمنية منفصلة.
Notes
الاستجابة تُظهر القوة بوحدات rupas (الوحدة الكلاسيكية، حيث satu rupas يساوي ستين وحدة shashtiamsha) وتضيف لكل قيمة وحدتها. الحساب يتبع طريقة Graha-bala القياسية من تقليد Parashara كما هو موضح في Bṛhat Parāśara Horā Śāstra، ويُقيم على الخريطة النجمية بنظام Lahiri ayanamsa. جميع الـ six balas - Sthana, Dig, Kala, Cheshta, Naisargika, و Drik - تُرجع مُجمّعة في المجموع الكلي لكل كوكب.
Try the Shadbala API
Grab a key and make your first call in under a minute.