Справочник 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 или инструменты аккаунта, а не по сохранённой копии таблицы тарифов.