واجهة API من NatalChart.AI هي محرك الحساب في تطبيق NatalChart.AI، مفتوحًا للمطورين. يكفي إرسال تاريخ الميلاد ووقته وإحداثيات مكانه لتعود الخريطة: لا ملفات تقويم فلكي تحتاج إلى استضافة، ولا جداول مناطق زمنية تحتاج إلى صيانة، ولا مكتبة تنجيم تحتاج إلى تحديث.
ما يمكنك بناؤه
صفحات خريطة الميلاد
الشمس والقمر والبرج الصاعد، وكل كوكب في برجه وبيته، والجوانب مع الأورب، وتوازن العناصر، لأي تاريخ ميلاد من 1800 إلى 2399. /v1/chart/full, /v1/chart/short
أبراج يومية من السماء الحقيقية
عبور اليوم على خريطة الشخص، مع الأورب الخاص بكل عبور وهل هو يشتد أم يخفت، إضافةً إلى طور القمر والأحداث الفلكية للأسبوع. /v1/horoscope/daily, /v1/sky
التوافق لمنتجات المواعدة
مقارنة خريطتين: كل جانب بينهما، والبيوت التي تقع فيها كواكب كل شخص في خريطة الآخر، وتقييم لكل مجال من مجالات الحياة. /v1/synastry
التوقعات والسنة المقبلة
العبور الدقيق في فترة تصل إلى 92 يومًا (حتى 60 حدثًا، والأهم أولًا)، وخريطة العودة الشمسية لأي سنة، في مكان الميلاد أو حيثما سيكون الشخص. /v1/transits, /v1/solar-return
أفضل الأيام
كل يوم في فترة معيّنة مقيَّمًا لنشاط ما (العمل، والحب، والسفر، والصحة، وغيرها)، مع العبور الداعم له والمعيق. /v1/timing
الأستروكارتوغرافيا والانتقال
تقييم مدينة واحدة مقابل خريطة، أو ترتيب المدن الكبرى في العالم لها، حسب مجال الحياة والمنطقة. /v1/locations/score, /v1/locations/rank
البدء في دقيقة
يكفي إنشاء مفتاح في تبويب API & MCP من إعدادات التطبيق (مجانًا، بلا بطاقة دفع)، ثم إرسال بيانات ميلاد:
curl https://api.natalchart.ai/v1/chart/short \
-H "Authorization: Bearer $NATALCHART_API_KEY" \
-H "Content-Type: application/json" \
-d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234}}'كل نقاط النهاية (endpoints) والحقول والأخطاء موجودة في توثيق API، ويصفها مستند OpenAPI لمولّدات الشيفرة.
دقة قابلة للتحقق
دائرة البروج المدارية، وبيوت بلاسيدوس، والجوانب الرئيسية الخمسة، والعقدة القمرية الحقيقية، ومواقع بأربع منازل عشرية من الدرجة. وتُحدَّد المنطقة الزمنية من الإحداثيات وفق قواعد التوقيت الصيفي في تاريخ الميلاد، وإذا كان وقت الميلاد غير معروف تُحسب المواقع للساعة 12:00 بالتوقيت المحلي بوصفها لحظة مفترضة، وتُحجب البيوت والأوتاد بدل تخمينها. ويقارن تقرير الدقة المحرك مع NASA JPL Horizons على خريطة اختبار منشورة واحدة، وتتيح لك الخريطة التوضيحية المنشورة التحقق من الاستجابة قبل كتابة أي شيفرة.
لمساعدي الذكاء الاصطناعي: خادم MCP
الحسابات نفسها متاحة في صورة خادم MCP على https://www.natalchart.ai/mcp. تتصل به Claude وChatGPT وCursor وVS Code بالمفتاح نفسه، وتستدعي بنفسها أدوات الخريطة والعبور والتوافق، فيقرأ المساعد خريطة محسوبة لا مخمَّنة.
الأسعار
| الباقة | السعر | الطلبات | نقاط النهاية |
|---|---|---|---|
| الباقة المجانية | $0 | 10 يوميًا | الخرائط وأجزاؤها، والأبراج اليومية، والسماء، والاستخدام |
| Premium | $9.99 شهريًا أو $79 سنويًا | 100 يوميًا | كل شيء: العبور، ومقارنة الخريطتين، والعودة الشمسية، وأفضل الأيام، والأماكن |
| MAX | $19.99 شهريًا أو $179 سنويًا | بلا حد يومي | كل شيء: العبور، ومقارنة الخريطتين، والعودة الشمسية، وأفضل الأيام، والأماكن |
Premium وMAX من باقات تطبيق NatalChart.AI: اشتراك واحد يشمل التطبيق وواجهة API وخادم MCP. والحصة لكل حساب، تتشاركها جميع مفاتيحه، وتتجدد عند الساعة 00:00 بتوقيت UTC. ولا يُحتسب الطلب المرفوض لعدم صلاحيته، ويُعاد إلى الحصة الطلب الذي يتعثر بسبب خلل من جهتنا، ولا تُخزَّن بيانات الميلاد أبدًا: يحتفظ السجل بنقطة النهاية والحالة والوقت فقط.
مقارنة بالبدائل
سبع واجهات API للتنجيم جنبًا إلى جنب، من صفحة الأسعار الخاصة بكل مزوّد، وقد جرى التحقق منها في 16 أكتوبر 2026. والأسعار تتغير، لذا يُرجى فتح الروابط قبل اتخاذ القرار.
| واجهة API | الباقة المجانية | أرخص باقة | طريقة احتساب الاستدعاءات | خادم MCP |
|---|---|---|---|---|
| NatalChart.AI | 10 طلبات يوميًا لنقاط النهاية الأساسية، بلا بطاقة دفع | Premium: $9.99 شهريًا مقابل 100 طلب يوميًا (نحو 3,000 طلب شهريًا). MAX: $19.99 شهريًا، بلا حد يومي. وكلتاهما تشمل جميع نقاط النهاية والتطبيق وخادم MCP. | طلب واحد لكل استدعاء، أيًّا كانت نقطة النهاية | نعم، 10 أدوات، وبالمفتاح المجاني أيضًا |
| AstrologyAPI.com | استدعاءات تجريبية، بلا بطاقة دفع | $49 شهريًا مقابل 50,000 طلب شهريًا (بيانات الخريطة الفلكية الغربية وعجلتها)؛ ومقارنة الخريطتين ابتداءً من $99 | طلبات حسب الباقة، أو محفظة رصيد | نعم |
| Astrology-API.io | 50 طلبًا شهريًا | $11 شهريًا مقابل 1,000 طلب شهريًا | وحدة رصيد واحدة لكل استدعاء؛ وبعض نقاط النهاية تكلّف أكثر | نعم |
| FreeAstroAPI | 80 طلبًا يوميًا، بلا بطاقة دفع | $8 شهريًا مقابل 50,000 طلب شهريًا | طلب واحد لكل استدعاء | نعم |
| Prokerala | 5,000 وحدة رصيد شهريًا | $19 شهريًا مقابل 100,000 وحدة رصيد | وحدات رصيد مرجّحة حسب نقطة النهاية (تكلّف الخريطة الفلكية الغربية 500 وحدة) | لا يوجد خادم رسمي |
| RoxyAPI | لا توجد (بيئة تجريبية بلا إنشاء حساب) | $39 شهريًا مقابل 50,000 طلب شهريًا | طلب واحد لكل استدعاء | نعم |
| AstroWay | 10,000 وحدة رصيد شهريًا | $5 شهريًا مقابل 50,000 وحدة رصيد | وحدات رصيد مرجّحة حسب نقطة النهاية | نعم |
ما لا تقدمه واجهة API هذه: دوائر بروج أو أنظمة بيوت أخرى، وصور الخرائط، وتقارير PDF، والتنجيم الفيدي، والتفسيرات المكتوبة. وتقدّمها عدة واجهات من المذكورة أعلاه. وما تقدمه: كل عملية حسابية مقابل طلب واحد ثابت، وتقرير الدقة الذي يقارن خريطة اختبار واحدة مع NASA JPL Horizons، وبيانات ميلاد لا تُخزَّن أبدًا.
أسئلة وأجوبة
هل توجد API مجانية للتنجيم؟
نعم. مفتاح NatalChart.AI مجاني ويمنح 10 طلبات يوميًا: الخرائط الفلكية كاملةً أو مجزأة، وسماء اليوم مع العبور على خريطة معيّنة، ومواقع الكواكب لأي تاريخ. ولا حاجة إلى بطاقة دفع. أما Premium ($9.99 شهريًا) فترفع الحصة إلى 100 يوميًا، وتفتح العبور خلال فترة، ومقارنة الخريطتين، والعودة الشمسية، وأفضل الأيام، والأستروكارتوغرافيا، ولا حد يوميًا في MAX ($19.99 شهريًا). وكلتاهما من باقات تطبيق NatalChart.AI، فاشتراك واحد يشمل التطبيق وواجهة API وخادم MCP.
ما مدى دقة الحسابات؟
تأتي المواقع من مكتبة Swiss Ephemeris، المعيار في برامج التنجيم الاحترافية، باستخدام ملفات بياناتها ومع تفعيل مؤشر السرعة. والمحرك نفسه يرسم كل خريطة في تطبيق NatalChart.AI، ويقارن تقرير الدقة مخرجاته لخريطة اختبار منشورة واحدة مع NASA JPL Horizons.
هل يمكنني بناء تطبيق للأبراج أو للتوافق عليها؟
نعم، فهذا هو الغرض منها: صفحات خريطة الميلاد، والأبراج اليومية المبنية على العبور الحقيقي، وتقييمات التوافق لمنتجات المواعدة، وأدوات اختيار أفضل الأيام، وخرائط الانتقال. والاستخدام التجاري مسموح في جميع الباقات؛ ويُرجى إبقاء المفتاح على خادمك.
هل تُرجع تفسيرات مكتوبة؟
لا. تحسب واجهة API الأرقام وتُرجعها: الأبراج، والدرجات، والبيوت، والجوانب مع الأورب، والتقييمات لكل مجال من مجالات الحياة. ولا توجد استدعاءات للذكاء الاصطناعي، لذا تعطي المدخلات نفسها دائمًا المخرجات نفسها، وتبقى الكلمات لك أو لنموذجك.
ما لغات البرمجة وأطر العمل التي تعمل معها؟
أي شيء يستطيع إرسال طلب HTTPS بجسم JSON: JavaScript وPython وPHP وSwift وKotlin، وأدوات العمل بلا برمجة. ويضم التوثيق أمثلة جاهزة للنسخ واللصق، ويصف مستند OpenAPI كل نقطة نهاية لمولّدات الشيفرة.
هل يمكن لمساعدي الذكاء الاصطناعي استخدامها؟
نعم، عبر خادم MCP: تتصل به Claude وChatGPT وCursor وVS Code بالمفتاح نفسه، وتستدعي الحسابات بوصفها أدوات.