API للأبراج

الطلب

طلب حقيقي للخريطة التوضيحية:

curl -X POST https://api.natalchart.ai/v1/horoscope/daily \
  -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},"date":"2026-09-18"}'

الاستجابة

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

{
  "date": "2026-09-18",
  "computedFor": "2026-09-18T12:00:00.000Z",
  "moon": {
    "phase": "First Quarter",
    "illumination": 46.5,
    "elongation": 86.04,
    "sign": "Sagittarius",
    "longitude": 261.6344,
    "degreeInSign": 21.63,
    "theme": "Decision + Action",
    "nextNewMoon": {
      "utc": "2026-10-10T15:50:05.436Z",
      "sign": "Libra",
      "degreeInSign": 17.36,
      "absoluteDegree": 197.36
    },
    "nextFullMoon": {
      "utc": "2026-09-26T16:49:02.781Z",
      "sign": "Aries",
      "degreeInSign": 3.62,
      "absoluteDegree": 3.62
    }
  },
  "positions": [
    {
      "name": "Sun",
      "longitude": 175.5994,
      "sign": "Virgo",
      "degreeInSign": 25.6,
      "speed": 0.9761,
      "retrograde": false
    },
    {
      "name": "Moon",
      "longitude": 261.6344,
      "sign": "Sagittarius",
      "degreeInSign": 21.63,
      "speed": 11.8869,
      "retrograde": false
    }
  ],
  "events": [
    {
      "kind": "ingress",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    },
    {
      "kind": "equinox",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    }
  ],
  "transits": [
    {
      "transit": "Vesta",
      "natal": "Mercury",
      "aspect": "Trine",
      "angle": 119.93,
      "orb": 0.07,
      "phase": "applying",
      "exactAt": "2026-09-18T21:43:39.997Z",
      "tone": "supportive",
      "transitHouse": 2,
      "houseTheme": "Money & Possessions"
    },
    {
      "transit": "Uranus",
      "natal": "Lilith",
      "aspect": "Trine",
      "angle": 119.86,
      "orb": 0.14,
      "phase": "separating",
      "exactAt": null,
      "tone": "supportive",
      "transitHouse": 3,
      "houseTheme": "Communication & Learning"
    }
  ],
  "focus": [
    {
      "transit": "Pluto",
      "natal": "Mars",
      "aspect": "Trine",
      "angle": 119.78,
      "orb": 0.22,
      "phase": "separating",
      "exactAt": "2026-09-03T17:58:04.996Z",
      "tone": "supportive",
      "transitHouse": 12,
      "houseTheme": "Spirituality & Subconscious"
    },
    {
      "transit": "Neptune",
      "natal": "Mars",
      "aspect": "Opposition",
      "angle": 179.74,
      "orb": 0.26,
      "phase": "separating",
      "exactAt": "2026-09-09T00:24:29.005Z",
      "tone": "challenging",
      "transitHouse": 1,
      "houseTheme": "Identity & Self"
    },
    {
      "transit": "Jupiter",
      "natal": "Moon",
      "aspect": "Conjunction",
      "angle": 1.77,
      "orb": 1.77,
      "phase": "applying",
      "exactAt": "2026-09-27T20:40:07.004Z",
      "tone": "intensifying",
      "transitHouse": 7,
      "houseTheme": "Partnerships & Marriage"
    }
  ]
}

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

• positions: موقع كل جرم عند الظهر بتوقيت UTC في ذلك التاريخ، بالبرج والدرجة.
• moon: الطور، ونسبة الإضاءة، وبرج القمر، وموعد القمر الجديد التالي وموعد البدر التالي.
• events: الأحداث الفلكية للأسبوع القادم، مثل دخول الكواكب إلى الأبراج والتوقفات.
• transits: مع بيانات الميلاد، كل عبور على خريطة الميلاد، مع الجانب، والأورب، وهل هو مقترب أم متباعد، واللحظة الدقيقة، وبيت خريطة الميلاد الذي يقع فيه الجرم العابر.
• focus: الصلات الثلاث الأعلى ترتيبًا حسب سرعة الكوكب ودقة الجانب، ولكلٍّ منها tone وفق قاعدة ثابتة (supportive للتثليث والتسديس، وchallenging للتربيع والمقابلة، وintensifying للاقتران).

الحدود

• المفتاح المجاني: 10 طلبات يوميًا؛ وAPI Pro: 1,000.
• حدود الأورب للعبور: 2° للقمر والشمس وعطارد والزهرة والمريخ، و3° للأجرام الأبطأ.
• لا نصوص حسب برج الشمس ولا نص مولَّد: تُرجع نقطة النهاية أرقامًا لخريطة واحدة.
• تُقرأ بيانات الميلاد وتُستخدم ثم تُنسى: لا تُخزَّن أجسام الطلبات أبدًا.

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

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

بقية واجهة API

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

أسئلة وأجوبة