사주 API › 궁합 API
궁합 API
두 사람의 생년월일(과 출생 시각)을 보내면 사주 궁합, 별자리 궁합, 띠 궁합과 이들을 용도별 가중치로 합친 종합 점수를 한 번에 JSON으로 돌려줘요. 상품 이름은 「궁합」이고, INTA 앱 궁합 화면과 같은 엔진이에요. 같은 입력이면 결과가 같아요.
돌려주는 것
- 사주 궁합 — 일주 궁합표와 8글자 분석 점수, 끌림·안정·성장·소통·열정·지속 6축, 오행 보완, 십신 (
saju) - 관계표 — 두 원국 사이의 합·충·형·해·파 등을 자리별로 모은 목록과 그 점수 (
relations·p2Score) - 별자리 궁합 — 태양·달·상승궁 비교와 용도별 행성, 미리 써 둔 풀이 문단 최대 2개 (
astroSynastry·astroReadings) - 띠 궁합 — 두 띠의 지지 관계와 등급 (
tti) - 종합 점수 — 다섯 점수를 용도별 가중치로 합친 0~100 점수 (
headerBreakdown) - 관계 풀이 문단 — 두 사람의 일주 조합과 관계 종류마다 미리 써 둔 2~3문장 (
categoryNarrative)
옵션
출생 시각은 사람마다 선택이에요. details·flow·MBTI 옵션은 추가 요금 없이 같은 호출에 붙일 수 있어요. INTA 앱과 같은 결과가 필요하면 출생 시각을 아는 사람에게 출생 국가와 exact를 함께 보내세요.
요청 예시
옵션(details·flow·MBTI)을 함께 보낸 요청 본문이에요.
{
"personABirthDate": "1990-05-15", "personABirthTime": "12:00", "personAGender": "male",
"personBBirthDate": "1992-08-20", "personBBirthTime": "09:00", "personBGender": "female",
"details": true, "flow": true, "date": "2026-10-10",
"personAMbti": "ENFP", "personBMbti": "ISTJ"
}
인증은 X-Partner-Api-Key 헤더, 기본 주소는 https://api.hrum.ai/api/v1/partners/v1예요. Python·JavaScript 예제와 에러 처리는 시작 가이드에 있어요.
응답 예시 (발췌)
{
"success": true,
"data": {
…
"saju": {
"purpose": "yeonae_attraction",
"hourKnown": { "a": true, "b": true },
"personA": { "ilju": "임신" },
"personB": { "ilju": "병인" },
"score": { "total": 59, "grade": "맞춰 가면 좋아요",
"breakdown": { "ilju": 53, "authority": 65, "eightChar": 65 } },
"axes": { "attraction": 25, "stability": 59, "growth": 58,
"communication": 24, "passion": 74, "longevity": 65 },
…
A 남 1990-09-04 14:30, B 여 1992-02-20 10:15, 연애 목적 요청의 응답에서 사주 궁합 앞부분만 뽑았어요. 전체 응답과 필드 설명은 레퍼런스에 있어요.
가격
궁합은 호출 1회에 ₩20(부가세 별도 · 부가세 포함 ₩22)이에요. 선불 크레딧에서 성공한 호출만 차감하고, 4xx·5xx 오류 응답은 차감하지 않아요.
한 번 받은 결과는 저장해 두고 다시 쓰세요. 같은 요청을 다시 보내면 다시 과금돼요. 같은 생년월일시·같은 옵션이면 계산 결과가 같으니, 첫 응답을 DB에 저장하고(예: 요청 본문 해시를 키로) 다음부터는 저장한 값을 쓰면 비용이 들지 않아요. 오늘의 운세처럼 날짜에 따라 바뀌는 결과는 날짜도 키에 넣어 그날 하루만 다시 쓰세요.
전체 레퍼런스
파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 궁합 API 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.
문의: contact@float.do · 운영: 플로트 주식회사