API للعودة الشمسية

الطلب

طلب حقيقي: العودة الشمسية للخريطة التوضيحية في عام 2027، في مكان الميلاد.

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -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},"year":2027}'

الاستجابة

جزء من الاستجابة لذلك الطلب: الحقول الرئيسية، مع اختصار كل قائمة إلى عناصرها الثلاثة الأولى.

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

ما تتضمنه الاستجابة

• exactMomentUtc: اللحظة التي تبلغ فيها الشمس طولها البروجي في خريطة الميلاد مجددًا، بتوقيت UTC.
• location: المكان الذي تُحسب له الخريطة؛ وهو مكان الميلاد ما لم يُرسَل مكان آخر.
• natalSun: الطول البروجي للشمس في خريطة الميلاد، الذي تُقاس منه العودة.
• chart: الخريطة الكاملة لتلك اللحظة وذلك المكان، بالبنية نفسها التي تُرجعها نقطة النهاية الخاصة بالخريطة الفلكية.

الحدود

• في API Pro فقط. وبالمفتاح المجاني تُجيب نقطة النهاية بالرمز 403 مع رابط للترقية.
• وقت الميلاد إلزامي.
• دائرة البروج المدارية وبيوت بلاسيدوس، وهي الإعدادات نفسها في خريطة الميلاد.
• تُقرأ بيانات الميلاد وتُستخدم ثم تُنسى: لا تُخزَّن أجسام الطلبات أبدًا.

في مساعد الذكاء الاصطناعي

عبر خادم MCP على https://www.natalchart.ai/mcp، يستدعي المساعدون الأداة solar_return، ويقرؤون العام المقبل من خريطة محسوبة.

بقية واجهة API

المفتاح نفسه يفتح واجهة API للتنجيم كاملةً: الخرائط الفلكية، والعبور اليومي، ومقارنة الخريطتين، والعبور خلال فترة، والعودة الشمسية، وأفضل الأيام، والأستروكارتوغرافيا. وكل نقاط النهاية (endpoints) والحقول والأخطاء موجودة في توثيق API، وتوضح صفحة الأسعار ما الذي يُحتسب طلبًا.

أسئلة وأجوبة