← 블로그기술

궁합 API 만들기 — 합형충파해로 두 사람 보기

2026. 6. 7.

갱신 (2026-11-03) — 코드 예제를 현행 API(v2) 기준으로 갱신했습니다. 예시 입력은 무료 키로 바로 실행되는 공개 샘플 사주입니다.

궁합의 출발점은 두 사주

사주 API 의 궁합 토픽(compatibility)에 두 사람의 생년월일을 함께 보내면, 각자의 사주와 함께 두 사주 사이의 합형충파해·오행 보완을 한 번에 받습니다. 이 재료로 궁합 로직을 구성합니다.

두 사람 계산

const res = await fetch('https://api.sazu.app/v2/sazu/compatibility', {
  method: 'POST',
  headers: { 'x-api-key': process.env.SAZU_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    birthYear: 1998, birthMonth: 5, birthDay: 19, birthHour: 10, isFemale: false,
    partners: [{ birthYear: 1993, birthMonth: 11, birthDay: 19, birthHour: 10, isFemale: true, label: '상대' }],
  }),
})
const { data } = await res.json()
console.log(data.modules.fourPillars)              // 본인 연·월·일·시주
console.log(data.partners[0].modules.fourPillars)  // 상대 연·월·일·시주
console.log(data.partners[0].crossRelations)       // 본인 일주 × 상대 4주 합형충파해
console.log(data.partners[0].elementComplement)    // 오행 보완

상대방 생년월일은 partners 배열에 담아 한 번에 보냅니다(최대 3명, 인원수와 무관하게 호출 1건). 본인 사주는 data.modules, 상대 사주는 data.partners[].modules 에 담깁니다. 무료 키로는 두 사람 모두 공개 샘플 프로필(GET /v2/sazu/samples)이어야 하며, 위 예시가 샘플 입력입니다.

궁합 판단에 쓰는 신호

  • 합형충파해 — 지지 간 관계. 합이 많으면 친화, 충이 많으면 갈등 신호 (partners[].crossRelations)
  • 오행 보완 — 한쪽의 부족한 오행을 상대가 채우는지 (partners[].elementComplement)
  • 일간 관계 — 두 일간의 생극 관계 (양쪽 fourPillars.day)

풀이까지 자동으로 받고 싶다면

합형충파해 데이터를 직접 해석하는 대신 완성된 궁합 풀이 문장이 필요하다면 노코드 운세 빌더에서 프롬프트로 정의할 수 있습니다. 모듈별 응답 형태는 API 문서를 확인하세요.

SAZU 의 사주 API 는 신용카드 없이 무료로 시작할 수 있습니다. 합형충파해·격국·용신·12운성 등 분석 모듈을 단일 호출로 제공하며, 응답은 평균 약 100ms 입니다. 무료 한도와 플랜별 요금은 요금 안내에 있습니다. 자세한 사용법은 API 문서에서 확인하세요.

SAZU API를 시작해보세요

신용카드 없이, 무료로 시작할 수 있습니다.