HumanDesign.aiMCPافتح التطبيق ↗
لوكلاء الذكاء الاصطناعي لديكالتوثيق
أداة MCP لفئة Startup

get_transits

استخدم حقل العقد `natalChart` لإرسال بيانات المخطط الجسدي الأساسي، ثم اطلب سياق العبور الحالي أو المؤرخ. ويظل المعرّف الحرفي كما هو للتوافق مع API.

النتيجة للمطور: أنشئ تجارب لوكلاء تراعي الوقت دون حساب مواقع الكواكب في العميل.

المعلمات

الاسمالنوعمطلوبالوصف
dateسلسلة نصية (التوقيت المحلي على الساعة)نعملحظة عبور محددة بالتوقيت المحلي على الساعة في المنطقة الزمنية المقدمة، دون Z أو إزاحة UTC. يتطلبها MCP كي تشير إعادة المحاولة ذات المفتاح إلى اللحظة نفسها. وقد تكون في المستقبل.
timezoneسلسلة نصيةلامنطقة IANA الزمنية للحظة العبور.
natalChartكائنلامدخل اختياري للمخطط الجسدي، يتضمن birthDateTime والمنطقة الزمنية. ويمثل birthDateTime توقيتًا محليًا على الساعة دون Z أو إزاحة UTC. واسم الحقل جزء من عقد الواجهة الخلفية.
idempotencyKeyسلسلة نصيةنعممفتاح ثابت لحساب العبور المقصود. أعد استخدامه فقط مع الوسائط نفسها عند إعادة المحاولة.

أوقات الميلاد هي أوقات الساعة المحلية. أرسل تاريخ الميلاد ووقته كما أظهرته الساعة في مكان الميلاد، دون Z أو إزاحة UTC، وحدد المنطقة الزمنية منفصلةً باستخدام معرف IANA. وتعني "birthDateTime": "1990-05-15T14:30:00" مع "timezone": "America/New_York" الثانية والنصف ظهرًا في نيويورك.

مهمل: أُوقف استخدام القيم التي تنتهي بـ Z أو إزاحة رقمية. يمررها MCP ولا يزال API يقبلها مؤقتًا، ويقرأها باعتبارها UTC، مع الإعلان عن إيقافها في استجابة API. وسيتوقف قبولها في موعد سيُعلن عنه مسبقًا. اقرأ القاعدة كاملة.

الطلب

JSON-RPC بعد تنقيته

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_transits",
    "arguments": {
      "date": "2026-08-06T12:00:00",
      "timezone": "UTC",
      "natalChart": {
        "birthDateTime": "1990-05-15T14:30:00",
        "timezone": "America/New_York"
      },
      "idempotencyKey": "transits-2026-08-06-v1"
    }
  }
}

شكل استجابة النجاح

  • مواقع الكواكب أثناء العبور
  • البوابات والقنوات المفعّلة
  • روابط إلى مدخل المخطط الجسدي المقدم

تتضمن الاستجابة أيضًا بيانات الفئة والحصة من طبقة استحقاق API. وتختلف حقول المجال الدقيقة بحسب الأداة ومستوى التفاصيل المطلوب.

الأخطاء

  • يتطلب فئة Startup
  • مدخلات المخطط الجسدي غير صالحة
  • تاريخ عبور غير صالح
  • تجاوز الحصة

سلوك الحصة

بعد اجتياز التحقق من المدخلات والتفويض والفئة، تستهلك محاولة التنفيذ التي تصل إلى مزود الحساب وحدة API مشتركة واحدة بالضبط، حتى إذا فشلت خطوة عرض لاحقة. ولا تستهلك المدخلات المشوهة أو الملتبسة والفئات المرفوضة والمراجع غير المعروفة وغيرها من حالات الفشل السابقة للمزود أي وحدات. تحقق من الاستخدام الحالي على my.humandesign.ai.

generate_chart · get_reference_item

العودة إلى الأعلى ↑هل تحتاج إلى مساعدة؟ تواصل مع الدعم ↗

اعثر على إجابتك التالية.