מדריך HumanDesign.ai Agent HTTP API
APIעודכן ב-13 בנובמבר 2026קריאה של 2 דקות
סקירה כללית
Agent HTTP חושף את אותן שש פעולות חישוב וייחוס כנקודות קצה HTTP. השתמשו בו כאשר היישום שלכם זקוק לקריאות HTTP בעלות שמות במקום לפרוטוקול MCP.
נתיב בסיס: https://api.humandesign.ai/agent/v1/tools
אימות
כל בקשה משתמשת ב Authorization: Bearer YOUR_HDAI_API_KEY או X-Api-Key: YOUR_HDAI_API_KEY. פרטי גישה בשאילתת URL אינם נתמכים.
נקודות קצה
- POST. נתיב:
/resolve-timezone. מטרה: המרת מיקום לאזורי זמן ולמטא-נתונים גיאוגרפיים. - POST. נתיב:
/generate-chart. מטרה: יצירת מפה מולדת. - POST. נתיב:
/generate-composite-chart. מטרה: יצירת מפה משולבת לשני אנשים. - POST. נתיב:
/get-reference-item. מטרה: קריאת רשומת שער, ערוץ, מרכז או פרופיל. - POST. נתיב:
/get-transits. מטרה: קבלת תחזית או תשובת מפה מולדת לעומת מעבר. - POST. נתיב:
/search-celebrities. מטרה: חיפוש בקטלוג הדמויות הציבוריות.
פורמט התשובה
תשובות מוצלחות משתמשות במעטפת בעלת גרסה:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
האובייקט meta כולל מידע על הבקשה והמכסה. התייחסו לשדות התשובה כנתונים מובנים; אל תנתחו את טקסט הסיכום כמקור האמת.
גישה ומכסה
ה-API בודק זכאות לפני הפעלת פעולה. בקשה מוצלחת צורכת יחידת API משותפת אחת. הפעולות והמגבלות הזמינות תלויות בדרגת ה-API הנוכחית שלכם; בדקו זמינות עדכנית בקטלוג MCP המאומת או בכלי החשבון במקום להסתמך על טבלת תמחור מועתקת.