مرجع HumanDesign.ai Agent HTTP API
نظرة عامة
تعرض 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. بيانات الاعتماد في سلسلة الاستعلام غير مدعومة.
نقاط النهاية
- 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 الموثق أو أدوات حسابك بدلًا من الاعتماد على جدول أسعار منسوخ.