HumanDesign.aiMCPMở ứng dụng ↗
DÀNH CHO AI CỦA BẠNTài Liệu
Công cụ MCP dành cho Startup

get_transits

Dùng trường contract `natalChart` để gửi dữ liệu bodygraph nền, sau đó yêu cầu ngữ cảnh quá cảnh hiện tại hoặc theo ngày. Định danh nguyên văn được giữ lại để tương thích API.

Kết quả dành cho nhà phát triển: Tạo trải nghiệm tác nhân nhạy theo thời gian mà không cần tính vị trí hành tinh ở phía máy khách.

Tham số

TênLoạiBắt buộcMô tả
datechuỗi (giờ địa phương trên đồng hồ)CóThời điểm quá cảnh cụ thể theo giờ địa phương trên đồng hồ tại múi giờ được cung cấp, không có Z và không có độ lệch UTC. MCP yêu cầu giá trị này để yêu cầu thử lại có khóa trỏ đến cùng một thời điểm. Thời điểm có thể nằm trong tương lai.
timezonechuỗiKhôngMúi giờ IANA của thời điểm quá cảnh.
natalChartđối tượngKhôngDữ liệu sinh bodygraph tùy chọn gồm birthDateTime và timezone. birthDateTime là giờ địa phương trên đồng hồ, không có Z và không có độ lệch UTC. Tên trường là một phần của contract backend.
idempotencyKeychuỗiCóKhóa ổn định cho phép tính quá cảnh dự kiến này. Chỉ dùng lại khóa này khi thử lại với các đối số giống hệt.

Giờ sinh là giờ trên đồng hồ địa phương. Gửi ngày giờ sinh theo giờ hiển thị trên đồng hồ tại nơi người đó sinh ra, không có Z và không có độ lệch UTC; cung cấp riêng múi giờ dưới dạng mã IANA. "birthDateTime": "1990-05-15T14:30:00" cùng "timezone": "America/New_York" có nghĩa là hai giờ rưỡi chiều ở New York.

Đã lỗi thời: Các giá trị kết thúc bằng Z hoặc độ lệch số đã lỗi thời. Hiện MCP chuyển tiếp chúng và API vẫn chấp nhận tạm thời, đọc chúng như UTC và thông báo việc ngừng dùng trong phản hồi API. Chúng sẽ không còn được chấp nhận; ngày áp dụng sẽ được thông báo trước. Đọc toàn bộ quy tắc.

Yêu cầu

JSON-RPC đã làm sạch

{
  "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"
    }
  }
}

Cấu trúc phản hồi thành công

  • Vị trí các hành tinh khi quá cảnh
  • Các cổng và kênh được kích hoạt
  • Kết nối với dữ liệu bodygraph được cung cấp

Phản hồi cũng bao gồm siêu dữ liệu cấp gói và hạn mức do lớp quyền API cung cấp. Các trường cụ thể theo miền thay đổi tùy công cụ và mức độ chi tiết được yêu cầu.

Lỗi

  • Cần gói Startup
  • Dữ liệu bodygraph không hợp lệ
  • Ngày quá cảnh không hợp lệ
  • Đã vượt hạn mức

Cách tính hạn mức

Sau khi xác thực đầu vào, cấp quyền và kiểm tra cấp gói thành công, mỗi lần thực thi đi đến nhà cung cấp tính toán sẽ tiêu thụ chính xác một đơn vị API dùng chung, kể cả khi bước trình bày sau đó thất bại. Đầu vào sai định dạng hoặc mơ hồ, cấp gói bị từ chối, tham chiếu không xác định và các lỗi khác xảy ra trước nhà cung cấp sẽ không tiêu thụ đơn vị nào. Kiểm tra mức sử dụng hiện tại tại my.humandesign.ai.

generate_chart · get_reference_item

Lên đầu trang ↑Cần trợ giúp? Liên hệ bộ phận hỗ trợ ↗

Tìm câu trả lời tiếp theo.