API للتقويم السنوي
التقويم السنوي هو أبسط تقنية توقيت في مجموعة الأدوات الهلنستية وإحدى الأكثر استخدامًا: يتقدم المخطط منزلًا واحدًا لكل سنة من العمر، ويصبح حاكم العلامة في ذلك المنزل رب السنة. رقم واحد يدخل، كوكب واحد يخرج، والسنة كلها لها توقيع.
API للتقويم السنوي
النقطة النهاية تأخذ بيانات الميلاد وتاريخ الهدف، تحسب عدد السنوات المكتملة منذ لحظة الميلاد، وتقدم علامة كاملة واحدة من الصاعد لكل منها. الرد يبلّغ العمر الذي حسبته، الفهرس الصفري للعلامة التي تقع فيها السنة، والكوكب الحاكم لتلك العلامة كـ lordOfYear، إلى جانب الصاعد الولادي، MC، الشمس والقمر حتى يمكنك عرض السنة على المخطط دون استدعاء ثاني. رقم المنزل نفسه يُستنتج مباشرة من العمر: الدورة طولها اثنا عشر سنة، لذا المنزل المتقوّم هو العمر modulo اثنا عشر، زائد واحد. العمر 36 يعود إلى المنزل الأول وبالتالي إلى علامة الصاعد نفسها، وهذا لماذا المخطط النموذجي، مع صاعد عند 169.97 درجة في برج العذراء، يُظهر signIndex 5 وعطارد كرب السنة. لأن العد يبدأ من لحظة الميلاد وليس من التقويم، سنة التقويم تتحول في عيد الميلاد وليس في أول يناير.
POST/v1/profections
curl -X POST https://api.astroway.info/v1/profections \
-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,
"targetDate": "2026-05-15"
}'{
"ok": true,
"data": {
"age": 36,
"signIndex": 5,
"lordOfYear": "Mercury",
"ascendant": 169.9680,
"mc": 77.0743,
"sun": 54.3760,
"moon": 296.9047
}
}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. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
| targetDate | string (YYYY-MM-DD) | yes | The date whose profection year you want. Age is counted from the birth moment, so the year turns on the birthday, not on January 1. |
When to use it
استخدم التقويمات عندما تحتاج طبقة توقيت يمكن للقارئ متابعتها بدون إيفيميرس. كل سنة لها كوكب حاكم واحد، لذا يمكن بناء توقع سنوي، تقرير عيد ميلاد أو سرد AI حول بيان واضح واحد بدل جدول عبور. يتماشى بشكل خاص مع العبور والعودة: ابحث عن رب السنة هنا، ثم شوف إيش يصير لهذا الكوكب بالعبور، وتكون عندك قراءة كلاسيكية بخطوتين في مكالمتين. كمان يتكامل مع العائد الشمسي، اللي يغطي نفس السنة من زاوية مختلفة. التقنية متقشرة عمدًا. تقول لك أي قسم من الحياة يتفعل ومن المسؤول، مو إيش يصير بعد الظهر، فاعتبرها الإطار اللي تعلق عليه توقيت أدق.
Notes
التقويمات بالعلامة الكاملة من الصاعد، علامة واحدة لكل سنة مكتملة، مع حكام السكن التقليديين كحاكم للسنة. تُحسب الأعمار من لحظة الميلاد، لذا السنة تتحول في عيد الميلاد. الصاعد الولادي، MC، الشمس والقمر يجيون من محرك Swiss Ephemeris في البرج الاستوائي ويُرجعون بالدرجات.
Try the التقويم السنوي API
Grab a key and make your first call in under a minute.