علم الأعداد في API: 5 أنظمة حساب عبر مسار واحد

Нومرولوجيا - جزء من الستاك الروحاني الذي عادةً ما يتجاهله الـ API بالكامل أو يختصره إلى «رقم مسار الحياة» البايغوري الوحيد. اخترنا مسارًا مختلفًا: 5 أنظمة كاملة، كل منها يحتوي على 10 حسابات قانونية، عبر مسار واحد معلمة.

معًا هذا 50 إندبوينت تحت /numerology/{system}/{calc}، بالإضافة إلى مصفوفة القدر المنفصلة. أدناه - كيف تم تنظيم ذلك ولماذا يكفي مسار واحد.

جميع الحسابات تتبع القالب:

POST /v1/numerology/{system}/{calc}

{system} - أحد القيم الخمس. كل نظام لديه جدول مطابقة خاص به «حرف → رقم» وقواعد اختزال خاصة، لذا النتيجة لنفس الاسم تختلف حسب المدرسة:

النظام غير المعروف يُعيد 400 INVALID_SYSTEM مع قائمة القيم المسموح بها - لا توجد أي fallback صامتة إلى البايغورية.

نفس المجموعة من 10 حسابات متاحة لأي من الأنظمة الخمسة:

• life-path - رقم مسار الحياة (من تاريخ الميلاد)
• expression - رقم التعبير / القدر (من الاسم الكامل)
• soul-urge - رقم الروح (الأحرف المتحركة في الاسم)
• personality - رقم الشخصية (الأحرف الساكنة في الاسم)
• birthday - رقم يوم الميلاد
• maturity - رقم النضج (life-path + expression)
• balance - رقم التوازن (الأحرف الأولى)
• challenge - أرقام التحديات
• pinnacles - أرقام القمم (فترات الحياة)
• personal-year - رقم السنة الشخصية

جسم الطلب لمعظم النداءات - مجرد الاسم والتاريخ:

{ "name": "Ada Lovelace", "date": "1815-12-10" }

personal-year يقبل أيضًا year، لأنه يحسب اهتزاز السنة التقويمية المحددة.

curl -X POST https://api.astroway.info/v1/numerology/pythagorean/life-path \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada Lovelace","date":"1815-12-10"}'

الاستجابة تحتوي ليس فقط على الرقم، بل أيضًا على سلسلة الاختزال الكاملة وتفسير جاهز:

{
  "ok": true,
  "data": {
    "system": "pythagorean",
    "name": "Ada Lovelace",
    "date": "1815-12-10",
    "lifePath": {
      "raw": 10,
      "reduced": 1,
      "isMaster": false,
      "steps": [10, 1],
      "meaning": {
        "number": 1,
        "archetype": "The Pioneer",
        "strengths": ["leadership", "independence", "innovation", "initiative"],
        "challenges": ["ego", "impatience", "isolation", "stubbornness"],
        "career": ["entrepreneur", "executive", "inventor", "pioneer"],
        "relationship": "needs a partner who respects independence; thrives on mutual challenge",
        "shortRead": "born to lead and originate; learn to balance solo drive with collaboration"
      }
    }
  }
}

حقل steps يُظهر كل خطوة اختزال (10 → 1)، وisMaster يُفعَّل على 11، 22 و33 - لا يتم اختزالهم وفق اتفاقية المدرسة البايغورية. هذا مهم إذا كنت تبني واجهة مستخدم خاصة بك: لا تحتاج إلى التخمين لماذا أصبح 29 هو 11 وليس 2 - السلسلة تُعطى صراحة.

مصفوفة القدر (Destiny Matrix) - ليست جزءًا من علم الأعداد التقليدي، لذا هي موجودة على مسار خاص:

POST /v1/destiny-matrix

هذه طريقة تعتمد على 22 من أوراق الأركان الكبرى في التارو، التي تُرتب في أوكتاغرام من تاريخ الميلاد. تُعيد مواضع الصليب المركزي، خطوط الأجداد، مناطق المال والعلاقات - بنية جاهزة لتصوير المصفوفة. نحتفظ بها خارج /numerology/* لأنها نموذج مختلف (الأركان، ليست اختزال أرقام).

حسابات الأعداد - حسابات رياضية صافية على السلسلة والتاريخ، بدون إيفيميريس. لذا فهي محددة ومجانية: نفس المدخل دائمًا يعطي نفس المخرج، التخزين المؤقت بسيط. التفسيرات (meaning) - جداول ثابتة، ليست LLM، لذا لا توجد فيها هلوسات ولا تباين بين النداءات.

إذا كنت بحاجة إلى نص حر فوق الأرقام، فهذا طبقة منفصلة /interpret/* مع AI - لكن الأرقام الأساسية دائمًا تأتي من نواة محددة.

الأعداد جزء من حزمة الإضافات الروحانية مع التارو، الرون، الجيومانتي، وI Ching. كل نداء - تكلفة ائتمانية ثابتة (حسابية، ليست AI-ندبوينت، لذا رخيصة). الخطة المجانية - 10 000 ائتمان شهريًا، وهذا يكفي لجمع ملف عدد كامل لعدة مئات من المستخدمين شهريًا دون دفع.

1. المفتاح على dashboard/sign-up
2. اختر النظام المناسب لجمهورك (البايغورية - الافتراضي للسوق الغربي، الفيدية - للسوق الهندي)
3. اجمع ملفًا من 10 نداءات أو اسحب رقمًا واحدًا لكل شاشة محددة

القائمة الكاملة للحقول والمخططات - في دليل OpenAPI تحت مجموعة Numerology.