get_transits
ใช้ฟิลด์ตามสัญญา `natalChart` เพื่อส่งข้อมูลบอดี้กราฟต้นทาง แล้วขอบริบททรานซิตปัจจุบันหรือระบุวันที่ โดยคงตัวระบุตามตัวอักษรไว้เพื่อความเข้ากันได้ของ API
ผลลัพธ์สำหรับนักพัฒนา: สร้างประสบการณ์เอเจนต์ที่คำนึงถึงเวลา โดยไม่ต้องคำนวณตำแหน่งดาวเคราะห์ในไคลเอนต์
พารามิเตอร์
| ชื่อ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
date | string (เวลาท้องถิ่นตามนาฬิกา) | ใช่ | ช่วงเวลาทรานซิตที่ระบุเป็นเวลาท้องถิ่นตามนาฬิกาในเขตเวลาที่ให้มา โดยไม่มี Z หรือส่วนต่าง MCP ต้องใช้ค่านี้เพื่อให้การลองซ้ำโดยใช้คีย์อ้างอิงช่วงเวลาเดิม และอาจเป็นเวลาในอนาคตได้ |
timezone | string | ไม่ | เขตเวลา IANA สำหรับช่วงเวลาทรานซิต |
natalChart | object | ไม่ | อินพุตวันเกิดของบอดี้กราฟ (ไม่บังคับ) ที่มี birthDateTime และ timezone โดย birthDateTime เป็นเวลาท้องถิ่นตามนาฬิกา ไม่มี Z หรือส่วนต่าง ชื่อฟิลด์เป็นส่วนหนึ่งของสัญญาแบ็กเอนด์ |
idempotencyKey | string | ใช่ | คีย์ที่เสถียรสำหรับการคำนวณทรานซิตตามที่ตั้งใจไว้ ใช้คีย์เดิมเฉพาะเมื่อลองซ้ำด้วยอาร์กิวเมนต์เดิมเท่านั้น |
เวลาเกิดเป็นเวลาท้องถิ่นตามนาฬิกา ส่งวันและเวลาเกิดตามที่นาฬิกาแสดง ณ สถานที่เกิด โดยไม่มี 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 unit ร่วมกัน 1 หน่วยพอดี แม้ขั้นตอนแสดงผลภายหลังจะล้มเหลว อินพุตผิดรูปแบบหรือกำกวม ระดับสิทธิ์ที่ถูกปฏิเสธ ข้อมูลอ้างอิงที่ไม่รู้จัก และข้อผิดพลาดอื่นก่อนถึงผู้ให้บริการจะใช้ 0 หน่วย ตรวจสอบการใช้งานปัจจุบันที่ my.humandesign.ai.