Natal Chart API
حوّل لحظة ولادة واحدة إلى مخطط ولادة كامل ومنظم - الكواكب، حدود البيوت، الجوانب، والبيانات الزاوية - في طلب POST واحد. الأبراج الاستوائية، ثلاثة عشر نظام بيوت، دقة Swiss Ephemeris، مخرجات JSON.
Natal Chart API
نقطة النهاية natal-chart تحوّل تاريخ الميلاد، وقت الساعة، وإزاحة UTC إلى يوم جولياني دقيق، ثم تطلب من محرك Swiss Ephemeris خط الطول الجغرافي، خط العرض، وسرعة كل جسم - الكواكب العشرة الكلاسيكية بالإضافة إلى العقد القمرية، Chiron، وBlack Moon Lilith. تستخرج Ascendant وMidheaven من خط عرض وطول الميلاد، تقسم البيوت حسب النظام الذي تختاره، تعيّن كل كوكب إلى برجه وبيته، وتحسب شبكة الجوانب الكاملة مع علامات التطبيق/الفصل والحدود الدقيقة. يتم وضع علامة Retrograde بناءً على سرعة الجسم، وتُرجع sect المخطط (ولادة نهارية أو ليلية) حتى يتمكن التفسير اللاحق من وزن الفوائد والضرر بشكل صحيح.
POST/v1/chart
curl -X POST https://api.astroway.info/v1/chart \
-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,
"houseSystem": "P"
}'{
"ok": true,
"data": {
"planets": [
{ "name": "Sun", "longitude": 54.23, "sign": "Taurus", "house": 10, "retrograde": false },
{ "name": "Moon", "longitude": 282.7, "sign": "Capricorn", "house": 6 }
],
"houses": { "ascendant": 160.4, "mc": 70.1, "cusps": [160.4, 190.3, ...] },
"aspects": [ { "body1": "Sun", "body2": "Moon", "type": "trine", "orb": 1.2 } ]
}
}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). |
| houseSystem | string | no | One-letter Swiss Ephemeris code - P (Placidus, default), K (Koch), W (whole-sign), R (Regiomontanus), and 10 more. |
When to use it
استعمل هذه النقطة كلما احتجت العمود الفقري الهيكلي لبرجك: ودجت مخطط الولادة، تقرير ولادة، تدفق onboarding يخصّص المحتوى حسب الشمس/القمر/الصعود، أو وكيل AI يحتاج المواضع الخام قبل ما يفسّر أي شيء. هي المكالمة المسبقة للتوافق، العبور، التقدم، ومعظم أنواع التقارير - احسب المخطط مرة واحدة، خزن JSON في الكاش، ومرره إلى النقاط النهاية الأثقل بدل ما تعيد الحساب كل مرة. لأن الاستجابة بيانات صافية (بدون نص، بدون صور)، تندمج بسهولة مع أي ستاك: اعرضها بنفسك، مرّرها إلى LLM، أو أعطها لأحد نقاط النهاية لتوليد SVG.
Notes
الإعدادات الافتراضية تتبع القواعد الغربية السائدة: الأبراج الاستوائية، بيوت Placidus، "الثلاثية الكبيرة" الشمس-القمر-الصعود. المحرك هو Swiss Ephemeris (Astrodienst) ومشارك مع الحاسبة داخل المتصفح، لذا الخادم والعميل يتفقان على الدقة بالثانية القوسية. البيوت تعود إلى Porphyry فوق الدائرة القطبية حيث Placidus غير معرف.
Try the Natal Chart API
Grab a key and make your first call in under a minute.