انتقل إلى المحتوى

سجل التغييرات Numerology API v1.0.1

سجل التغييرات Numerology API v1.0.1

تاريخ الإصدار: 2026-06-08
الإصدار: v1.0.1
النطاق: توسع نقاط نهاية Numerology API، دعم التنجيم الرقمي متعدد الأنظمة، توطين معاني JSON الموسع، تنظيف المسارات، وتوازن الوثائق.

نظرة عامة على الإصدار العام

v1.0.1 هو إصدار إنتاجي إضافي لـ Numerology API. يبني على نشر التنجيم الرقمي الموسع v1.0.0 من خلال إضافة قراءات أعمق حول الاسم، التوقيت، الأعمال، القرارات، العائلة، الفريق، المال، والنماذج الأصلية (Archetypes).

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

  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. تشمل الـ10 عائلات نقاط نهاية جديدة ملفات JSON للمعاني مترجمة لجميع الـ8 لغات المدعومة.

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

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

اكتمل التحقق لهذا الإصدار:

  • مجموعة اختبارات Python الكاملة: 137 passed
  • فحص مسارات OpenAPI: جميع الـ10 مسارات النظيفة موجودة
  • مسارات /api/v1/extended/* الجديدة: غير مثبتة
  • التحقق من ترجمات JSON: 8 مجلدات لغات، 444 ملفاً لكل، لا يوجد عدم تطابق هيكلي
  • مجلدات معاني JSON الحية: 8 لغات × 444 ملفاً لكل لغة

المستجدات

عائلات نقاط النهاية الجديدة

يضيف v1.0.1 10 عائلات نقاط نهاية جديدة و20 عملية.

نقطة النهاية الطرق المسار
Career Path Numerology GET, POST /api/v1/career-path-numerology
Wealth Code Reading GET, POST /api/v1/wealth-code-reading
Home Address Numerology GET, POST /api/v1/home-address-numerology
Baby Name Forecast GET, POST /api/v1/baby-name-forecast
Team Dynamics Numerology GET, POST /api/v1/team-dynamics-numerology
Domain Name Numerology GET, POST /api/v1/domain-name-numerology
Product Name Numerology GET, POST /api/v1/product-name-numerology
Decision Crossroads Reading GET, POST /api/v1/decision-crossroads-reading
Launch Timing Numerology GET, POST /api/v1/launch-timing-numerology
Personal Archetype Stack GET, POST /api/v1/personal-archetype-stack

البنية التحتية المشتركة الجديدة لنقاط النهاية

يضيف v1.0.1 منطق مساعد مشترك لنقاط النهاية الجديدة للتنجيم الرقمي الموسع، بما في ذلك:

  • تحميل JSON المترجم
  • البحث عن إعدادات نقطة النهاية
  • البحث عن المعاني والمعاني التفصيلية
  • حساب ملف تعريف الاسم
  • مساعدي تنجيم تاريخ الميلاد
  • مساعدي التقييم
  • تتبع الاستخدام
  • تغليف استجابة المؤسسة
  • إعادة استخدام تفويض الطلب

تعزيز نظام التنجيم الرقمي

يتضمن المساعد المشترك numerology-system الآن جداول حروف صريحة ومحققة لجميع الأنظمة المدعومة:

  • pythagorean
  • chaldean
  • vedic

تدعم جدول الفيدي الأسماء المحولة إلى اللاتينية ويبقى منفصلاً عن الجدول الكلداني رغم استخدام كلا النظامين لنفس قيم A-Z في v1.0.1. يتم تطبيع التشكيلات اللاتينية الشائعة والروابط قبل حساب الاسم، وتحترم مساعدي القيم المفقودة نطاق قيم الأبجدية الفعلي لكل نظام.

تغطية الاختبارات الجديدة

تغطي الاختبارات الجديدة:

  • سلوك الحاسبة للـ10 عائلات نقاط النهاية
  • دعم أنظمة التنجيم الرقمي chaldean وvedic
  • دعم سياسة 8 لغات
  • بحث المعاني المترجمة
  • رؤية مسارات OpenAPI
  • شكل المسار القياسي بدون /extended

الإصلاحات

تنظيف المسارات

تستخدم عائلات نقاط النهاية الجديدة الآن مسارات عامة نظيفة فقط:

  • صحيح: /api/v1/career-path-numerology
  • صحيح: /api/v1/wealth-code-reading
  • صحيح: /api/v1/personal-archetype-stack

شكل المسار المسودة /api/v1/extended/* لهذه الـ10 عائلات غير مثبت ولا يظهر في OpenAPI.

إصلاحات سياسة اللغة

تشمل سياسة اللغة المشتركة الآن جميع الـ8 لغات المدعومة:

  • en
  • es
  • de
  • fr
  • pt
  • ar
  • hi
  • ja

تبقى استثناء تقارير الهوروسكوب الحالي دون تغيير: مسارات /api/v1/horoscope/reports/* المدعومة بالمحرك تدعم en فقط.

إصلاحات الترجمة وتحقق JSON

تم تعزيز سير عمل الترجمة قبل نشر نقاط النهاية:

  • يتم الحفاظ على العناصر المحمية مثل placeholders، URLs، endpoints، أسماء الملفات، البريد الإلكتروني، وtokens API
  • يتم تقسيم سلاسل JSON الكبيرة بأمان
  • يتم الإشارة إلى البقايا الإنجليزية الدقيقة أثناء QA
  • يتم مقارنة هيكل JSON المترجم مع الهيكل المصدر الإنجليزي
  • الكتابة الذرية تمنع الكتابة الجزئية لـ JSON
  • منطق الاستئناف يتجاهل فقط الملفات المترجمة الصالحة هيكلياً

تم التحقق من حزمة معاني نقاط النهاية الجديدة قبل نسخها إلى مجلدات اللغات الحية.

إصلاحات الوثائق

تم محاذاة الوثائق مع سطح API المطبق:

  • إضافة num_sys إلى أمثلة GET وPOST ذات الصلة.
  • توثيق دعم 8 لغات للصفحات الجديدة.
  • إضافة الـ10 صفحات الجديدة إلى فهرس Extended Endpoints.
  • تطبيع جداول معلمات Markdown حتى يتم عرض الأنواع القابلة للإبطال (nullable) بشكل صحيح.

إصلاحات التحقق في الإنتاج

تم إعادة تشغيل التحقق باستخدام معيار Python في مساحة العمل:

  • Python: /opt/homebrew/bin/python3.11
  • الاختبارات الكاملة: 137 passed
  • فحص OpenAPI: المسارات النظيفة موجودة
  • المسارات المخفية/المسودة /extended للنقاط الجديدة: غائبة

المهملة

لا يوجد أي نقطة نهاية إنتاجية موجودة تم إهمالها رسمياً في v1.0.1.

نقطة النهاية الحالة في v1.0.1 البديل الملاحظات
None غير مطبق غير مطبق v1.0.1 إضافي لعملاء الإنتاج.

ملاحظة حول مسارات المسودة غير العامة

شكل مسار المسودة /api/v1/extended/* للـ10 عائلات نقاط النهاية الجديدة ليس جزءاً من سطح API العام لـ v1.0.1.

استخدم المسارات النظيفة بدلاً من ذلك:

  • /api/v1/career-path-numerology
  • ... (القائمة الكاملة)

فتح لوحة التحكم

Note

تتوفر إضافات v1.0.1 هذه من خلال الوصول المباشر إلى API على https://api.numerologyapi.com باستخدام مفتاح API الخاص بك. غير مدعومة حالياً عبر بوابة RapidAPI.

الوثائق ذات الصلة