← 블로그튜토리얼

오늘의 운세 API — 일일 운세 자동화하기

2026. 6. 9.

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

오늘의 운세는 사주 + 날짜

"오늘의 운세"는 사용자의 타고난 사주와 오늘 날짜(일진·세운)의 관계로 만들어집니다. 사주 API 로 사주를 계산해 기준을 잡고, 오늘의 간지와 대조합니다.

자동화 흐름

1. 사용자 사주 계산 (1회)

가입 시 한 번 계산해 저장합니다.

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) // 연·월·일·시주

2. 매일 일진과 대조 (스케줄러)

cron 으로 매일 오늘 간지를 구해, 저장된 사주와의 합·충 관계로 운세를 산출합니다. 대조까지 맡기려면 오늘 토픽(/v2/sazu/today)을 호출하세요 — 오늘 일진과 원국의 관계(dailyInteraction)를 함께 담아 보냅니다.

대량 사용자 처리 팁

  • 사주 계산 결과를 캐시 — 동일 입력은 동일 출력이라 재계산 불필요
  • 일진 대조 로직은 로컬에서 처리해 호출 수 절감
  • 월 한도(Free 500 / 유료 500~10,000)에 맞춰 배치 설계

완성된 운세 문장이 필요하면

데이터가 아니라 바로 보여줄 운세 글이 필요하면 노코드 운세 빌더가 풀이까지 생성합니다. 응답 필드는 API 문서 참고.

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

SAZU API를 시작해보세요

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