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.