사주 API › 평생 사주 API
평생 사주 API
생년월일시를 보내면 원국을 계산하고, 차트에 해당하는 풀이 문단을 성격·재물·직업·연애·건강·인간관계·조언 7개 주제로 묶어 JSON으로 돌려줘요. 상품 이름은 「평생 사주」이고, HRUM 사주이론으로 미리 써 둔 문단이라 같은 입력이면 결과가 같아요.
7개 주제와 주제 하나만
topic을 생략하면 7개 주제를 모두 돌려주고, personality·wealth·career·love·health·relationships·advice 중 하나를 보내면 그 주제만 돌려줘요. 주제 안 문단은 일주, 일간×월지, 신강약, 용신, 오행 상태, 십성 그룹 순서예요.
별자리·자미두수 층
layers: ["astro", "ziwei"]를 보내면 주제마다 별자리(태양·달·상승궁)와 자미두수(명궁 주성, 재물·직업·연애·건강 주제는 그 주제를 맡은 궁의 주성까지) 문단을 더해요. 출생 시각이 없으면 자미두수 층은 빠지고, 빠진 층은 과금하지 않아요.
요청 예시
{
"year": 1990, "month": 9, "day": 4, "hour": 14, "minute": 30,
"timezone": "Asia/Seoul", "gender": "male",
"topic": "career", "lang": "ko"
}
인증은 X-Partner-Api-Key 헤더, 기본 주소는 https://api.hrum.ai/api/v1/partners/v1예요. Python·JavaScript 예제와 에러 처리는 시작 가이드에 있어요.
응답 예시
{
"success": true,
"data": {
"topics": [
{
"topic": "career",
"paragraphs": [
{ "component": "ilju", "key": "임신", "text": "..." },
{ "component": "ilgan_wolji", "key": "임_신", "text": "..." },
{ "component": "ilgan_strength", "key": "임_신강", "text": "..." },
{ "component": "ilgan_yongshin", "key": "임_화", "text": "..." },
{ "component": "ohaeng_state", "key": "목_lack", "text": "..." },
{ "component": "ohaeng_state", "key": "토_lack", "text": "..." },
{ "component": "ohaeng_state", "key": "수_lack", "text": "..." },
{ "component": "top_sipsin", "key": "인성", "text": "..." }
]
}
],
"lang": "ko",
"fallbackLanguage": null,
"engine": { "version": 1, "styleVersion": "v1" }
}
}
문단 본문(text)은 줄였어요. 전체 필드 설명은 레퍼런스에 있어요.
가격
평생 사주는 전체 1회 ₩100(부가세 별도 · 부가세 포함 ₩110), 주제 1개 1회 ₩20(부가세 별도 · 부가세 포함 ₩22)이에요. 별자리·자미두수 층은 실제로 문단이 붙은 층마다 ₩20(부가세 별도 · 부가세 포함 ₩22)이 더해져요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.
한 번 받은 결과는 저장해 두고 다시 쓰세요. 같은 요청을 다시 보내면 다시 과금돼요. 같은 생년월일시·같은 옵션이면 계산 결과가 같으니, 첫 응답을 DB에 저장하고(예: 요청 본문 해시를 키로) 다음부터는 저장한 값을 쓰면 비용이 들지 않아요. 오늘의 운세처럼 날짜에 따라 바뀌는 결과는 날짜도 키에 넣어 그날 하루만 다시 쓰세요.
전체 레퍼런스
파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 평생 사주 API 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.
문의: contact@float.do · 운영: 플로트 주식회사