사주 규칙
1인 1사주 정책
사용자 1명당 사주는 1개만 등록할 수 있습니다. 이미 등록된 사용자가 다시 등록을 시도하면 409 SAJU_ALREADY_EXISTS 오류가 반환됩니다.
입력 필드 규칙
| 필드 | 타입 | 필수 여부 | 유효 범위 / 기본값 |
|---|---|---|---|
birthDate | YYYY-MM-DD | 필수 | 과거 날짜만 허용 (오늘 포함 불가) |
gender | MALE | FEMALE | 필수 | — |
calendarType | SOLAR | LUNAR | 필수 | — |
birthTime | HH:mm | 선택 | null 허용, 미입력 시 자시(00:00) 기준으로 계산 |
city | string | 선택 | null 허용, 미입력 시 서울 기준으로 계산 |
termsConsent | boolean | 필수 | 서비스 약관 동의 여부 |
privacyConsent | boolean | 필수 | 개인정보 수집·이용 동의 여부 |
약관·개인정보 동의 없이 요청하면
400 SAJU_CONSENT_REQUIRED오류가 반환됩니다.
오행 비율
사주 분석 결과에 포함되는 오행(목·화·토·금·수) 5개 항목의 비율 합계는 항상 100% 입니다.
"fiveElements": {
"wood": 28.50,
"fire": 18.20,
"earth": 22.30,
"metal": 15.00,
"water": 16.00
}
관련 에러 코드
| 코드 | HTTP | 설명 |
|---|---|---|
SAJU_ALREADY_EXISTS | 409 | 이미 사주가 등록된 사용자 |
SAJU_CONSENT_REQUIRED | 400 | 약관 또는 개인정보 동의 누락 |
INVALID_BIRTH_DATE | 400 | 날짜 형식 오류 또는 미래 날짜 입력 |
EXTERNAL_API_ERROR | 502 | 외부 사주 계산 API 응답 오류 |
LLM_ERROR | 500 | AI 해석 생성 실패 |