API للأستروكارتوغرافيا

الطلب

طلب حقيقي: الخريطة التوضيحية مقابل لشبونة.

curl -X POST https://api.natalchart.ai/v1/locations/score \
  -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},"location":{"name":"Lisbon","latitude":38.7223,"longitude":-9.1393}}'

الاستجابة

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

{
  "relocated": {
    "ascendant": {
      "longitude": 277.7847,
      "sign": "Capricorn"
    },
    "midheaven": {
      "longitude": 210.708,
      "sign": "Scorpio"
    }
  },
  "angularPlanets": [
    {
      "planet": "Uranus",
      "angle": "ASC",
      "orb": 2.12,
      "weight": "major",
      "strength": "strong"
    },
    {
      "planet": "Neptune",
      "angle": "ASC",
      "orb": 6.31,
      "weight": "major",
      "strength": "weak"
    }
  ],
  "spheres": {
    "identity": {
      "score10": 1,
      "verdict": "challenging"
    },
    "love": {
      "score10": 6.1,
      "verdict": "slightly supportive"
    },
    "body": {
      "score10": 3.2,
      "verdict": "challenging"
    },
    "money": {
      "score10": 2.2,
      "verdict": "challenging"
    },
    "home": {
      "score10": 1.7,
      "verdict": "challenging"
    },
    "mind": {
      "score10": 4.9,
      "verdict": "neutral"
    }
  },
  "overall10": 2.2,
  "strength": "moderate"
}

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

• relocated: الطالع ووسط السماء اللذان تأخذهما الخريطة في ذلك المكان.
• angularPlanets: الكواكب الواقعة على تلك الأوتاد، ولكلٍّ منها وتده والأورب الخاص به وقوته.
• spheres: الهوية، والحب، والجسد، والمال، والمنزل، والعقل، كلٌّ منها من 0 إلى 10، و5 تعني الحياد؛ ويلخّصها overall10.
• strength: قوي حين يقع كوكب رئيسي في حدود 2° من أحد الأوتاد، ومتوسط في حدود 4°، وضعيف فيما عدا ذلك. وتأتي القواعد مع الاستجابة.
• تُرجع نقطة النهاية POST /v1/locations/rank أفضل المدن من الفهرس، حسب المجالات الستة كلها أو حسب المجالات المختارة، على مستوى العالم أو في منطقة واحدة.

الحدود

• في API Pro فقط. وبالمفتاح المجاني تُجيب نقطتا النهاية بالرمز 403 مع رابط للترقية.
• وقت الميلاد إلزامي: فالانتقال يحرّك الأوتاد، والأوتاد تحتاج إلى الوقت.
• يقارن الترتيب بين 61 من المدن الكبرى، لا بين كل الأماكن على الأرض؛ ويمكن تقييم أي مكان آخر بنقطة النهاية POST /v1/locations/score.
• تُقرأ بيانات الميلاد وتُستخدم ثم تُنسى: لا تُخزَّن أجسام الطلبات أبدًا.

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

عبر خادم MCP على https://www.natalchart.ai/mcp، يستدعي المساعدون الأداة location_score لمكان واحد، والأداة best_cities لأفضل المدن.

بقية واجهة API

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

أسئلة وأجوبة