OpenAPI 포털사주팡팡 OpenAPI 개발자 기술 연동 레퍼런스
개발자 콘솔 (API 키 관리)
SAJUPANGPANG Manseoryeok Engine v1.0

사주팡팡 OpenAPI 기술 레퍼런스

사주팡팡 만세력 API는 수백 년간 전승된 정통 명리학(자평진전, 삼명통회, 적천수)의 천문 연산 체계를 초경량 인메모리 수리 알고리즘으로 집대성한 고성능 B2B 엔진입니다. 외부 데이터베이스 지연 없이 1건당 1.2ms 이내에 4주 8자, 12신살, 대운·세운·월운, 재회 인연 지수, 19+ 속궁합 케미스트리를 표준 JSON 포맷으로 공급합니다.

타사 만세력 대비 10대 차별화 핵심 기능

단순 계산기가 아닌, 한국 천문 역학의 모든 시차·절기·학파 분기를 100% 자동 처리합니다.

1. 대한민국 역대 썸머타임(DST) 자동 보정

1948~1960년 및 1987~1988년(올림픽) 서머타임 고시 기간 출생자의 생시를 1시간 역산하여 시주 오차를 원천 차단합니다.

2. 200년(1900~2100) 음력 & 윤달(閏月) 정밀 변환

한국천문연구원(KASI) 천문 합삭 데이터를 토대로 200년간의 평달/윤달 여부를 100% 오차 없이 상호 변환합니다.

3. 야자시(夜子時) / 조자시(朝子時) 분기 파라미터

밤 23:00~24:00 출생자의 당일/익일 일진 분기 설정(`useYajasi: true/false`)을 직접 제어할 수 있습니다.

4. 전세계 6대륙 글로벌 도시 진태양시 & 자오선 시차 보정

멕시코·브라질·스페인어권 중남미(멕시코시티, 상파울루, 부에노스아이레스, 보고타, 리마, 산티아고, 마드리드), 아프리카(요하네스버그, 카이로, 라고스, 나이로비, 카사블랑카), 일본 23개 도시(도쿄, 오사카 등), 중국·중동·유럽·북미 등 전세계 모든 국가의 위도·경도 및 표준 자오선 시차를 100% 자동 정밀 보정합니다.

5. 24절기 절입 시각 초(second) 단위 판별

입춘, 경칩, 청명 등 절기 교체 당일 출생자의 년주/월주 전환 시점을 초 단위 태양 황경각(0°~345°)으로 정밀 분기합니다.

6. 남녀 순행/역행 정밀 대운수(소수점 1자리) 산출

양남음녀(순행) / 음남양녀(역행) 법칙에 따라 절입 시각과의 일수·시수를 계산하여 소수점 대운수와 10년 주기 간지를 산출합니다.

7. 12신살 + 40여 종 특수 길흉신살 표출

겁살, 재살, 천살, 지살, 연살, 월살, 망신, 장성, 반안, 역마, 육해, 화개부터 백호, 괴강, 양인, 도화, 천을귀인, 원진살까지 전수 도출합니다.

8. 지장간(地藏干) 율기 & 사령(司令) 당령 세분화

월지 속 30일 율기 분할 계산을 통해 당령 지장간을 찾아내고 정밀한 격국(格局)과 체질 에너지를 분별합니다.

9. 신강·신약 점수(득령/득지/득세) & 3대 용신

일간 강약 100점 점수화 및 억부용신, 조후용신, 통관용신을 다각도로 분석하여 최적의 개운 솔루션을 제시합니다.

10. 5행(목·화·토·금·수) 에너지 결핍/과다 분포율 분석

천간과 지지, 지장간 장간 가중치를 결합하여 오행별 점유율(%)을 정밀 백분율로 산출합니다.

천문 역학 보정 파라미터 명세

사주팡팡 만세력 API 호출 시 다음 파라미터를 통해 고난도 천문 보정 기능을 손쉽게 제어할 수 있습니다.

파라미터명타입기본값설명 및 동작 방식
isLunarbooleanfalse`true` 설정 시 200년 천문 음력 데이터를 참조하여 양력으로 자동 환산 후 절기 대조.
isLeapMonthbooleanfalse음력 생일인 경우 윤달 여부 지정 (윤달이 존재하는 음력 달에만 유효).
useYajasibooleantrue`true`: 23:00~24:00 출생자를 야자시(당일 일진 유지)로 처리. `false`: 자시 시작과 동시에 익일 일진 적용.
birthPlacestring"서울"출생 도시명 (예: "서울", "도쿄", "멕시코시티", "상파울루", "마드리드", "카이로", "뉴욕", "베이징" 등 전세계 6대륙 150여 개 주요 도시 지원). 해당 지역의 실제 경도 및 표준 자오선 시차를 진태양시로 100% 자동 가감.

API 인증 (`x-api-key`)

모든 API 요청은 HTTP Header에 `x-api-key`를 전달해야 합니다. 개발자 대시보드에서 시크릿 키를 즉시 발급받을 수 있습니다.

HTTP Header Format
x-api-key: sk_live_your_api_key_here

엔드포인트별 포인트 과금 정책

1. 사주 명식 추출 API

10 포인트 (10원)
/api/v1/manse/force

만세력 4주 8자, 썸머타임, 진태양시, 12신살, 대운수 산출

2. 오늘의 운세 분석 API

50 포인트 (50원)
/api/v1/manse/fortune/today

당일 일진 명식 대조 및 AI 맞춤형 운세 텍스트 분석

3. 19+ 속궁합 데이터 분석 API

30 포인트 (30원)
/api/v1/manse/compatibility

두 사람 일지 배우자궁 합충, 오행 상보성, 속궁합 케미스트리

4. 재회 인연·골든타임 분석 API

30 포인트 (30원)
/api/v1/manse/reunion

사주 인연 끈 강도, 방어벽 지수, 연락 골든타임 D-day 산출

POST

1. 사주 명식 추출

/api/v1/manse/force

생년월일시와 성별, 출생지 정보를 바탕으로 정밀 사주 명식(4주 8자, 십성, 지장간, 12신살) JSON 데이터를 산출합니다.

Request JSON Example
{
  "name": "홍길동",
  "birthDate": "1995-05-15",
  "birthTime": "14:30",
  "gender": "male",
  "isLunar": false,
  "isLeapMonth": false,
  "birthPlace": "서울",
  "useYajasi": true
}
POST

2. 오늘의 운세 실시간 분석

/api/v1/manse/fortune/today

개인의 사주 원국과 오늘의 일진 천간/지지를 실시간 대조하여 맞춤형 일진 운세 및 텍스트 리포트를 도출합니다.

Response JSON Preview
{
  "success": true,
  "data": {
    "summary": "금전운과 추진력이 강하게 맞물리는 날입니다.",
    "aiAnalysis": "홍길동님, 오늘 일진과의 합(合) 기운이 활발하여 대인관계에서 좋은 결실이 기대됩니다...",
    "todayPillars": { "heavenlyStem": "갑", "earthlyBranch": "진" }
  },
  "cost": 50
}
POST

3. 정밀 궁합 & 19+ 속궁합 데이터 분석

/api/v1/manse/compatibility

두 사람의 일주(배우자궁) 궁합, 오행 상보성, 지지 육합/삼합/암합, 십이운성을 다각도로 분석하여 종합 궁합 및 성적/체질적 케미스트리(속궁합) 지표를 반환합니다.

Request & Response Example
// Request
{
  "user1": { "name": "김철수", "birthDate": "1995-05-15", "birthTime": "14:30", "gender": "male" },
  "user2": { "name": "이영희", "birthDate": "1996-08-20", "birthTime": "09:15", "gender": "female" },
  "includeIntimacy": true
}

// Response
{
  "success": true,
  "data": {
    "overallScore": 92,
    "dayCompatibility": { "score": 95, "description": "일지 삼합으로 깊은 정서적 유대감 형성" },
    "elementHarmony": { "harmony": 88, "description": "서로에게 부족한 수(水)와 화(火) 기운을 완벽 상호보완" },
    "intimacyAnalysis": {
      "score": 94,
      "grade": "천생연분 (폭발적인 육체적·정서적 끌림)",
      "chemistryType": "강한 상호 자극 및 충만한 교감",
      "elementBalanceDescription": "서로에게 부족한 오행 에너지를 100% 상호 보완함"
    }
  },
  "cost": 30
}
POST

4. 재회 인연 끈 & 골든타임 분석

/api/v1/manse/reunion

두 사람의 사주 인연 끈과 현실적 이별 조건(헤어진 기간, 차단 여부, 지인 유무)을 종합 대조하여 재회 성사 확률, 상대방 방어벽 지수, 최적 연락 추천 시간대를 도출합니다.

Request & Response Example
// Request
{
  "user1": { "name": "의뢰인", "birthDate": "1995-05-15", "gender": "male" },
  "user2": { "name": "헤어진 상대", "birthDate": "1996-08-20", "gender": "female" },
  "breakupInfo": {
    "duration": "1_3m",
    "isBlocked": false,
    "hasMutualFriends": true
  }
}

// Response
{
  "success": true,
  "data": {
    "sajuBondScore": 88,
    "coolingPeriodAdequacy": 85,
    "reconnectionProbability": 82,
    "defenseMechanismLevel": "보통 (자연스러운 안부 소통 가능)",
    "goldenTiming": {
      "recommendation": "현재가 감정적 방어벽이 낮아지는 최적의 골든타임",
      "bestTimeOfDay": "오후 8시 ~ 10시 (감정이 이완되는 야간 시간대)",
      "firstContactChannel": "가벼운 질문형 카톡/문자 메시지"
    }
  },
  "cost": 30
}

기업 제휴 및 기술 지원 문의

대량 트래픽 전용 B2B 할인 플랜, 기업 맞춤형 명리 알고리즘 탑재 및 기술 지원이 필요하신 경우 아래 공식 채널로 문의해 주세요.

info@novacontents.com개발자 대시보드로 이동