توسيع علم التنجيم + توسيع توقعات الفلك الإصدار v1.0.0 سجل التغييرات الموحد¶

تاريخ الإصدار: 2026-04-12 الإصدار: v1.0.0 النطاق: إصدار كامل للنظام يغطي واجهة برمجة تطبيقات علم التنجيم، توسيع توقعات الفلك: بما في ذلك نشر نقاط النهاية الموسعة، ونقل تقارير الفلك المدعومة بالمحرك، وتوحيد طلب/استجابة، ومساواة الوثائق، والتحقق متعدد اللغات، وإرشادات التكامل في الإنتاج.

نظرة عامة¶

v1.0.0 هو إصدار إنتاجي رئيسي عبر منصة Dakidarts API. إنه يجمع بين مسارين كبيرين من العمل في إصدار موحد:

1. توسيع علم التنجيم
2. يضيف السطح الموسع الكامل لعلم التنجيم.
3. يوسع تغطية الوقت/الدورة مع الأسبوع الشخصي واليوم/الأسبوع/الشهر/السنة الكوني.
4. يقدم نقاط نهاية أعمق لتحليل الروح والعلاقات والهوية والشخصيات المظلمة.

5. يكمل مساواة الوثائق وأمثلة الاستجابة والتحقق متعدد اللغات.

6. توسيع خدمة التوقعات الفلكية

7. يكمل عملية الانتقال الرئيسية لتوليد تقارير التوقعات الفلكية إلى محرك Swiss Ephemeris الداخلي.
8. يقوم بتوحيد مسارات التقارير المدعومة بالمحرك تحت /api/v1/horoscope/reports/*.
9. يوفر تغطية واسعة للمقاطع عبر فترات يومية، وأسبوعية، وشهريّة، وسنوية.
10. يقدم مجموعات شاملة من التقارير الفلكية المتعلقة بالكواكب، والزوايا، والانتقالات، والمنازل.
11. يحسن الاتساق في البيانات المرسلة، وسلوك التخصيص، والأوصاف المتوافقة، ومطابقة الوثائق.

يهدف هذا السجل إلى أن يكون المصدر الوحيد للحقيقة للمطورين، ومراجعة الإصدار الداخلي، والدعم، والتخطيط للانتقال، والتواصل مع العملاء.

أبرز الميزات على مستوى المنصة¶

ما الذي يقدمه الإصدار v1.0.0 عبر المنصة¶

• إصدار الإنتاج الرئيسي v1.0.0 لكل من واجهة برمجة تطبيقات الأبراج الفلكية وواجهة برمجة تطبيقات علم التنجيم.
• توسيع واسع للمساحة للنقاط الطرفية عبر منتجات علم التنجيم والأبراج الفلكية.
• إكمال ترحيل الحسابات الفلكية المدعومة بالمحرك لتدفقات التقارير الرئيسية.
• إكمال مسار إصدار علم التنجيم الموسع.
• تحسين أنماط طلبات منظمة تعتمد على POST لمسارات الأبراج الفلكية المحسنة.
• دعم أوسع للمحتويات الغنية للردود، والتغليف المؤسسي، واتساق البيانات الوصفية.
• مقارنة قوية في الوثائق عبر المستندات العامة ومحتويات الردود النموذجية.
• تحقق متعدد اللغات ناجح لنقاط نهاية علم التنجيم الموسعة.
• تحسين وضوح المسارات، ومعالجة التوافق، وتوجيهات الهجرة للعملاء في بيئة الإنتاج.
• دعم موسع للحسابات المخصصة حيث يتم توفير متجهات الميلاد والحقول المتقدمة لطلبات.
• تحسين الوضوح التشغيلي حول المنطقة الزمنية، ونظام الأبراج الفلكية، و Ayanamsa، وأنظمة البيوت، وسلوك العقد في تدفقات طلب الأبراج الفلكية.

ملخص تكوين الإصدار¶

توسيع علم التنجيم¶

• تم إضافة عائلات جديدة من نقاط النهاية: 23
• تم إضافة عمليات مجمعة (GET/POST): 41
• تم تنفيذ طلبات التحقق/الاختبار: 205
• تم توثيق نجاح الاختبار متعدد اللغات بنسبة: 100.0%
• نموذج إصدار موسع: إضافي، مع عدم وجود إعلانات رسمية عن التقاعد في المجموعة الموسعة الجديدة

توسيع التنجيم الفلكي¶

• تم نقل التقارير الرئيسية إلى المحرك الداخلي
• تم إضافة مجموعات تقارير جديدة عبر:
• كوكبات
• جوانب
• تحولات
• بيت
• بيت الكوكب
• تم تأسيس مساحة اسم تقارير قياسية تحت:
• /api/v1/horoscope/reports/*
• تم الاحتفاظ بالمسارات القديمة المتعددة كألقاب توافق مخفية بينما تتحرك الوثائق العامة مع المسارات القياسية

الجزء الأول — واجهة برمجة تطبيقات التنجيم v1.0.0¶

أبرز ميزات توسيع واجهة برمجة التطبيقات للتنجيم¶

• قمت بإضافة الوثائق الكاملة لـ "الرقمية الممتدة" كما هو موضح في قسم الوثائق الموسعة.
• قمت بإضافة وإكمال الأسبوع الشخصي مع التوافق الكامل بين GET/POST ودعم حمولة استجابة غنية.
• قمت بإضافة وإكمال إضافات دورة عالمية:
• اليوم العالمي
• الأسبوع العالمي
• الشهر العالمي
• السنة العالمية
• قيّمت وثائق نقاط النهاية الموسعة بشكل كامل مع جداول المعلمات الكاملة، وخيارات، وأمثلة الاستجابة، وروابط ذات صلة لنقاط النهاية.
• تأكدت من تغطية متعدد اللغات الشاملة عبر en, es, de, fr, pt بنسبة 100% لعمليات التشغيل الموسعة.
• أوضحت نموذج الوصول: نقاط النهاية الموسعة هي متاحة فقط على المنصة مباشرة وليست مدعومة حاليًا عبر بوابة RapidAPI.

توسيع الرقمية - تم إضافة نقاط نهاية جديدة¶

تضيف هذه النسخة 23 عائلة من نقاط النهاية الموسعة و 41 عملية (GET/POST مجمّعتين).

أ) نقاط نهاية الدورات والوقت¶

ب) نقاط نهاية الذكاء والاسم¶

ج) نقاط نهاية التحليل الروحي والظل¶

د) نقاط نهاية ديناميكيات العلاقات¶

واجهة برمجة تطبيقات (API) للرقميات — نقاط النهاية المحدثة والمثبتة¶

أ) الأسطح الأساسية الموسعة الجديدة المكتملة¶

تم إكمال الأسطح التالية بالكامل في هذه الدورة، مع التحقق من صحة الطلبات وإخراج المعنى الغني:

• GET /api/v1/personal-week
• POST /api/v1/personal-week
• GET /api/v1/universal-year
• POST /api/v1/universal-year
• GET /api/v1/universal-month
• POST /api/v1/universal-month
• GET /api/v1/universal-week
• POST /api/v1/universal-week
• GET /api/v1/universal-day
• POST /api/v1/universal-day

ب) إصلاحات الاستقرار التي تم تطبيقها أثناء التحقق الأولي¶

عمليات خمسة أدت في البداية إلى إنتاج 422 تحت ظروف إدخال دخان تم استقرارها لتغطية اختبارات تشبه بيئة الإنتاج، والآن تُرجع استجابات ناجحة تحت ظروف متعددة اللغات:

• POST /api/v1/brand-name-compare
• GET /api/v1/caution-dates-calendar
• POST /api/v1/caution-dates-calendar
• GET /api/v1/monthly-energy-heatmap
• POST /api/v1/monthly-energy-heatmap

ج) قواعد التحقق العملية المعززة¶

القواعد التالية تم تطبيقها بدقة خلال عملية التحقق والتوثيق:

ملاحظات:

• تم تضييق وتوضيح القيود التالية أثناء عملية التحقق والتوثيق:

ملاحظات:

• تم تحديد القيود التالية بدقة:
• يتطلب مقارنة العلامات وجود ما لا يقل عن مُدخلين في names[].
• تستخدم مدخلات شهر و خريطة الحرارة التنسيق YYYY-MM.
• تحذيرات حول التواريخ top_n تظل محصورة ضمن النطاق 1..31.
• تحسينات في بيانات العميل تعتمد على التحقق المسبق قبل الإرسال لتقليل الأخطاء غير الضرورية في 422 أو أخطاء على مستوى التنسيق.

د) إصلاحات التوافق بين الوثائق و OpenAPI¶

--- نهاية الوثيقة --- All extended docs were normalized for integration parity:

• جداول معلمات كاملة لكل طريقة

--- نهاية الوثيقة ---- تفاصيل خيارات المعلمة- أنماط، ونطاقات، وقيم افتراضية، وحقول الكائنات المتداخلة

--- نهاية الوثيقة ---- أمثلة لأقسام استجابات غنية تعتمد على البيانات التي تم إنشاؤها بواسطة "smoke testing"

--- نهاية الوثيقة ---- ملاحظات قياسية بشأن الوصول والتوافر

--- نهاية الملاحظات ---- قسم لوحة التحكم، وملاحظات الأقسام، وأسفل نهاية نقاط النهاية ذات الصلة

---¶

واجهة برمجة تطبيقات الأعداد => لمحة عن التحقق من الجودة¶

عناصر التحقق للوحدة الموسعة من الأعداد:

• ملفات الملخص: 23
• العمليات التي تم اختبارها: 41
• العدد الإجمالي لطلبات التنفيذ: 205
• معدل النجاح الكلي: 100.0%
• نجاح اللغة:
• en — 100%
• es — 100%
• de — 100%
• fr — 100%
• pt — 100%

يغلق هذا الإصدار دورة إطلاق الوحدة الموسعة من الأعداد مع ثقة التحقق الكامل عبر المجموعة اللغوية الموثقة.

واجهة برمجة تطبيقات الأعداد => الإلغاء¶

بالنسبة لإصدار الأعداد الموسعة v1.0.0، لا يتم إلغاء أي نقطة نهاية في السطح الموسع رسميًا.

واجهة برمجة تطبيقات الأعداد => تغييرات تؤثر على التطبيق¶

لا يتم إدخال أي عمليات إزالة مسارات تسبب مشاكل في السطح الموسع من الأعداد في هذا الإصدار.

ومع ذلك، يجب على المطورين ملاحظة التوقعات التالية على مستوى النشر:- نقاط النهاية الموسعة غير متاحة عبر RapidAPI حاليًا. - يجب على العملاء الذين يستخدمون نقاط النهاية الموسعة استهداف المضيف المباشر للنظام. - بعض نقاط النهاية الجديدة متاحة فقط من خلال POST ولا ينبغي افتراض وجود توافق مع GET.

واجهة برمجة التطبيقات (API) لـ "علم التنجيم" - ملاحظات الهجرة¶

1) هجرة قناة الوصول¶

تتوفر نقاط النهاية الموسعة عبر الوصول المباشر إلى النظام:

• عنوان URL الأساسي: https://api.numerologyapi.com
• المصادقة:
• X-API-Key: YOUR_API_KEY
• أو Authorization: Bearer YOUR_API_KEY

لا تدعم نقاط النهاية الموسعة حاليًا من خلال بوابة RapidAPI.

2) إرشادات الاستخدام لـ GET مقابل POST¶

تدعم معظم نقاط النهاية الموسعة كل من GET و POST مع نية مخرجات متساوية.

استخدم:

• GET لطلبات الاستعلام البسيطة
• POST لهيكل حمولة أقوى، والكائنات المتداخلة، واتساق SDK/الخلفية

تشمل نقاط النهاية التي تدعم POST فقط في هذا الإصدار:

• /api/v1/brand-name-compare
• /api/v1/relationship-composite
• /api/v1/relationship-healing-reading
• /api/v1/parent-child-numerology
• /api/v1/soul-connection-indicator

3) قواعد التحقق من صحة الإدخال على جانب العميل¶

يوصى بالتحقق المسبق على جانب العميل:

• dob و target_date: YYYY-MM-DD
• month: YYYY-MM
• timezone_offset: سلسلة زمنية IANA صالحة
• top_n: عدد صحيح في النطاق 1..31
• names[]: الحد الأدنى لـ 2 إدخالات لمقارنة العلامات التجارية
• context لتزامن التاريخ: الطول الأقصى 80، المقاييس المستندة مقبولة

4) أنماط جسم الطلب المتداخل¶

لأوجه نهاية العلاقات والتوافق، استخدم الكائنات المتداخلة بشكل صريح مثل:

• person_a
• person_b
• parent
• child

يجب أن يتضمن كل كائن الحقول المطلوبة مثل:

• full_name
• dob

5) معالجة اللغة والبيانات الوصفية¶

تدعم نقاط نهاية علم التنجيم المتعدد اللغات عرض استجابات متعددة اللغات من خلال lang.

مجموعة اللغة المدعومة لتغطية التحقق:

• en
• es
• de
• fr
• pt

قد تتضمن الاستجابات عبوات بيانات وصفية بأسلوب المؤسسات:

• _enterprise
• _api_metadata_

يجب على العملاء الحفاظ على تحليل هذه الحقول عند الحاجة لتحليلات النظام، ومعلومات الخطة، أو بيانات وصفية لنهاية.

6) تغطية دور جديدة¶

يمكن للعملاء الذين يستخدمون سابقًا فقط تدفقات اليوم/الشهر/السنة الشخصية الآن توسيع منطق الجدول لتغطية:

• دورات شخصية أسبوعية عبر /api/v1/personal-week
• واجهات زمنية جماعية عبر:
• /api/v1/universal-day
• /api/v1/universal-week
• /api/v1/universal-month
• /api/v1/universal-year

7) مصدر الوثائق الموثوق به¶

يتم الحفاظ على صفحات التكامل الكاملة على مستوى نقطة النهاية لهذا الإصدار ضمن قسم الوثائق الموسع، بما في ذلك صفحات الفهرس وصفحات لكل نقطة نهاية.

واجهة برمجة تطبيقات الأعداد => قائمة تحقق بالترقية الموصى بها¶

• انقل الاستدعاءات الموسعة إلى الوصول المباشر لواجهة برمجة التطبيقات في https://api.numerologyapi.com.
• تأكد من أن أدوات التحقق من صحة الطلبات تفرض تنسيقات التاريخ والشهر والمنطقة الزمنية.
• أضف معالجة احتياطية لقيم متعدد اللغات lang عند الحاجة.
• قم بتحديث العملاء لتحليل _enterprise و _api_metadata_ باستمرار.
• بالنسبة لنقاط النهاية المتداخلة، قم بمزامنة نماذج طلب SDK مع مفاتيح الكائنات المطلوبة.
• تحقق من خلال أدوات الاختبار قبل الترويج إلى الإنتاج.
• تأكد من أن جميع الاستدعاءات الموسعة يتم توجيهها خارج افتراضات العملاء القائمة على RapidAPI.

واجهة برمجة تطبيقات الأعداد => ملخص ملاحظات الإصدار¶

تُقدم واجهة برمجة تطبيقات الأعداد v1.0.0 السطح الموسع الكامل للأعداد مع توسيع الدورات الأسبوعية والكونية، وتحليلات العلاقات الروحية المتقدمة، وعقود طلب/استجابة أكثر ثراءً، بالإضافة إلى وثائق متزامنة بالكامل ومساواة في اختبارات Smoke.

الجزء الثاني - توسيع توقعات الأبراج v1.0.0¶

أبرز ميزات توسيع توقعات الأبراج¶

• إكمال عملية نقل مسارات تقارير الأبراج الرئيسية إلى محرك Swiss Ephemeris الداخلي.
• توحيد نقاط النهاية (endpoints) المحدثة حول طلبات الجسم الأول (POST).
• إضافة تغطية واسعة لـ القطاعات أولاً عبر الفترات اليومية، والأسبوعية، والشهرية، والسنوية.
• إعادة هيكلة نقاط نهاية تقارير الكواكب حسب الفترة والقطاع/نظرة عامة.
• تغيير اسم نقطة نهاية القاموس الخاصة بالكواكب لتعكس سلوكها المعلوماتي بدلاً من سلوك التقارير.
• توسيع التوافق مع طلبات مخطط الولادة (natal birth chart) وتقوية التحقق من شكل الاستجابة.
• توحيد استجابات نقاط النهاية المحدثة إلى محتوى الحمل بالإضافة إلى لفائف بيانات المؤسسة.
• تحديث أمثلة الوثائق العامة مع توافق JSON مدعوم.

توسيع توقعات الأبراج - نقاط نهاية جديدة تمت إضافتها¶

أ) واجهات ومسطحات مساعدة جديدة¶

• GET /api/v1/horoscope/timezones

ب) مجموعة تقارير الكواكب (سطح مقسم حسب الفترة)¶

القطاعات (غير عامة):

• POST /api/v1/horoscope/reports/planetary/daily
• POST /api/v1/horoscope/reports/planetary/weekly
• POST /api/v1/horoscope/reports/planetary/monthly
• POST /api/v1/horoscope/reports/planetary/yearly

نظرة عامة (عامة فقط):

• POST /api/v1/horoscope/reports/planetary/daily/overview
• POST /api/v1/horoscope/reports/planetary/weekly/overview
• POST /api/v1/horoscope/reports/planetary/monthly/overview
• POST /api/v1/horoscope/reports/planetary/yearly/overview

تغطية موسعة لمقطع الكواكب عبر الفترات تشمل القطاعات المدعومة من المحرك، مثل:- communication - friendship - lifestyle - career - health - money - love_singles - love_couples

ج) مجموعة تقارير الجوانب (سطح دوري)¶

الأقسام (غير عامة):

• POST /api/v1/horoscope/reports/aspects/daily
• POST /api/v1/horoscope/reports/aspects/weekly
• POST /api/v1/horoscope/reports/aspects/monthly
• POST /api/v1/horoscope/reports/aspects/yearly

نظرة عامة (عام فقط):

• POST /api/v1/horoscope/reports/aspects/daily/overview
• POST /api/v1/horoscope/reports/aspects/weekly/overview
• POST /api/v1/horoscope/reports/aspects/monthly/overview
• POST /api/v1/horoscope/reports/aspects/yearly/overview

يدعم aspects/* ما يلي:

• وضع عام
• وضع مخصص
• خيار تجاوز محدد لـ aspect
• نفس نموذج القسم المستخدم في مسارات الأبراج الفلكية المحدثة

د) مجموعة تقارير التحركات (سطح دوري)¶

الأقسام (غير عامة):

• POST /api/v1/horoscope/reports/transits/daily
• POST /api/v1/horoscope/reports/transits/weekly
• POST /api/v1/horoscope/reports/transits/monthly
• POST /api/v1/horoscope/reports/transits/yearly

نظرة عامة (عام فقط):

• POST /api/v1/horoscope/reports/transits/daily/overview
• POST /api/v1/horoscope/reports/transits/weekly/overview
• POST /api/v1/horoscope/reports/transits/monthly/overview
• POST /api/v1/horoscope/reports/transits/yearly/overview

يدعم transits/* ما يلي:

• وضع عام
• وضع مخصص
• خيار تجاوز محدد لـ transit
• نفس نموذج القسم المستخدم في مسارات الأبراج الفلكية المحدثة

هـ) مجموعة تقارير البيوت (خاص فقط، سطح دوري)¶

تقارير البيوت (أقسام غير عامة):

• POST /api/v1/horoscope/reports/house/daily
• POST /api/v1/horoscope/reports/house/weekly
• POST /api/v1/horoscope/reports/house/monthly
• POST /api/v1/horoscope/reports/house/yearly

نظرة عامة على البيوت (عام فقط):

• POST /api/v1/horoscope/reports/house/daily/overview
• POST /api/v1/horoscope/reports/house/weekly/overview
• POST /api/v1/horoscope/reports/house/monthly/overview
• POST /api/v1/horoscope/reports/house/yearly/overview

تقارير الكواكب والبيوت (أقسام غير عامة):

• POST /api/v1/horoscope/reports/planet/house/daily
• POST /api/v1/horoscope/reports/planet/house/weekly
• POST /api/v1/horoscope/reports/planet/house/monthly

• POST /api/v1/horoscope/reports/planet/house/yearlyنظرة عامة على الكواكب والبيوت (عام فقط):

• POST /api/v1/horoscope/reports/planet/house/daily/overview

• POST /api/v1/horoscope/reports/planet/house/weekly/overview
• POST /api/v1/horoscope/reports/planet/house/monthly/overview
• POST /api/v1/horoscope/reports/planet/house/yearly/overview

Both route families are intended for personal use only and are backed by engine endpoints such as:

• /house-horoscope
• /planet-house-horoscope

F) Canonicalization of Report Namespace¶

Canonical live report paths now use the /api/v1/horoscope/reports/* namespace across upgraded engine-backed horoscope surfaces.

Legacy non-report paths remain registered as hidden compatibility aliases.

G) Newly Added Horoscope Section Route Families Across Periods¶

Communication¶

• POST /api/v1/horoscope/reports/communication/daily/today
• POST /api/v1/horoscope/reports/communication/daily/tomorrow
• POST /api/v1/horoscope/reports/communication/daily/yesterday
• POST /api/v1/horoscope/reports/communication/weekly
• POST /api/v1/horoscope/reports/communication/monthly
• POST /api/v1/horoscope/reports/communication/yearly

Friendship¶

• POST /api/v1/horoscope/reports/friendship/daily/today
• POST /api/v1/horoscope/reports/friendship/daily/tomorrow
• POST /api/v1/horoscope/reports/friendship/daily/yesterday
• POST /api/v1/horoscope/reports/friendship/weekly
• POST /api/v1/horoscope/reports/friendship/monthly
• POST /api/v1/horoscope/reports/friendship/yearly

Lifestyle¶

• POST /api/v1/horoscope/reports/lifestyle/daily/today
• POST /api/v1/horoscope/reports/lifestyle/daily/tomorrow
• POST /api/v1/horoscope/reports/lifestyle/daily/yesterday
• POST /api/v1/horoscope/reports/lifestyle/weekly
• POST /api/v1/horoscope/reports/lifestyle/monthly
• POST /api/v1/horoscope/reports/lifestyle/yearly

Love Split Surfaces (Singles/Couples)¶

• POST /api/v1/horoscope/reports/love_singles/daily/today
• POST /api/v1/horoscope/reports/love_singles/daily/tomorrow
• POST /api/v1/horoscope/reports/love_singles/daily/yesterday
• POST /api/v1/horoscope/reports/love_singles/weekly
• POST /api/v1/horoscope/reports/love_singles/monthly
• POST /api/v1/horoscope/reports/love_couples/daily/today
• POST /api/v1/horoscope/reports/love_couples/daily/tomorrow
• POST /api/v1/horoscope/reports/love_couples/daily/yesterday
• POST /api/v1/horoscope/reports/love_couples/weekly
• POST /api/v1/horoscope/reports/love_couples/monthly

Yearly Section Additions¶

• POST /api/v1/horoscope/reports/health/yearly
• POST /api/v1/horoscope/reports/money/yearly

H) Renamed Informational Planets Surface¶

• GET /api/v1/horoscope/planets-info
• POST /api/v1/horoscope/planets-info

This replaces the prior /horoscope/planets naming for the informational glossary-style behavior.## توسيع توقعات فلكية - نقاط نهاية محدثة ومصلحة

أ) نقل المحرك وتحديث السلوك¶

تم تحديث العائلات التالية من المسارات الموجودة إلى سلوك مدعوم داخليًا:

مسارات التقارير الرئيسية¶

• POST /api/v1/horoscope/reports/today
• POST /api/v1/horoscope/reports/yesterday
• POST /api/v1/horoscope/reports/tomorrow
• POST /api/v1/horoscope/reports/weekly
• POST /api/v1/horoscope/reports/monthly
• POST /api/v1/horoscope/reports/yearly

مسارات الفئات الموجودة التي تم تحديثها من سلوك "horoscope.com" القديم¶

• المهنة
• الصحة
• الحب
• المال

عائلات موجودة وتقليدية أعيد هيكلتها وتم تحديثها¶

• تم تقسيم مسارات الحب التقليدية إلى love_singles و love_couples
• تم استبدال سلوك yearly/career_money المجمع بمسارات مهنية وسنوية مخصصة
• تم نقل مسارات التقارير والإطلالات الفلكية التقليدية إلى مسارات دورية

ب) توضيح مسار وصف علامة الأبراج¶

تبقى الواجهات التالية نقاط نهاية وصفية بدلاً من نقاط نهاية التقارير الحية:

• /api/v1/horoscope/sign/personality
• /api/v1/horoscope/sign/communication
• /api/v1/horoscope/sign/friendship
• /api/v1/horoscope/sign/love
• /api/v1/horoscope/sign/lifestyle
• /api/v1/horoscope/sign/health
• /api/v1/horoscope/sign/career
• /api/v1/horoscope/sign/money
• /api/v1/horoscope/sign/parent_child
• /api/v1/horoscope/sign/spirituality
• /api/v1/horoscope/sign/shadow

ج) تحديث التوافق في توقعات الميلاد¶

تعرض الآن POST /api/v1/horoscope/reports/birthday مفاتيح طلبية أصيلة للمحرك مع الحفاظ على مفاتيح التوافق.

السطح المحدث بشكل رسمي:

• POST /api/v1/horoscope/reports/birthday

تم الاحتفاظ بأسماء مستعارة توافق مخفية:- /api/v1/horoscope/birthday - /api/v1/horoscope/sign/birthday

مفاتيح طلبات خاصة بالمحرك مكشوفة:

• sign
• target_date
• birth
• sections
• zodiac_system
• ayanamsa
• house_system
• node_type
• tenant_id

تم الحفاظ على مفاتيح التوافق:

• dob
• timezone
• year
• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

د) تحديث توافق مخطط الميلاد¶

توجد هذه الواجهات قبل الإصدار 1.0.0 وهي الآن مُحدَّثة لتحقيق توافق كامل مع المحرك:

• POST /api/v1/birth-chart
• POST /api/v1/birth-chart/svg

تشمل التحسينات:

• دعم كامل لخيارات طلب "من البوابة إلى المحرك"
• توافق حقل تكوين "الترجيع"
• حماية أكثر صرامة لشكل الاستجابة

إ) تطبيع عقد الاستجابة¶

تُعيد نقاط نهاية محرك التوقعات المُحدَّثة:

• حمولة استجابة المحرك الأصلية
• _enterprise
• _api_metadata_

ج) معالجة المنطقة الزمنية والتاريخ النسبي¶

تطبق نقاط النهاية اليومية التي تستخدم today، و yesterday، و tomorrow الآن حلًا لتاريخ الهدف ذي الوعي بالمنطقة الزمنية من خلال إدخال المنطقة الزمنية IANA.

ح) توضيح دعم التخصيص¶

عندما يكون مدعومًا، يتم تفعيل التقارير المخصصة عن طريق توفير حقول "متجه الميلاد" مثل:

• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

إذا تم حذفها، تظل المسارات قابلة للاستخدام في وضع عام يعتمد على العلامات.```markdown

Current Translation - Endpoint (Deprecated, Hidden, and Removed)¶

Explanation: This section provides a comprehensive overview of the current translation process, including best practices for ensuring accuracy, consistency, and maintainability. It covers key areas such as:

• Translation Management System (TMS): Overview of features and functionalities
• Glossary and Terminology: Guidelines for consistent use of terms
• Quality Assurance (QA) Process: Steps to ensure translation quality
• Localization Considerations: Adapting content for specific regions
• Style Guide: Rules for writing in the target language

Key Benefits of Using a TMS:

• Improved efficiency and productivity
• Reduced costs and errors
• Enhanced collaboration between stakeholders
• Better control over translation quality
• Increased scalability and flexibility

Example Use Cases:

• Translating marketing materials
• Localizing software applications
• Creating multilingual websites
• Providing customer support in multiple languages

Conclusion:

By implementing a robust TMS and following best practices for translation management, organizations can ensure that their translations are accurate, consistent, and effective. This will help them to communicate with customers around the world in a clear and concise manner, while also reducing costs and improving efficiency.| نقطة النهاية | الحالة في الإصدار 1.0.0 | الاستبدال | ملاحظات | |---|---|---|---| | مسار تقرير التجميع الكوكبي القديم | تم الحذف | مسارات الفترة ضمن /reports/planetary/ مع مسارات خاصة بالفترة بالإضافة إلى مسارات مطابقة لـ /overview | تم حذف نقطة الدخول الرئيسية بعد اكتمال التوافق للفترات. | | POST /api/v1/horoscope/planetary/overview | مهمل (مخفي في OpenAPI) | POST /api/v1/horoscope/reports/planetary/daily/overview, POST /api/v1/horoscope/reports/planetary/weekly/overview, POST /api/v1/horoscope/reports/planetary/monthly/overview, POST /api/v1/horoscope/reports/planetary/yearly/overview | تم استبدالها بمسارات ملخص خاصة بالفترة. | | POST /api/v1/horoscope/planetary/daily/sections | اسم مستعار مخفي | POST /api/v1/horoscope/reports/planetary/daily | اسم مستعار للتوافق الداخلي. | | POST /api/v1/horoscope/love_single/monthly | اسم مستعار مهمل (مخفي) | POST /api/v1/horoscope/reports/love_singles/monthly | تم الاحتفاظ به لأغراض التوافق. | | POST /api/v1/horoscope/weekly/retail | مهمل (مخفي من OpenAPI/docs) | لا يوجد | تم إلغاء مسار تقرير برج الحظ المرن العام بعد إزالته من الوثائق العامة. | | مسار تقرير التجميع المرن القديم | تم الحذف | مسارات التقارير الخاصة بالقسم ومسارات ملخص الفترة | تم حذف نقطة الدخول الرئيسية بعد تقسيم كامل لنقاط النهاية. | | POST /api/v1/horoscope/yearly/career_money | تم الحذف | POST /api/v1/horoscope/reports/career/yearly و POST /api/v1/horoscope/reports/money/yearly | تم تقسيم نقطة النهاية إلى مسارات مخصصة. | | POST /api/v1/horoscope/love/{today,tomorrow,yesterday} | تم إلغاء التسجيل النشط | POST /api/v1/horoscope/reports/love_singles/daily/{today,tomorrow,yesterday} أو POST /api/v1/horoscope/reports/love_couples/daily/{today,tomorrow,yesterday} | أصبح "يوم الحب" مقسمًا حسب سياق العلاقة. || GET /api/v1/horoscope/planets و POST /api/v1/horoscope/planets | تم تغيير الاسم/إزالته | GET /api/v1/horoscope/planets-info و POST /api/v1/horoscope/planets-info | إعادة تسمية نقطة النهاية المعلوماتية لتحسين الوضوح. |

توسيع توقعات الفلك - تغييرات غير متوافقة¶

• تغيير اسم المسار: /api/v1/horoscope/planets → /api/v1/horoscope/planets-info
• المساحة الاسمية القياسية للإبلاغات اليومية المدعومة بمحرك هي الآن /api/v1/horoscope/reports/*
• تم استبدال المسارات اليومية المجمعة بمسارات منفصلة للأفراد والعلاقات
• تم إزالة مسار السنة المجمع career_money لصالح المسارات السنوية المخصصة
• تم إلغاء نقاط النهاية العامة للإبلاغات الكوكبية والنظرة العامة لصالح المسارات المنظمة حسب الفترة الزمنية
• تم توحيد المسارات المدعومة بمحرك حول هياكل طلبات POST

توسيع توقعات الفلك - ملاحظات التوافق¶

• تظل مسارات /api/v1/horoscope/report/* القديمة متاحة كألقاب عكسية متوافقة
• الوثائق العامة و OpenAPI تعرض الآن فقط المساحة الاسمية القياسية /api/v1/horoscope/reports/*
• يجب على التكاملات الجديدة اعتماد المسارات /reports/* على الفور

توسيع توقعات الفلك - ملاحظات الهجرة¶

1) خريطة هجرة مسار نقطة النهاية- GET/POST /api/v1/horoscope/planets → GET/POST /api/v1/horoscope/planets-info¶

• POST /api/v1/horoscope/report/{surface} → POST /api/v1/horoscope/reports/{surface}
• POST /api/v1/horoscope/{surface} → POST /api/v1/horoscope/reports/{surface}
• POST /api/v1/horoscope/planetary/overview → POST /api/v1/horoscope/reports/planetary/{period}/overview
• مسار تجميع كوكبي قديم: استخدم POST /api/v1/horoscope/reports/planetary/{period} أو مسار مكافئ للملخص.
• مسار تجميع فلكي مرن قديم: استخدم مسارات محددة حسب القسم أو مسارات ملخص.
• POST /api/v1/horoscope/yearly/career_money: قم بتقسيمه إلى مسارات مهنية وسنوية ومسارات مالية سنوية.
• مسارات يومية للعلاقات القديمة: قم بتقسيمها إلى love_singles أو مسارات يومية love_couples

2) هجرة حمولة الطلب¶

للمسارات المدعومة بمحرك مُحدَّث، استخدم أجسام POST منظمة مع حقول مثل:

• dob
• timezone
• محددات الفترة: day، أو target_date، أو year.
• خيارات المحرك الاختيارية:
• zodiac_system
• ayanamsa
• house_system
• node_type
• tenant_id
• حقول تخصيص اختيارية:
• birth_time
• birth_latitude
• birth_longitude
• birth_timezone

3) قواعد هجرة المسار الكوكبي¶

• استخدم sections فقط على مسارات فترات كوكبية غير ملخصة.
• يتم الوصول إلى general عبر مسارات مخصصة /overview.

4) هجرة محلل الاستجابة¶

يجب على العملاء تحليل:

• حقول حمولة التقرير مباشرة من جسم الاستجابة.
• _enterprise
• _api_metadata_

5) ملاحظة حول سلوك الترجمةThe horoscope engine itself does not generate multilingual content directly, so report based endpoints currently support but en only.¶

Non-report endpoints continue to support full multilingual translation through gateway helper layers using lang, such as:

• en
• es
• de
• fr
• pt

توسيع توقعات الأبراج – الوثائق والتوافق مع اختبار الجودة مكتمل¶

• وثائق عامة مُحدَّثة لمسارات التوقعات المُحسّنة

---- المستندات القديمة المتعلقة بالكواكب تم استبدالها بالمستندات الخاصة بالكواكب لكل فترة زمنية

---- تقسيم وثائق "المسيرة والمال" حيث تمت إزالة المسارات المجمعة

--- نهاية الوثيقة ---- مثال JSON متزامن مع استجابات نقطة النهاية، مصمم لتوثيق مُحسّن

--- نهاية المثال ---¶

قائمة التحقق من تحديثات العملاء الموصى بها - توسيع توقعات الأبراج الفلكية¶

• تحديث جميع المسارات التي تم تغيير اسمها وإلغاؤها باستخدام خريطة الهجرة

--- نهاية المستند ---- قم بتغيير أي مستهلك قديم لطلبات GET إلى طلبات نصية في POST

--- نهاية الوثيقة ---- أضف المنطقة الزمنية إلى جميع التدفقات اليومية لتجنب الانحراف النسبي في التواريخ

--- نهاية الماركوود ---- أضف حقول تخصيص حيث مطلوب محتوى تحريري مخصص للمستخدم

--- نهاية الوثيقة ---- تحديث محللات الاستجابة للحفاظ على _enterprise و _api_metadata_

--- نهاية Markdown ---- إعادة تشغيل اختبارات التكامل ضد جميع نقاط نهاية التوقعات المستخدمة في الإنتاج

---¶

ملخص ملاحظات الإصدار - توسيع التوقعات الفلكية¶

يُكمل إصدار Numerology API v1.0.0 عملية نشر رئيسية، ويوسع تغطية التقارير عبر الأقسام والفترات، ويقدم هيكل مسار قياسي أكثر وضوحًا، ويؤسس واجهة إنتاج أوضح للإصدارات المستقبلية من محرك التوقعات الفلكية الداخلي.

الجزء الثالث - إرشادات التكامل بين APIs¶

ملاحظات تكامل موحدة للعملاء الذين يستخدمون API التوقعات الفلكية¶

يجب على العملاء الذين يستهلكون نقاط نهاية Numerology و Horoscope مراجعة ما يلي معًا:

المصادقة والوصول¶

• نقاط نهاية Numerology الممتدة هي فقط للمنصة (بدون دعم RapidAPI)
• مسارات التوقعات الفلكية المدعومة بالمحرك هي أيضًا فقط للمنصة وتستمر تحت مساحة API القياسية الخاصة بها مع أنماط بوابة محدثة
• الحفاظ على دعم لفواصل بيانات وصفية من مستوى المؤسسة

تصميم الطلبات¶

• يفضل استخدام هياكل POST المنظمة بشكل صريح لجميع المسارات المحدثة أو الموسعة حديثًا
• التحقق من تنسيقات التاريخ، ومحددات الفترات، وسلاسل المنطقة الزمنية، والكائنات المتداخلة على جانب العميل
• حيثما أمكن، توفير متجهات تخصيص لإخراج أكثر ثراءً

دلالات التوقيت والتاريخ¶

• تعتمد نقاط نهاية "Numerology" على تنسيقات التاريخ والشهر الصحيحة.
• تعتمد مسارات "Horoscope" اليومية على معالجة التوقيت الصحيح لحل التواريخ النسبية.
• يُوصى بشدة باستخدام سلاسل التوقيت IANA إذا كانت مدعومة.

التعامل مع اللغات¶

• تتميز نقاط نهاية "Numerology" الممتدة بتفسير متعدد اللغات تم التحقق منه.
• تستمر مسارات "Horoscope" المدعومة من المحرك في دعم en فقط.

نصائح لإطلاق المنتج¶

• تحديث مكتبات SDK ومُحللي الطلبات أولاً.
• تحديث اختبارات التكامل ثانياً.
• ثم تعزيز تغييرات المسارات/المسارات إلى العملاء الإنتاجيين.
• مراقبة أي أسماء مستعارة متوافقة مخفية لا تزال قيد الاستخدام داخليًا حتى يتم التخلص منها بثقة في وقت لاحق.

الجزء الرابع — ملخص الإصدار النهائي¶

ماذا يعني v1.0.0؟¶

v1.0.0 هي النقطة التي يصبح فيها كلا السطحين أكثر اكتمالاً وشكلهما مناسبًا للإنتاج:

• واجهة برمجة تطبيقات علم الأعداد الآن تعرض فهرسًا موسعًا وغنيًا للغاية يغطي جوانب مثل الوقت، والهوية، والرؤى الروحية، والعمل على الظلال، والعلاقات، والتوافق، وتقويمات التنبؤ.
• تقارير الأبراج الآن تعتمد على أساس أقوى مدعوم بمحرك مع مساحات أسماء تقارير قياسية، وتغطية أوسع للأقسام، وأنماط هجرة أوضح، وملاءمة أفضل عبر عائلات التقارير.
• الوثائق والأمثلة وسلوك التحقق والبرامج النصية والتوافق أكثر نضجًا بشكل ملحوظ مقارنة بحالة ما قبل الإصدار 1.0.0.

هذا الإصدار ليس مجرد ترقية للإصدار. إنه إصدار هيكلي يحسن:

• اكتمال المنصة
• وضوح المسارات
• استعداد العميل للهجرة
• ثقة الوثائق
• اتساق التكامل المؤسسي

توصية تشغيلية¶

لجميع المطورين النشطين، فإن المسار الموصى به هو:

1. اعتماد المسارات القياسية على الفور
2. تحديث نماذج الطلبات لملفات POST-first حيثما أمكن ذلك
3. الحفاظ على تحليل "غلاف" البيانات الوصفية
4. التحقق من تنسيقات المنطقة/التاريخ على جانب العميل
5. نقل مستهلكي علم الأعداد الموسعة إلى الوصول المباشر إلى المنصة
6. إعادة تشغيل تغطية شاملة للتكامل قبل النشر

ملاحظة ختاميةيُظهر سجل التغييرات الموحد هذا حالة إصدار v1.0.0 لـ The Numerology API ويجمع أعمال الإطلاق الرئيسية المنجزة خلال نافذة إصدار 2026-04-12.¶

• سجل التغييرات الموحد v1.0.1