واجهة برمجة تطبيقات علم الأعداد v1.0.3¶

واجهة برمجة تطبيقات علم الأعداد هي منصة إنتاجية لبناء منتجات علم الأعداد والتنجيم بمخرجات حتمية، وعقود JSON منظمة، وتغطية واسعة لنقاط النهاية.

• أكثر من 220 نقطة نهاية موثقة عبر علم الأعداد، الأبراج، التنجيم، التوافق، السفر، التعليم، الإرث العائلي، وأدوات العرافة
• الإصدار الحالي v1.0.3 مع 10 عائلات نقاط نهاية موسعة جديدة وتغطية استجابات كاملة بـ 26 لغة
• مسار RapidAPI العام للنمذجة الأولية السريعة والانطلاق
• مسار API مباشر + لوحة تحكم للتكامل المتقدم والمؤسسي
• توثيق ملائم للمطورين مع أمثلة الطلبات، وعقود المعاملات، وأنماط الاستجابات
• إصدار v1.0.3 إضافي مع 10 عائلات نقاط نهاية API مباشرة جديدة لمعالم العلاقات، الانتقال، المركبات، ملاءمة رقم الهاتف، التوقيعات، الحيوانات الأليفة، المشاريع الإبداعية، الإرث العائلي، المسارات التعليمية، ومواءمة وجهات السفر
• 26 لغة استجابة مدعومة: en، fr، es، de، pt، ja، hi، ar، ru، tr، it، pl، nl، id، ko، th، ro، ur، gu، bn، vi، ta، te، mr، pa، zh
• دعم أنظمة علم أعداد متعددة عبر num_sys: pythagorean، chaldean، و vedic

أبرز ميزات v1.0.3¶

إصدار v1.0.3 يضيف ذكاء الأبراج، تخصيصاً كاملاً لعجلة SVG لمخطط الميلاد، ترجمة عند الطلب، وإصدار Numora Studio التجريبي.

• نقاط نهاية للشمس والقمر والطالع والنمط والعنصر تحت /api/v1/horoscope/sign/.
• أصبح planet: general الخيار القياسي الافتراضي للتقارير الكوكبية.
• يدعم /api/v1/birth-chart/svg إعداد wheel كاملاً للسمات واللوحات والمرئية وألوان الكواكب والمخرجات المقسمة والضغط.
• تتوفر LibreTranslate وGoogle Translate وDeepL BYOK للترجمة عند الطلب مع إظهار المزوّد في البيانات الوصفية.
• Numora Studio v0.1.0-beta متاح على macOS وWindows وLinux باستخدام مفاتيح tnsr_ مستقلة.

→ اقرأ سجل تغييرات v1.0.3

أبرز ميزات v1.0.2¶

الإصدار v1.0.2 هو إصدار إنتاجي إضافي لواجهة برمجة تطبيقات علم الأعداد. يبني على الإصدار v1.0.1 الذي يمثل معلم أنظمة علم الأعداد المتعددة و 8 لغات، بإضافة 10 عائلات نقاط نهاية موسعة وتوسيع تغطية الاستجابات المدعومة إلى 26 لغة.

يركز هذا الإصدار على أربعة أهداف رئيسية:

1. تغطية نقاط نهاية موسعة جديدة
2. يضيف 10 عائلات نقاط نهاية جديدة.
3. كل نقطة نهاية جديدة تدعم كلاً من GET و POST.
4. تستخدم جميع نقاط النهاية الجديدة مسارات عامة نظيفة تحت /api/v1/*.
5. تشمل عائلات نقاط النهاية الجديدة معالم العلاقات، الانتقال، هوية المركبة، ملاءمة رقم الهاتف، التوقيعات، الحيوانات الأليفة، المشاريع الإبداعية، الإرث العائلي، المسارات التعليمية، ومواءمة وجهات السفر.

1. استمرار أنظمة علم الأعداد المتعددة
2. نقاط النهاية الجديدة القائمة على الاسم/العنوان/النص تدعم num_sys اختيارياً.
3. الأنظمة المدعومة:
   • pythagorean
   • chaldean
   • vedic

4. يبقى pythagorean هو النظام الافتراضي للحفاظ على السلوك الحالي.

5. توسيع تغطية اللغات

6. الإصدار v1.0.1 لا يزال معلم 8 لغات:
   • en
   • es
   • de
   • fr
   • pt
   • ar
   • hi
   • ja
7. الإصدار v1.0.2 يضيف 18 لغة إضافية:
   • ru
   • tr
   • it
   • pl
   • nl
   • id
   • ko
   • th
   • ro
   • ur
   • gu
   • bn
   • vi
   • ta
   • te
   • mr
   • pa
   • zh

8. تشمل عائلات نقاط النهاية الجديدة ملفات معاني JSON المترجمة عبر جميع أدلة اللغات الـ 26 المدعومة.

9. جاهزية التوثيق والإصدار

10. يضيف توثيق تكامل لجميع عائلات نقاط النهاية الجديدة العشر.
11. يضيف سجل تغييرات v1.0.2.
12. يحدّث فهرس نقاط النهاية الموسعة وروابط إصدار مرجع API.
13. يعرض نقاط النهاية الجديدة في التوثيق الداخلي للوحة التحكم واكتشاف الأوامر.
14. يتحقق من رؤية المسار، وتغطية JSON، وهيكل المعاني المترجمة، واستقرار مجموعة الاختبارات مع Python 3.11.

← اقرأ سجل تغييرات v1.0.2 الكامل

أبرز ميزات v1.0.1¶

الإصدار v1.0.1 هو إصدار إنتاجي إضافي لواجهة برمجة تطبيقات علم الأعداد. يبني على الإصدار v1.0.0 الذي يمثل طرح علم الأعداد الموسع، بإضافة قراءات أعمق للاسم، التوقيت، الأعمال، القرارات، العائلة، الفريق، المال، والنماذج الأصلية.

يركز هذا الإصدار على أربعة أهداف رئيسية:

1. تغطية نقاط نهاية أوسع
2. يضيف 10 عائلات نقاط نهاية جديدة.
3. كل نقطة نهاية جديدة تدعم كلاً من GET و POST.

4. تستخدم جميع نقاط النهاية الجديدة مسارات عامة نظيفة تحت /api/v1/*.

5. أنظمة علم أعداد متعددة

6. نقاط النهاية الجديدة القائمة على الاسم تدعم num_sys اختيارياً.
7. الأنظمة المدعومة:
   • pythagorean
   • chaldean
   • vedic

8. يبقى pythagorean هو النظام الافتراضي للحفاظ على السلوك الحالي.

9. توسيع تغطية اللغات

10. لغات الاستجابة المدعومة تشمل الآن:
    • en
    • es
    • de
    • fr
    • pt
    • ar
    • hi
    • ja

11. تشمل عائلات نقاط النهاية الجديدة العشر ملفات معاني JSON مترجمة لجميع اللغات الثماني المدعومة.

12. جاهزية التوثيق والإصدار

13. يضيف توثيق تكامل لجميع عائلات نقاط النهاية الجديدة العشر.
14. يحدّث فهرس نقاط النهاية الموسعة.
15. يوثّق سلوك GET و POST و lang و num_sys.
16. يتحقق من رؤية المسار، وتغطية JSON، واستقرار مجموعة الاختبارات مع Python 3.11.

← اقرأ سجل تغييرات v1.0.1 الكامل

أبرز ميزات v1.0.0¶

يجمع هذا الإصدار مسارين رئيسيين في إصدار منصة واحد:

1. طرح علم الأعداد الموسع
2. أضاف 23 عائلة نقاط نهاية جديدة و 41 عملية GET/POST جديدة.
3. أضاف فئات جديدة: الهوية والاسم، الروحاني والظل، و العلاقات.
4. وسّع تغطية التوقيت بمسارات الأسبوع الشخصي واليوم العالمي والأسبوع/الشهر/السنة العالمي.

5. تحقق من التغطية الشاملة متعددة اللغات (en، fr، es، de، pt، ja، hi، ar، ru، tr، it، pl، nl، id، ko، th، ro، ur، gu، bn، vi، ta، te، mr، pa، zh) بنسبة 100% في ضمان الجودة للإصدار.

6. ترحيل محرك الأبراج وتوسيعه

7. أضاف أكثر من 53 نقطة نهاية جديدة مع توجيه تقارير قانوني موحد تحت /api/v1/horoscope/reports/*.
8. وسّع عائلات التقارير اليومية/الأسبوعية/الشهرية/السنوية والمجموعات المتخصصة (الكواكب، الجوانب، العبور، البيوت، الكواكب في البيوت).
9. رفع مستوى اتساق الطلب/الاستجابة وتكافؤ المسارات للتكاملات الإنتاجية.

← اقرأ سجل تغييرات v1.0.0 الكامل ← اقرأ بنية محرك الأبراج

مسارات الوصول¶

خريطة مرجع API¶

• نظرة عامة على مرجع API
• نقاط النهاية الأساسية
• الدورات والعبور
• الهوية والاسم
• الروحاني والظل
• العلاقات
• نقاط نهاية الجسر
• نقاط نهاية الكارما
• نقاط نهاية الأبراج
• نقاط نهاية أخرى (التاروت / الجماتريا)

محرك الأبراج (نموذج إنتاجي)¶

مجموعة الأبراج حتمية ومدارة بواسطة Swiss Ephemeris، ومصممة لسلوك إنتاجي حقيقي (مخرجات مستقرة، وضمان جودة قابل للتكرار، وتصميم مسارات مناسب للتخزين المؤقت).

• مجموعات عوامل حتمية حسب الفترة (يومي، أسبوعي، شهري، سنوي)
• وضع عام (قائم على البرج) ووضع مخصص (مدرك لبيانات الميلاد)
• مجموعات تقارير تتجاوز الأبراج العامة: الكواكب، الجوانب، العبور، البيوت، الكواكب في البيوت
• أغلفة مؤسسية في الاستجابات (_enterprise، _api_metadata_) للبيانات الوصفية التشغيلية

← تعمق في المحرك ← نظرة عامة على تقارير الأبراج

بداية سريعة¶

API المباشر (موصى به للتغطية المتقدمة)¶

curl "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

نقطة نهاية موسعة v1.0.2 لـ API المباشر¶

curl "https://api.numerologyapi.com/api/v1/relationship-milestone-numerology?person_a_name=Amina%20Bello&person_a_dob=1992-04-18&person_b_name=Jonas%20Meyer&person_b_dob=1990-11-06&milestone_date=2027-06-12&milestone_type=wedding&num_sys=chaldean&lang=fr" \
  -H "X-API-Key: YOUR_API_KEY"

RapidAPI (المسار العام)¶

curl "https://the-numerology-api.p.rapidapi.com/life_path?birth_year=1990&birth_month=5&birth_day=15" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: the-numerology-api.p.rapidapi.com"

{
  "numerology_system": "pythagorean",
  "life_path_number": 8,
  "summary": {
    "title": "Life Path 8: The Powerhouse & Master Manifestor",
    "overview": "Life Path 8 carries the vibration of material mastery, authority, karmic balance, and large-scale achievement. You are the empire builder, financial wizard, and natural leader, gifted with exceptional organizational power, resilience, and the ability to manifest wealth and influence. Your soul purpose is to master power and use it responsibly for the greater good.",
    "strengths": [
      "Extraordinary business acumen, strategic thinking, and leadership",
      "Natural authority, executive presence, and resilience",
      "Ability to manifest large-scale wealth and influence",
      "Strong sense of justice and karmic awareness"
    ],
    "challenges": [
      "Power struggles, control issues, and workaholism",
      "Karmic lessons around money, ethics, and authority",
      "Fear of vulnerability or appearing weak",
      "Tendency to equate worth with material success"
    ],
    "life_lesson": "The greatest evolution for Life Path 8 is learning that true power is service-oriented and ethical. When authority is used to uplift others rather than dominate, abundance becomes infinite and meaningful.",
    "ideal_career_paths": [
      "Corporate leadership, entrepreneurship, and C-suite positions",
      "Finance, investment banking, real estate, and wealth management",
      "Politics, large-scale organization, and executive consulting",
      "Business coaching, strategic planning, and high-level management"
    ],
    "spiritual_growth_tip": "Practice generous philanthropy and ethical leadership. When you circulate wealth and power with wisdom and compassion, your success becomes truly divine."
  },
  "detailed_meaning": "Number 8 symbolizes power, ambition, and material success. Life Path 8 individuals are natural leaders, focused on achievement and financial mastery. They excel in business and management roles where their executive abilities shine. Born with an understanding of material world dynamics, they possess remarkable organizational and strategic skills. Their confidence and authority inspire others while their determination overcomes seemingly insurmountable obstacles. In relationships, they seek equal partners who appreciate their drive and share their ambitious vision. Career fulfillment comes through entrepreneurship, finance, real estate, corporate leadership, or large-scale ventures. Challenges include workaholism, authoritarian tendencies, and prioritizing material over spiritual; balancing material pursuits with spiritual growth, compassion, and personal relationships ensures true fulfillment and lasting legacy.",
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "9fe86d482c066afa",
    "quota": "unlimited",
    "usage_count": 1622,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "1.0.2",
    "endpoint_name": "life_path",
    "endpoint_description": "Calculates Life Path number from birth date.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-08-18T01:05:42.859507+01:00",
    "data_source": "Internal Engine",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "fr",
      "es",
      "de",
      "pt",
      "ja",
      "hi",
      "ar",
      "ru",
      "tr",
      "it",
      "pl",
      "nl",
      "id",
      "ko",
      "th",
      "ro",
      "ur",
      "gu",
      "bn",
      "vi",
      "ta",
      "te",
      "mr",
      "pa",
      "zh"
    ],
    "notes": ""
  }
}

ملاحظات الترحيل للتكاملات الحالية¶

• وجّه فئات v1.0.2 المباشرة فقط إلى https://api.numerologyapi.com.
• فضّل استخدام POST للعقود الأغنى/المتداخلة عند توفرها.
• استخدم lang في مسارات API المباشر المدعومة للمعاني JSON المترجمة عبر مجموعة الـ 26 لغة.
• استخدم num_sys في مسارات علم الأعداد القائمة على الاسم/العنوان/النص عندما تحتاج حسابات pythagorean أو chaldean أو vedic.
• حافظ على تطبيع مدخلات التاريخ والشهر (YYYY-MM-DD، YYYY-MM).
• حلل _enterprise و _api_metadata_ باستمرار في نماذج عميلك.
• بالنسبة لمنتجات الأبراج، انتقل إلى نقاط النهاية القانونية /api/v1/horoscope/reports/*.

تكامل إضافة ووردبريس¶

هل تحتاج مساراً بدون كود لتوصيل المحتوى لموقعك؟ استخدم إضافة Dakidarts Numerology Core الرسمية لتضمين النماذج والقراءات والتقارير مباشرة في صفحات ووردبريس.

• توثيق الإضافة
• التثبيت من WordPress.org

الخطوات التالية¶

• بداية الاستخدام
• التسعير
• أمثلة
• سجل التغييرات
• مرجع API