HumanDesign.ai Agent HTTP API 参考
API2026 年 11 月 13 日更新阅读约需 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。不支持在查询字符串中提供凭证。
端点
- 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 目录或账户工具查询当前可用情况,不要依赖复制保存的定价表。