HumanDesign.aiPersonalMở ứng dụng ↗
DÀNH CHO BẢN THÂN BẠNTrung tâm trợ giúp

Tài liệu tham khảo HumanDesign.ai Agent HTTP API

APICập nhật ngày 13 tháng 11 năm 2026Đọc trong 2 phút

Tổng quan

Agent HTTP cung cấp sáu thao tác tính toán và tham chiếu tương tự dưới dạng endpoint HTTP. Hãy dùng giao diện này khi ứng dụng cần gọi HTTP theo tên thay vì dùng giao thức MCP.

Đường dẫn cơ sở: https://api.humandesign.ai/agent/v1/tools

Xác thực

Mỗi yêu cầu sử dụng một trong hai cách Authorization: Bearer YOUR_HDAI_API_KEY hoặc X-Api-Key: YOUR_HDAI_API_KEY. Không hỗ trợ thông tin xác thực trong query string.

Endpoint

  • POST. Đường dẫn: /resolve-timezone. Mục đích: phân giải địa điểm thành múi giờ và siêu dữ liệu địa lý.
  • POST. Đường dẫn: /generate-chart. Mục đích: tạo biểu đồ bẩm sinh.
  • POST. Đường dẫn: /generate-composite-chart. Mục đích: tạo biểu đồ tổng hợp cho hai người.
  • POST. Đường dẫn: /get-reference-item. Mục đích: đọc bản ghi cổng, kênh, trung tâm hoặc hồ sơ.
  • POST. Đường dẫn: /get-transits. Mục đích: nhận dự báo hoặc phản hồi biểu đồ bẩm sinh so với quá cảnh.
  • POST. Đường dẫn: /search-celebrities. Mục đích: tìm kiếm danh mục nhân vật công chúng.

Định dạng phản hồi

Phản hồi thành công sử dụng phong bì có phiên bản:

{
  "version": "v1",
  "tool": "generate_chart",
  "data": {},
  "meta": {},
  "error": null
}

Ứng dụng meta đối tượng chứa thông tin yêu cầu và hạn mức. Hãy xử lý các trường phản hồi như dữ liệu có cấu trúc; không dùng văn bản tóm tắt làm nguồn dữ liệu chuẩn.

Quyền truy cập và hạn mức

API kiểm tra quyền sử dụng trước khi chạy thao tác. Mỗi yêu cầu thành công tiêu thụ một đơn vị API dùng chung. Thao tác và giới hạn khả dụng phụ thuộc cấp API hiện tại; hãy truy xuất trạng thái mới nhất qua danh mục MCP đã xác thực hoặc công cụ tài khoản thay vì dựa vào bảng giá đã sao chép.

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.