AstroWay/api v2.201.7 · ar
جميع الأنظمة تعمل بشكل طبيعي
// astrology api · POST /v1/essential-dignities

واجهة برمجة تطبيقات الدرجات الأساسية

الدرجات الأساسية تقيس مدى راحة كل كوكب في البرج والدرجة التي يشغلها. تقوم هذه نقطة النهاية بتشغيل كل جسم عبر المخطط التقليدي الخماسي - الحكم، العلو، الثلاثية، الحد، والوجه - مع الضعفين، وتعيد كلًا من تفصيل لكل كوكب ومجموع موزون واحد.

Endpoint
POST /v1/essential-dignities
Cost
20 credits
Latency
~62 ms
Tier
Tier 2
// 01 / What it computes

واجهة برمجة تطبيقات الدرجات الأساسية

مع تحديد وقت ومكان الميلاد، تقوم نقطة النهاية بتحديد موقع كل كوكب حسب البرج والدرجة، ثم تقييمه مقابل جداول الدرجات البطلمية التي ورثها الممارسون الوسيطيون والهلنستيون. إنها تتحقق من الدرجات الأساسية الخمس بترتيب قوة تنازلي - حكم البرج، العلو، حكم الثلاثية لطائفة المخطط، الحد أو الحدود التي تقع فيها الدرجة، والوجه أو الدекан - والضعفين الأساسيين، الضرر والسقوط، حيث يجلس الكوكب مقابل حكمه أو علوه. يحصل كل كوكب على نقاط الدرجات التقليدية لكل شرط يفي به، ويتم طرح الضعفيات، وتتجمع الأرقام في تفصيل لكل جسم تحت data.dignities بالإضافة إلى totalScore شامل للمخطط. النتيجة تخبرك ليس فقط أي برج يوجد فيه الكوكب، بل مدى كرامته أو ضعفه هناك، مما يميز بين الكوكب في بيته وبين الكوكب الذي يمر ببساطة عبر برج لا يطالب به.

// 02 / Live request

POST/v1/essential-dignities

curl -X POST https://api.astroway.info/v1/essential-dignities \
  -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": {
    "dignities": [
      {
        "planet": "Venus",
        "rulership": false,
        "exaltation": true,
        "triplicity": true,
        "score": 7
      }
    ],
    "totalScore": 12
  }
}
// 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

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

// 05 / Notes

Notes

يتبع التقييم جداول الدرجات البطلمية كما تم توريثها في علم التنجيم الغربي التقليدي والوسيط؛ يتم تعيين حكم الثلاثية حسب طائفة المخطط (نهار أو ليل). تأتي مواضع الكواكب من محرك Swiss Ephemeris (Astrodienst) في البرج الاستوائي، لذا فإن البرج والدرجة التي تعتمد عليهما الدرجات تطابق نقاط نهاية الميلاد بالضبط.

Try the الدرجات الأساسية API

Grab a key and make your first call in under a minute.

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