HumanDesign.ai Agent HTTP APIリファレンス
API2026年11月13日更新読了時間:約2分
概要
Agent HTTPは、計算およびリファレンスに関する同じ6つの操作をHTTPエンドポイントとして公開します。MCPプロトコルではなく、名前付きのHTTP呼び出しを使いたいアプリケーションに適しています。
ベースパス: 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。用途:2人のコンポジットチャートを生成します。 - POST。パス:
/get-reference-item。用途:ゲート、チャネル、センター、プロフィールのレコードを読み取ります。 - POST。パス:
/get-transits。用途:予報またはネイタル対トランジットのレスポンスを取得します。 - POST。パス:
/search-celebrities。用途:著名人カタログを検索します。
レスポンス形式
成功したレスポンスは、バージョン付きのエンベロープを使用します:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
オブジェクトにはリクエストとクォータの情報が含まれます。レスポンスフィールドは構造化データとして扱い、概要テキストを正確なデータの根拠として解析しないでください。 meta objectにはリクエストとクォータの情報が含まれます。レスポンスフィールドを構造化データとして扱い、要約テキストを正式な情報源として解析しないでください。
アクセスとクォータ
APIは操作を実行する前に利用権を確認します。成功したリクエストは共有APIユニットを1つ消費します。利用可能な操作と上限は現在のAPI階層によって異なります。転載された料金表に頼らず、認証済みMCPカタログまたはアカウントツールで最新の利用可否を確認してください。