사주 API › 궁합 API

궁합 API

두 사람의 생년월일(과 출생 시각)을 보내면 사주 궁합, 별자리 궁합, 띠 궁합과 이들을 용도별 가중치로 합친 종합 점수를 한 번에 JSON으로 돌려줘요. 상품 이름은 「궁합」이고, INTA 앱 궁합 화면과 같은 엔진이에요. 같은 입력이면 결과가 같아요.

시작 가이드 플레이그라운드 요금표

돌려주는 것

• 사주 궁합 — 일주 궁합표와 8글자 분석 점수, 끌림·안정·성장·소통·열정·지속 6축, 오행 보완, 십신 (saju)
• 관계표 — 두 원국 사이의 합·충·형·해·파 등을 자리별로 모은 목록과 그 점수 (relations·p2Score)
• 별자리 궁합 — 태양·달·상승궁 비교와 용도별 행성, 미리 써 둔 풀이 문단 최대 2개 (astroSynastry·astroReadings)
• 띠 궁합 — 두 띠의 지지 관계와 등급 (tti)
• 종합 점수 — 다섯 점수를 용도별 가중치로 합친 0~100 점수 (headerBreakdown)
• 관계 풀이 문단 — 두 사람의 일주 조합과 관계 종류마다 미리 써 둔 2~3문장 (categoryNarrative)

옵션

출생 시각은 사람마다 선택이에요. details·flow·MBTI 옵션은 추가 요금 없이 같은 호출에 붙일 수 있어요.

요청 예시

옵션(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 오류 응답은 차감하지 않아요.

전체 요금표

전체 레퍼런스

파라미터 전체 표, 응답 필드 설명, 에러 코드는 레퍼런스에 있어요: 궁합 API 레퍼런스. 다른 사주 상품은 사주 API 전체 보기에서 볼 수 있어요.

문의: contact@float.do · 운영: 플로트 주식회사