사주 API › 궁합 API

궁합 API

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

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

돌려주는 것

옵션

출생 시각은 사람마다 선택이에요. 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 · 운영: 플로트 주식회사