واجهة API من NatalChart.AI هي محرك الحساب في تطبيق NatalChart.AI، مفتوحًا للمطورين. يكفي إرسال تاريخ الميلاد ووقته وإحداثيات مكانه لتعود الخريطة: لا ملفات تقويم فلكي تحتاج إلى استضافة، ولا جداول مناطق زمنية تحتاج إلى صيانة، ولا مكتبة تنجيم تحتاج إلى تحديث.
ما يمكنك بناؤه
صفحات خريطة الميلاد
الشمس والقمر والبرج الصاعد، وكل كوكب في برجه وبيته، والجوانب مع الأورب، وتوازن العناصر، لأي تاريخ ميلاد من 1800 إلى 2399. /v1/chart/full, /v1/chart/short
أبراج يومية من السماء الحقيقية
عبور اليوم على خريطة الشخص، مع الأورب الخاص بكل عبور وهل هو يشتد أم يخفت، إضافةً إلى طور القمر والأحداث الفلكية للأسبوع. /v1/horoscope/daily, /v1/sky
التوافق لمنتجات المواعدة
مقارنة خريطتين: كل جانب بينهما، والبيوت التي تقع فيها كواكب كل شخص في خريطة الآخر، وتقييم لكل مجال من مجالات الحياة. /v1/synastry
التوقعات والسنة المقبلة
كل عبور دقيق في فترة تصل إلى 92 يومًا، وخريطة العودة الشمسية لأي سنة، في مكان الميلاد أو حيثما سيكون الشخص. /v1/transits, /v1/solar-return
أفضل الأيام
كل يوم في فترة معيّنة مقيَّمًا لنشاط ما (العمل، والحب، والسفر، والصحة، وغيرها)، مع العبور الداعم له والمعيق. /v1/timing
الأستروكارتوغرافيا والانتقال
تقييم مدينة واحدة مقابل خريطة، أو ترتيب المدن الكبرى في العالم لها، حسب مجال الحياة والمنطقة. /v1/locations/score, /v1/locations/rank
البدء في دقيقة
يكفي إنشاء مفتاح (مجانًا، بلا بطاقة دفع)، ثم إرسال بيانات ميلاد:
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 لمولّدات الشيفرة.
دقة قابلة للتحقق
دائرة البروج المدارية، وبيوت بلاسيدوس، والجوانب الرئيسية الخمسة، والعقدة القمرية الحقيقية، ومواقع بأربع منازل عشرية من الدرجة. وتُحدَّد المنطقة الزمنية من الإحداثيات وفق قواعد التوقيت الصيفي في تاريخ الميلاد، وإذا كان وقت الميلاد غير معروف تُحجب البيوت والأوتاد بدل تخمينها. ويقارن تقرير الدقة المحرك مع NASA JPL Horizons، وتتيح لك الخريطة التوضيحية المنشورة التحقق من الاستجابة قبل كتابة أي شيفرة.
لمساعدي الذكاء الاصطناعي: خادم MCP
الحسابات نفسها متاحة في صورة خادم MCP على https://www.natalchart.ai/mcp. تتصل به Claude وChatGPT وCursor وVS Code بالمفتاح نفسه، وتستدعي بنفسها أدوات الخريطة والعبور والتوافق، فيقرأ المساعد خريطة محسوبة لا مخمَّنة.
الأسعار
| الباقة | السعر | الطلبات | نقاط النهاية |
|---|---|---|---|
| الباقة المجانية | $0 | 10 يوميًا | الخرائط وأجزاؤها، والأبراج اليومية، والسماء، والاستخدام |
| API Pro | $6.99 شهريًا | 1,000 يوميًا | كل شيء: العبور، ومقارنة الخريطتين، والعودة الشمسية، وأفضل الأيام، والأماكن |
الحصة لكل حساب، وتتجدد عند الساعة 00:00 بتوقيت UTC. ولا يُحتسب الطلب المرفوض لعدم صلاحيته، ولا تُخزَّن بيانات الميلاد أبدًا: يحتفظ السجل بنقطة النهاية والحالة والوقت فقط.
أسئلة وأجوبة
هل توجد API مجانية للتنجيم؟
نعم. مفتاح NatalChart.AI مجاني ويمنح 10 طلبات يوميًا: الخرائط الفلكية كاملةً أو مجزأة، وسماء اليوم مع العبور على خريطة معيّنة، ومواقع الكواكب لأي تاريخ. ولا حاجة إلى بطاقة دفع. أما API Pro ($6.99 شهريًا) فترفع الحصة إلى 1,000 يوميًا، وتفتح العبور خلال فترة، ومقارنة الخريطتين، والعودة الشمسية، وأفضل الأيام، والأستروكارتوغرافيا.
ما مدى دقة الحسابات؟
تأتي المواقع من مكتبة Swiss Ephemeris، المعيار في برامج التنجيم الاحترافية، باستخدام ملفات بياناتها ومع تفعيل مؤشر السرعة. والمحرك نفسه يرسم كل خريطة في تطبيق NatalChart.AI، ويقارن تقرير الدقة مخرجاته مع NASA JPL Horizons.
هل يمكنني بناء تطبيق للأبراج أو للتوافق عليها؟
نعم، فهذا هو الغرض منها: صفحات خريطة الميلاد، والأبراج اليومية المبنية على العبور الحقيقي، وتقييمات التوافق لمنتجات المواعدة، وأدوات اختيار أفضل الأيام، وخرائط الانتقال. والاستخدام التجاري مسموح في الباقتين؛ ويُرجى إبقاء المفتاح على خادمك.
هل تُرجع تفسيرات مكتوبة؟
لا. تحسب واجهة API الأرقام وتُرجعها: الأبراج، والدرجات، والبيوت، والجوانب مع الأورب، والتقييمات لكل مجال من مجالات الحياة. ولا توجد استدعاءات للذكاء الاصطناعي، لذا تعطي المدخلات نفسها دائمًا المخرجات نفسها، وتبقى الكلمات لك أو لنموذجك.
ما لغات البرمجة وأطر العمل التي تعمل معها؟
أي شيء يستطيع إرسال طلب HTTPS بجسم JSON: JavaScript وPython وPHP وSwift وKotlin، وأدوات العمل بلا برمجة. ويضم التوثيق أمثلة جاهزة للنسخ واللصق، ويصف مستند OpenAPI كل نقطة نهاية لمولّدات الشيفرة.
هل يمكن لمساعدي الذكاء الاصطناعي استخدامها؟
نعم، عبر خادم MCP: تتصل به Claude وChatGPT وCursor وVS Code بالمفتاح نفسه، وتستدعي الحسابات بوصفها أدوات.