AstroWay/api v2.201.6 · ar
جميع الأنظمة تعمل بشكل طبيعي
// astrology api · POST /v1/vedic/shadbala/full

Shadbala API

Shadbala - حرفيًا 'قوة ستية' - هي الطريقة الكلاسيكية لتحديد مقدار ما يمكن للكوكب أن يوفّيه من وعوده في الخريطة. هذه endpoint تحسب القوة الكلية لكل graha كمجموع الـ six balas المكوّنة، وتعيد نتيجة لكل كوكب بوحدات rupas حتى تقدر ترتّب الكواكب حسب مدى قوتها في الموقع.

Endpoint
POST /v1/vedic/shadbala/full
Cost
50 credits
Latency
~72 ms
Tier
Tier 3
// 01 / What it computes

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 واضحة.

// 02 / Live request

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
}'
Response (excerpt)
{
  "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
        }
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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).
// 04 / When to use it

When to use it

استخدم هذه endpoint كلما احتجت تقارن كوكب بآخر بدل ما تكتفي بتحديد موقعه - لتقييم اليوغا، اختيار أقوى كوكب لتسليط الضوء في القراءة، أو الحكم إذا كان حاكم الداشا قوي كفاية لتطبيق مواضيع فترته. تتكامل طبيعيًا مع endpoints الداشا والڤارغا: اسحب كوكب الحاكم للفترة النشطة، ثم اسأل Shadbala عن مدى قدرة هذا الكوكب. لأن الست مكوّنات تُحسب معًا في طلب واحد، تحصل على تحليل كامل للقوة دون الحاجة لدمج استعلامات موضعية، اتجاهية وزمنية منفصلة.

// 05 / Notes

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.

99.9% SLA · الخطط المدفوعة · 30d الحالة →