사주 API › 자미두수 API
자미두수 API
생년월일시를 보내면 자미두수 명반을 계산해 12궁, 14주성과 보좌성(밝기·생년사화 포함), 오행국, 명궁·신궁 위치, 기준일의 대한·유년을 JSON으로 돌려줘요. 상품 이름은 「자미두수 명반」이에요. 같은 입력이면 결과가 같아요.
돌려주는 것
- 12궁 — 궁 이름·천간·지지·대한 나이와 그 궁의 별 (
palaces) - 별 — 14주성과 보좌성, 밝기, 생년사화 (
majorStars·minorStars) - 생년사화 — 화록·화권·화과·화기와 그 별이 앉은 궁 (
mutagens) - 대한·유년 — 기준일의 대한과 유년 궁 (
currentDecadal·yearly) - 규칙 키 — 명반에서 참인 사실을 자미두수 규칙 키 문자열로 적은 목록 (
features)
풀이 문단 붙이기
readings: true를 보내면 명궁 주성 조합, 7개 주제, 재백·관록·부처·질액궁 주성의 풀이 문단이 붙어요. 이때는 추가 요금이 있고, 금액은 레퍼런스에 있어요.
출생 시각이 없으면
자미두수는 출생 시각 없이 명반을 세울 수 없어서, hour를 빼면 400 birth_time_required를 돌려줘요. 오류 응답이라 차감하지 않아요.
요청 예시
{
"year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30,
"gender": "female", "referenceDate": "2026-10-08", "lang": "ko"
}
인증은 X-Partner-Api-Key 헤더, 기본 주소는 https://api.hrum.ai/api/v1/partners/v1예요. Python·JavaScript 예제와 에러 처리는 시작 가이드에 있어요.
응답 예시 (발췌)
{
"success": true,
"data": {
"engineVersion": 1,
"lang": "ko",
"referenceDate": "2026-10-08",
"clock": {
"inputSolarDate": "1990-05-15", "inputTime": "14:30",
"correctedSolarDate": "1990-05-15", "correctedTime": "14:30",
"correctionMinutes": 0, "dstApplied": false, "basis": null,
"hourBranch": { "key": "wei", "label": "미" }
},
"chart": {
"engine": { "name": "iztro", "version": "2.6.1", "config": { ... } },
"solarDate": "1990-05-15",
"lunarDate": { "year": 1990, "month": 4, "day": 21, "isLeapMonth": false },
"yearGanzhi": "경오",
"yearBasisNote": null,
"fiveElementsClass": { "key": "earth5", "label": "토오국" },
"soulPalaceBranch": { "key": "xu", "label": "술" },
"bodyPalaceBranch": { "key": "zi", "label": "자" },
…
위 요청 응답의 앞부분이에요. 12궁·사화·규칙 키까지 담긴 응답과 필드 설명은 레퍼런스에 있어요.
가격
자미두수 명반은 호출 1회에 ₩50(부가세 별도 · 부가세 포함 ₩55)이에요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.
한 번 받은 결과는 저장해 두고 다시 쓰세요. 같은 요청을 다시 보내면 다시 과금돼요. 같은 생년월일시·같은 옵션이면 계산 결과가 같으니, 첫 응답을 DB에 저장하고(예: 요청 본문 해시를 키로) 다음부터는 저장한 값을 쓰면 비용이 들지 않아요. 오늘의 운세처럼 날짜에 따라 바뀌는 결과는 날짜도 키에 넣어 그날 하루만 다시 쓰세요.
전체 레퍼런스
파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 자미두수 명반 API 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.
문의: contact@float.do · 운영: 플로트 주식회사