درجة التوافق¶

تحلل "درجة التوافق" 9 أرقام أساسية في علم الأعداد من شخصين (مسار الحياة، الرغبات القلبية، الشخصية، إلخ) وتعيد:

• ملفات تعريف علم الأعداد الفردية
• درجات التوافق بين الأزواج
• درجة شاملة موزونة (0-100)
• رؤى حول العلاقة

مثالية لتحليل المواعدة، الزواج، الأعمال، أو الصداقات. الأرقام الرئيسية: مدعومة بالكامل (11، 22، 33).

نقطة النهاية¶

الرؤوس المطلوبة¶

• X-API-Key: YOUR_API_KEY
• Host: api.numerologyapi.com
• Content-Type: application/json (فقط POST)

إنشاء وإدارة مفاتيح API في لوحة تحكم API الخاصة بعلم الأعداد.

المعلمات¶

الشخص الأول¶

الشخص الثاني| المعلمة | النوع | مطلوب | الوصف |¶

|---|---|---|---| | first_name_2 | سلسلة نصية | نعم | الاسم الأول | | middle_name_2 | سلسلة نصية | لا | الاسم الأوسط (أسماء) | | last_name_2 | سلسلة نصية | نعم | اسم العائلة | | dob_2 | سلسلة نصية | نعم | تاريخ الميلاد في YYYY-MM-DD |

| language | سلسلة نصية | نعم | رمز اللغة للرد. تشمل القيم المدعومة: en، es، de، fr، pt، إلخ. | | lang | سلسلة نصية | نعم | اسم مستعار لـ language. استخدم إما language أو lang. |

أضف المعلمة الاختيارية lang لتحديد لغة الرد. تشمل القيم المدعومة: en، es، de، fr، pt.

أمثلة الطلبات¶

طلب GET¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/compatibility-score?first_name_1=John&last_name_1=Doe&first_name_2=John&last_name_2=Doe&dob_1=1992-07-16&dob_2=1992-07-16&middle_name_1=&middle_name_2=&lang=en&num_sys=pythagorean" \
  --header "X-API-Key: YOUR_API_KEY"

طلب POST (جسم JSON)¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/compatibility-score?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "first_name_1": "John",
  "last_name_1": "Doe",
  "first_name_2": "John",
  "last_name_2": "Doe",
  "dob_1": "1992-07-16",
  "dob_2": "1992-07-16",
  "middle_name_1": "",
  "middle_name_2": "",
  "num_sys": "pythagorean"
}'

مثال الرد¶

{
  "numerology_system": "pythagorean",
  "person_1": {
    "full_name": "John Doe",
    "initials": "JD",
    "dob": "1992-07-16",
    "life_path": 8,
    "heart_desire": 8,
    "personality": 9,
    "hidden_passion": [
      5,
      6
    ],
    "destiny_number": 8,
    "attitude_number": 5,
    "subconscious_self_number": 5,
    "balance_number": 5,
    "rational_thought_number": 9
  },
  "person_2": {
    "full_name": "John Doe",
    "initials": "JD",
    "dob": "1992-07-16",
    "life_path": 8,
    "heart_desire": 8,
    "personality": 9,
    "hidden_passion": [
      5,
      6
    ],
    "destiny_number": 8,
    "attitude_number": 5,
    "subconscious_self_number": 5,
    "balance_number": 5,
    "rational_thought_number": 9
  },
  "compatibility_scores": {
    "life_path_score": 80,
    "heart_desire_score": 80,
    "personality_score": 85,
    "hidden_passion_score": 95,
    "destiny_number_score": 80,
    "attitude_number_score": 95,
    "subconscious_self_score": 95,
    "balance_number_score": 95,
    "rational_thought_score": 85,
    "overall_score": 86.8,
    "overall_insight": "Very strong & harmonious connection. Your energies flow together with grace and mutual support. This is a relationship that feels like 'coming home' — powerful synergy with only gentle adjustments needed."
  },
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "ced3a432226491dc",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "compatibility_score",
    "endpoint_description": "Computes numerology compatibility score between two individuals.",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:26.749083+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

خوارزمية التقييم¶

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

1. تعيين رقم الجذر: يتم تعيين جميع الأرقام (بما في ذلك أرقام الماستر 11، 22، 33) إلى اهتزازاتها الجذرية المقابلة (على سبيل المثال، 11→2، 22→4، 33→6). تستخدم العمليات الحسابية هذه القيم الجذر لتقييم التوافق.2. تعريفات أزواج الأرقام النمطية: يتم تخصيص نقاط أساس محددة للأزواج العددية المعروفة بقابلية عالية في علم الأعداد. على سبيل المثال:

   • (1, 5) and (5, 1): 85 (Adventure-driven combination)
   • (1, 9) and (9, 1): 75 (Leadership meets humanitarianism)
   • (2, 6) and (6, 2): 90 (Nurturing partnership)

2. حساب احتياطي: إذا لم يتم تعريف الزوج بشكل صريح، يتم استخدام صيغة قياسية: base_score = max(25, 100 - root_diff * 10)، مما يضمن توافقًا أساسيًا لا يقل عن 25%.

3. مكافأة تناغم الرقم الرئيسي: تتلقى الأزواج التي تشمل أرقام رئيسية نقاط إضافية إذا كانت قيم جذورها متطابقة (+15) أو متجاورة (+8)، مما يعكس طاقتهم الروحية المتزايدة.

4. مكافأة التطابق الدقيق: عند تطابق كلا الرقمين الأصليين (قبل تقليل الجذر)، يتم تطبيق مكافأة إضافية +10، مع الاعتراف بتناغم التردد المشترك.

5. الحساب النهائي: النتيجة النهائية هي مجموع النقاط الأساسية ومكافأة الرقم الرئيسي ومكافأة التطابق الدقيق، مع تحديد الحد الأقصى بنسبة 100%.

أوزان التصنيف¶

---عامل القوة: يتم تطبيق زيادة طفيفة (حتى +5٪) إذا كان أي من مسار الحياة أو الرغبة في القلب للشخص عبارة عن رقم رئيسي، مما يعكس إمكاناتهم للتواصل الروحي الأعمق.

مستويات الفهم الشاملة¶

| النتيجة | الرؤية || --- | --- | | ≥ 90 | توافق استثنائي على مستوى الروح || ≥ 80 | علاقة قوية ومتناغمة للغاية || ≥ 70 | توافق قوي ومتوافق مع الروح |

--- نهاية الوثيقة ---| ≥ 60 | أساس قوي وواعد |

--- نهاية الوثيقة ---| ≥ 50 | إمكانات معتدلة ومتوازنة || ≥ 40 | تحدي، ولكنه قابل للتعلم و ديناميكي || ≥ 25 | تناغم طبيعي منخفض || أقل من 25 | تحدي كبير في المحاذاة | Open Dashboard

--- * 9 core numbers compared. * Hidden Passion: First dominant number used. * Master Numbers: Fully preserved (11, 22, 33). * Validation: Missing required fields → 400; Invalid date → 400. * Use Case: Dating apps, matchmaking, team building, marriage counseling. * Caching: Not specified — default behavior.