← 블로그튜토리얼

운세 API로 운세앱 만들기 — REST 연동 실전

2026. 6. 5.

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

운세앱의 핵심은 만세력 계산

운세앱을 만들 때 가장 까다로운 부분은 UI 가 아니라 정확한 사주 계산입니다. 운세 API 를 쓰면 계산 계층을 통째로 위임하고, 앱은 입력과 표현에만 집중할 수 있습니다.

전체 흐름 3단계

1. 생년월일 입력 받기

사용자에게 출생년·월·일·시와 성별을 받습니다. 시를 모르면 birthHour 를 null 로 보냅니다.

2. REST 호출

const res = await fetch('https://api.sazu.app/v2/sazu/manse', {
  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 }),
})
const { data } = await res.json()
console.log(data.modules.fourPillars) // 연·월·일·시주

3. 결과 렌더링

/v2/sazu/manse 응답의 data.modules 안에 연·월·일·시주(기둥마다 십성 포함), 오행 분포, 신강/신약, 대운, 신살(유료 플랜)이 들어 있습니다. 합형충파해·격국·용신은 /v2/sazu/life 처럼 그 재료가 필요한 토픽에 담깁니다. 필요한 모듈을 선택해 화면에 그립니다.

운세앱에 자주 쓰는 모듈

  • fourPillars — 사주팔자 (연·월·일·시주)
  • decadeFortune — 대운
  • fourPillars 의 sippiSeong — 십성 (기둥마다)
  • 합형충파해·격국·용신 등 — 토픽마다 필요한 모듈이 담깁니다

코딩이 부담된다면

직접 코드를 짜는 대신 완성된 풀이를 받고 싶다면 노코드 운세 빌더도 있습니다. 프롬프트만 정의하면 운세 풀이 결과를 호출 한 번으로 받습니다. 파라미터 전체는 API 문서를 참고하세요.

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

SAZU API를 시작해보세요

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