API للعبور

الطلب

طلب حقيقي للخريطة التوضيحية، لمدة شهر واحد:

curl -X POST https://api.natalchart.ai/v1/transits \
  -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},"from":"2026-09-18","to":"2026-10-18"}'

الاستجابة

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

{
  "window": {
    "from": "2026-09-18",
    "to": "2026-10-18"
  },
  "events": [
    {
      "kind": "aspect",
      "at": "2026-09-19T10:10:33.151Z",
      "date": "2026-09-19",
      "position": "14°06′ Libra",
      "house": 8,
      "body": "Mercury",
      "target": "Neptune",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "14°06′ Capricorn",
      "targetHouse": 11,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-22T09:53:49.800Z",
      "date": "2026-09-22",
      "position": "18°00′ Leo",
      "house": 7,
      "body": "Jupiter",
      "target": "Pluto",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "18°00′ Scorpio",
      "targetHouse": 8,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-23T20:47:58.234Z",
      "date": "2026-09-23",
      "position": "0°51′ Libra",
      "house": 7,
      "body": "Sun",
      "target": "Saturn",
      "aspect": "Trine",
      "exactness": 0,
      "targetPosition": "0°51′ Aquarius",
      "targetHouse": 12,
      "significance": "low"
    }
  ]
}

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

• window: التواريخ المطلوبة.
• events: حتى 60 حدثًا، هي الجوانب الدقيقة بين الأجرام العابرة وأجرام خريطة الميلاد، ودخول الكواكب إلى الأبراج، والتوقفات، مرتبةً حسب التاريخ، ولكلٍّ منها لحظته بتوقيت UTC وموقعه والبيوت المعنية. وإذا احتوت الفترة على أكثر من ذلك، يُبقى على الأهم.
• activeOnFirstDay: العبور الواقع ضمن حدود الأورب منذ اليوم الأول، مع حدود الأورب المستخدمة.
• يحمل كل حدث درجة أهمية (high أو medium أو low) تُحدَّد وفق الأجرام المعنية.

الحدود

• في API Pro فقط، وبحد أقصى 92 يومًا و60 حدثًا لكل طلب. وبالمفتاح المجاني تُجيب نقطة النهاية بالرمز 403 مع رابط للترقية.
• تواريخ الميلاد من 1800 إلى 2399. وتحتاج بيوت العبور إلى وقت الميلاد؛ ومن دونه تُحذف.
• تُحدَّد كل لحظة دقيقة بالبحث في مكتبة Swiss Ephemeris، وتُعطى بتوقيت UTC.
• تُقرأ بيانات الميلاد وتُستخدم ثم تُنسى: لا تُخزَّن أجسام الطلبات أبدًا.

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

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

بقية واجهة API

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

أسئلة وأجوبة