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. 목적: 두 사람의 합성 차트를 생성합니다. - POST. 경로:
/get-reference-item. 목적: 게이트, 채널, 센터 또는 프로필 기록을 조회합니다. - POST. 경로:
/get-transits. 목적: 예측 또는 네이털 차트와 트랜짓 비교 응답을 가져옵니다. - POST. 경로:
/search-celebrities. 목적: 유명인 공개 카탈로그를 검색합니다.
응답 형식
성공 응답은 버전이 지정된 봉투 형식을 사용합니다:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
다음 meta 객체에는 요청 및 할당량 정보가 포함됩니다. 응답 필드를 구조화된 데이터로 취급하고 요약 텍스트를 기준 정보로 파싱하지 마세요.
접근 권한 및 할당량
API는 작업을 실행하기 전에 이용 자격을 확인합니다. 성공한 요청은 공유 API 단위 1개를 사용합니다. 사용 가능한 작업과 한도는 현재 API 요금제에 따라 달라집니다. 복사한 요금제 표에 의존하지 말고 인증된 MCP 카탈로그 또는 계정 도구를 통해 현재 이용 가능 여부를 확인하세요.