Tài liệu tham khảo HumanDesign.ai Agent HTTP API
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.