HumanDesign.ai Agent HTTP API संदर्भ
अवलोकन
Agent HTTP वही छह गणना और संदर्भ ऑपरेशन HTTP एंडपॉइंट के रूप में देता है। जब आपका ऐप MCP प्रोटोकॉल के बजाय नामित HTTP कॉल चाहता है, तब इसका उपयोग करें।
आधार पाथ: https://api.humandesign.ai/agent/v1/tools
प्रमाणीकरण
हर अनुरोध इनमें से किसी एक का उपयोग करता है Authorization: Bearer YOUR_HDAI_API_KEY या X-Api-Key: YOUR_HDAI_API_KEY। Query-string क्रेडेंशियल समर्थित नहीं हैं।
एंडपॉइंट
- POST। पाथ:
/resolve-timezone। उद्देश्य: स्थान को timezone और भौगोलिक मेटाडेटा में बदलें। - POST। पाथ:
/generate-chart। उद्देश्य: जन्म कुंडली चार्ट बनाएँ। - POST। पाथ:
/generate-composite-chart। उद्देश्य: दो लोगों का कंपोज़िट चार्ट बनाएँ। - POST। पाथ:
/get-reference-item। उद्देश्य: गेट, चैनल, सेंटर या प्रोफ़ाइल रिकॉर्ड पढ़ें। - POST। पाथ:
/get-transits। उद्देश्य: पूर्वानुमान या जन्म-कुंडली बनाम ट्रांज़िट रिस्पॉन्स पाएँ। - POST। पाथ:
/search-celebrities। उद्देश्य: सार्वजनिक हस्तियों का कैटलॉग खोजें।
रिस्पॉन्स प्रारूप
सफल रिस्पॉन्स versioned envelope का उपयोग करते हैं:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
यह meta object में अनुरोध और कोटा जानकारी शामिल है। रिस्पॉन्स फ़ील्ड को संरचित डेटा मानें; सारांश टेक्स्ट को सच्चाई का स्रोत मानकर पार्स न करें।
पहुँच और कोटा
ऑपरेशन चलाने से पहले API पात्रता जाँचती है। सफल अनुरोध साझा API की एक इकाई उपयोग करता है। उपलब्ध ऑपरेशन और सीमाएँ आपके मौजूदा API टियर पर निर्भर करती हैं; कॉपी की गई मूल्य सूची पर निर्भर होने के बजाय प्रमाणित MCP कैटलॉग या अपने खाता टूल से मौजूदा उपलब्धता देखें।