API لمقارنة الخريطتين (السيناستري)

الطلب

طلب حقيقي لشخصين افتراضيين: بيانات الميلاد التوضيحية في كييف، وميلاد ثانٍ في نيويورك.

curl -X POST https://api.natalchart.ai/v1/synastry \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personA":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"personB":{"date":"1989-03-14","time":"07:45","latitude":40.7128,"longitude":-74.006}}'

الاستجابة

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

{
  "aspects": [
    {
      "personA": "Neptune",
      "personB": "Lilith",
      "aspect": "Trine",
      "angle": 120.08,
      "orb": 0.08
    },
    {
      "personA": "Saturn",
      "personB": "Jupiter",
      "aspect": "Trine",
      "angle": 119.66,
      "orb": 0.34
    },
    {
      "personA": "Mercury",
      "personB": "Moon",
      "aspect": "Sextile",
      "angle": 60.38,
      "orb": 0.38
    }
  ],
  "sphereScores": {
    "identity": 89,
    "love": 81,
    "body": 86,
    "money": 76,
    "home": 83,
    "mind": 66
  }
}

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

• aspects: كل جانب رئيسي بين جرم من إحدى الخريطتين وجرم من الأخرى، مع زاويته والأورب الخاص به.
• overlays: البيت الذي تقع فيه كواكب كل شخص في خريطة الآخر، في الاتجاهين. وتكون قيمة أحد الاتجاهين null إذا كان وقت ميلاد الشخص الآخر غير معروف، لأن البيوت تعتمد عليه.
• sphereScores: الهوية، والحب، والجسد، والمال، والمنزل، والعقل، كلٌّ منها من 0 إلى 100، مبنية على الجوانب بين الخريطتين (60%) وتراكب البيوت (40%).
• scoring: القاعدة التي تقوم عليها التقييمات، مذكورة في الاستجابة. وهي تصف هندسة خريطتين، لا مستقبل علاقة.

الحدود

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

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

يقدّم خادم MCP على https://www.natalchart.ai/mcp الحساب نفسه في صورة الأداة synastry، فيستطيع Claude أو ChatGPT أو Cursor مقارنة خريطتين قبل الحديث عن التوافق.

بقية واجهة API

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

أسئلة وأجوبة