Довідник HTTP API агента HumanDesign.ai
Огляд
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 або інструменти облікового запису, а не за збереженою таблицею цін.