เอกสารอ้างอิง HumanDesign.ai Agent HTTP API
ภาพรวม
Agent HTTP เปิดให้ใช้การดำเนินการด้านการคำนวณและข้อมูลอ้างอิงทั้งหกรายการเดียวกันในรูปแบบ HTTP endpoint ใช้เมื่อแอปพลิเคชันต้องการเรียก HTTP ที่มีชื่อแทนโปรโตคอล MCP
Base path: https://api.humandesign.ai/agent/v1/tools
การยืนยันตัวตน
ทุกคำขอใช้วิธีใดวิธีหนึ่งต่อไปนี้ Authorization: Bearer YOUR_HDAI_API_KEY หรือ X-Api-Key: YOUR_HDAI_API_KEY. ไม่รองรับข้อมูลรับรองใน query string
Endpoints
- POST. Path:
/resolve-timezone. วัตถุประสงค์: แปลงสถานที่เป็นเขตเวลาและข้อมูลเมตาทางภูมิศาสตร์ - POST. Path:
/generate-chart. วัตถุประสงค์: สร้างแผนภูมิดวงกำเนิด - POST. Path:
/generate-composite-chart. วัตถุประสงค์: สร้างแผนภูมิคอมโพสิตสำหรับคนสองคน - POST. Path:
/get-reference-item. วัตถุประสงค์: อ่านระเบียนเกต ช่อง เซ็นเตอร์ หรือโปรไฟล์ - POST. Path:
/get-transits. วัตถุประสงค์: รับการพยากรณ์หรือการตอบกลับที่เปรียบเทียบดวงกำเนิดกับทรานซิต - POST. Path:
/search-celebrities. วัตถุประสงค์: ค้นหาแค็ตตาล็อกบุคคลสาธารณะ
รูปแบบการตอบกลับ
การตอบกลับที่สำเร็จใช้ envelope ที่มีเวอร์ชัน:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
แท็บ meta ออบเจ็กต์มีข้อมูลคำขอและโควตา ให้ถือว่าฟิลด์การตอบกลับเป็นข้อมูลแบบมีโครงสร้าง อย่าใช้ข้อความสรุปเป็นแหล่งข้อมูลหลัก
การเข้าถึงและโควตา
API จะตรวจสอบสิทธิ์ก่อนดำเนินการ คำขอที่สำเร็จแต่ละครั้งจะใช้หน่วย API ร่วมกัน 1 หน่วย การดำเนินการและขีดจำกัดที่ใช้ได้ขึ้นอยู่กับระดับ API ปัจจุบัน โปรดตรวจสอบความพร้อมใช้งานล่าสุดผ่านแค็ตตาล็อก MCP ที่ผ่านการยืนยันตัวตนหรือเครื่องมือบัญชี แทนการอ้างอิงตารางราคาเก่าที่คัดลอกไว้