get_transits
השתמשו בשדה החוזה `natalChart` כדי לשלוח את נתוני מפת הגוף הבסיסיים, ולאחר מכן בקשו הקשר של מעברים נוכחיים או מתאריך מסוים. המזהה המילולי נשמר לתאימות עם ה-API.
תוצאה למפתחים: בנו חוויות סוכן התלויות בשעה בלי לחשב מיקומים פלנטריים בצד הלקוח.
פרמטרים
| שם | סוג | נדרש | תיאור |
|---|---|---|---|
date | מחרוזת (שעה מקומית לפי השעון שעל הקיר) | כן | רגע מעבר מפורש כשעה מקומית לפי השעון באזור הזמן שסופק, ללא Z וללא היסט UTC. MCP דורש זאת כדי שניסיון חוזר עם מפתח יתייחס לאותו רגע. התאריך יכול להיות בעתיד. |
timezone | מחרוזת | לא | אזור הזמן של IANA עבור רגע המעבר. |
natalChart | אובייקט | לא | קלט אופציונלי של מפת גוף הכולל birthDateTime ו-timezone. birthDateTime הוא שעה מקומית לפי השעון שעל הקיר, ללא Z וללא היסט UTC. שם השדה הוא חלק מחוזה המערכת בצד השרת. |
idempotencyKey | מחרוזת | כן | מפתח יציב לחישוב המעבר המתוכנן הזה. השתמשו בו שוב רק עם ארגומנטים זהים בעת ניסיון חוזר. |
שעות הלידה הן שעות מקומיות לפי השעון שעל הקיר. שלחו את תאריך ושעת הלידה כפי שהופיעו בשעון במקום הלידה, ללא Z וללא היסט UTC, וציינו בנפרד את אזור הזמן כמזהה IANA. הערך "birthDateTime": "1990-05-15T14:30:00" יחד עם "timezone": "America/New_York" מציין 14:30 בניו יורק.
הוצא משימוש: ערכים המסתיימים ב-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.