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

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

• أكثر من 220 نقطة نهاية موثقة عبر علم الأعداد، الأبراج، التنجيم، التوافق، السفر، التعليم، الإرث العائلي، وأدوات العرافة
• الإصدار الحالي v1.0.2 مع 10 عائلات نقاط نهاية موسعة جديدة وتغطية استجابات كاملة بـ 26 لغة
• مسار RapidAPI العام للنمذجة الأولية السريعة والانطلاق
• مسار API مباشر + لوحة تحكم للتكامل المتقدم والمؤسسي
• توثيق ملائم للمطورين مع أمثلة الطلبات، وعقود المعاملات، وأنماط الاستجابات
• إصدار v1.0.2 إضافي مع 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.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، es، de، fr، pt) بنسبة 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"

شكل الاستجابة (مثال)¶

{
  "life_path_number": 3,
  "summary": {
    "title": "مسار الحياة 3",
    "overview": "نمط طاقة إبداعي، معبّر، وجذاب اجتماعياً."
  },
  "_enterprise": {
    "client": "The Numerology API"
  },
  "_api_metadata_": {
    "api_version": "1.0.2",
    "endpoint_name": "life_path",
    "documentation_url": "https://docs.numerologyapi.com/"
  }
}

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

• وجّه فئات 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