안내 (2026-09-16) — 이 글의 코드 예제는 발행 당시 현행이던 v1 기준입니다. v1 은 2026년 9월 16일부터 레거시 버전이며 2027년 9월 30일까지 지원합니다. 새로 가입하시는 계정에서는 v1 을 이용하실 수 없습니다. 새 연동은 목적별 토픽 엔드포인트 POST /v2/sazu/<topic> 로 작성하세요 — 입력 필드와 응답 모듈 키는 v1 과 같고, modules 파라미터만 없습니다. 옮기는 법은 API 문서의 「v1 (레거시) — v2 로 옮기기」에 있습니다.
오늘의 운세는 사주 + 날짜
"오늘의 운세"는 사용자의 타고난 사주와 오늘 날짜(일진·세운)의 관계로 만들어집니다. 사주 API 로 사주를 계산해 기준을 잡고, 오늘의 간지와 대조합니다.
자동화 흐름
1. 사용자 사주 계산 (1회)
가입 시 한 번 계산해 저장합니다.
const res = await fetch('https://api.sazu.app/v1/sazu/calculate', {
method: 'POST',
headers: { 'x-api-key': process.env.SAZU_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ birthYear: 1990, birthMonth: 3, birthDay: 15, birthHour: 14, isFemale: false }),
})
const { data } = await res.json()
console.log(data.modules.fourPillars) // 연·월·일·시주2. 매일 일진과 대조 (스케줄러)
cron 으로 매일 오늘 간지를 구해, 저장된 사주와의 합·충 관계로 운세를 산출합니다.
대량 사용자 처리 팁
- 사주 계산 결과를 캐시 — 동일 입력은 동일 출력이라 재계산 불필요
- 일진 대조 로직은 로컬에서 처리해 호출 수 절감
- 월 한도(Free 500 / 유료 500~10,000)에 맞춰 배치 설계
완성된 운세 문장이 필요하면
데이터가 아니라 바로 보여줄 운세 글이 필요하면 노코드 운세 빌더가 풀이까지 생성합니다. 응답 필드는 API 문서 참고.
SAZU 의 사주 API 는 신용카드 없이 무료로 시작할 수 있습니다. 합형충파해·격국·용신·12운성 등 분석 모듈을 단일 호출로 제공하며, 응답은 평균 약 100ms 입니다. 무료 한도와 플랜별 요금은 요금 안내에 있습니다. 자세한 사용법은 API 문서에서 확인하세요.