get_transits
अंतर्निहित bodygraph डेटा देने के लिए contract फ़ील्ड `natalChart` उपयोग करें, फिर वर्तमान या दिनांकित transit संदर्भ माँगें। यह अक्षरशः पहचानकर्ता API संगतता के लिए जस का तस है।
डेवलपर लाभ: क्लाइंट में ग्रहों की स्थिति गणना किए बिना समय-संवेदी एजेंट अनुभव बनाएँ।
पैरामीटर
| नाम | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
date | string (स्थानीय घड़ी का समय) | हाँ | दिए समय क्षेत्र में स्थानीय घड़ी के समय के रूप में स्पष्ट transit क्षण दें, बिना Z और UTC offset के। MCP इसे आवश्यक बनाता है ताकि keyed retry उसी क्षण को संदर्भित करे। यह भविष्य में हो सकता है। |
timezone | string | नहीं | Transit क्षण के लिए IANA समय क्षेत्र। |
natalChart | object | नहीं | birthDateTime और timezone सहित वैकल्पिक bodygraph जन्म इनपुट। birthDateTime स्थानीय घड़ी का समय है, बिना Z और UTC offset के। फ़ील्ड नाम backend contract का हिस्सा है। |
idempotencyKey | string | हाँ | इस transit गणना के लिए स्थिर कुंजी। retry करते समय इसे केवल समान तर्कों के साथ उपयोग करें। |
जन्म समय स्थानीय घड़ी का समय होता है। जन्म-तिथि और समय ठीक वैसे भेजें जैसे जन्मस्थान की घड़ी में थे, बिना Z और UTC offset के; timezone अलग से IANA पहचानकर्ता के रूप में दें। "birthDateTime": "1990-05-15T14:30:00" और "timezone": "America/New_York" का अर्थ न्यूयॉर्क में दोपहर के ढाई बजे है।
अप्रचलित: Z या संख्यात्मक offset पर समाप्त होने वाले मान पुराने माने जाते हैं। 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"
}
}
}सफल प्रतिक्रिया का स्वरूप
- Transit ग्रह स्थितियाँ
- सक्रिय gate और channel
- दिए गए bodygraph इनपुट से संबंध
प्रतिक्रिया में API अधिकार परत द्वारा दिया गया स्तर और कोटा मेटाडेटा भी होता है। सटीक domain फ़ील्ड टूल और माँगे गए विवरण स्तर के अनुसार बदलते हैं।
त्रुटियाँ
- Startup स्तर आवश्यक
- अमान्य bodygraph इनपुट
- अमान्य transit तारीख
- कोटा समाप्त
कोटा व्यवहार
इनपुट सत्यापन, प्राधिकरण और स्तर जाँच सफल होने के बाद, गणना प्रदाता तक पहुँचने वाला execution प्रयास ठीक एक साझा API यूनिट लेता है—भले बाद का प्रस्तुति चरण विफल हो जाए। गलत या अस्पष्ट इनपुट, अस्वीकृत स्तर, अज्ञात संदर्भ और अन्य प्रदाता-पूर्व विफलताएँ शून्य यूनिट लेती हैं। वर्तमान उपयोग यहाँ देखें my.humandesign.ai.