DESTINYAPI · Developer Portal

통합 분석 가이드

Destiny Engine API의 가장 강력한 기능인 통합 분석을 활용하면 서양 점성술(Natal Chart), 한국 사주팔자(Saju), 중국 자미두수(Jami)를 하나의 분석으로 결합할 수 있습니다. 이 가이드에서는 각 시스템의 장점을 활용한 심화 운명 분석 방법을 설명합니다.

왜 통합 분석인가?

각 운명 분석 시스템은 고유한 강점을 가지고 있습니다:

서양 점성술

  • ✓ 행성의 정확한 각도 관계
  • ✓ 심리학적 성향 분석
  • ✓ 시기별 트랜짓 예측
  • ✓ 관계 시너지 분석

사주 명리학

  • ✓ 오행 균형 분석
  • ✓ 십성으로 본 육친 관계
  • ✓ 10년 주기 대운
  • ✓ 실용적 진로/재물 분석

자미두수

  • ✓ 12개 인생 영역 세분화
  • ✓ 14정성의 상세한 해석
  • ✓ 유년 단위 운세
  • ✓ 구체적 사건 타이밍

통합 분석은 이 세 시스템의 강점을 결합하여 더 입체적이고 정확한 해석을 제공합니다.

통합 분석 작동 방식

1. 병렬 계산

하나의 API 요청으로 세 시스템을 동시에 계산합니다:

// 통합 분석 요청 예제
const response = await fetch('https://api.destinyapi.com/v1/unified/combined-analysis', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: '홍길동',
    birthdate: '1990-01-15',
    birth_time: '14:30',
    latitude: 37.5665,
    longitude: 126.9780,
    timezone: 'Asia/Seoul',
    gender: 'M',
    is_lunar: false,
    target_year_ganji: '갑진',
  }),
});

const data = await response.json();

// 응답에는 세 시스템의 결과가 모두 포함됨
console.log(data.natal_chart);    // 서양 점성술
console.log(data.saju);           // 사주팔자
console.log(data.jami);           // 자미두수
console.log(data.integration);    // 통합 해석

2. 교차 검증

여러 시스템이 공통적으로 지적하는 특성은 신뢰도가 높습니다:

💡

예시: 리더십 성향

• 서양 점성술: 태양이 10하우스(관록궁)에 위치
• 사주: 정관이 월주에 강하게 위치
• 자미두수: 자미성이 명궁에 위치

→ 세 시스템 모두 강한 리더십을 나타내므로 신뢰도 높은 해석

3. 상호 보완

한 시스템의 약점을 다른 시스템으로 보완합니다:

  • 점성술의 심리적 통찰 + 사주의 실용적 조언 = 이론과 실천의 조화
  • 사주의 10년 주기 + 점성술의 일별 트랜짓 = 거시/미시 타이밍
  • 자미두수의 영역별 분석 + 점성술의 하우스 = 세밀한 인생 영역 파악

실전 활용 사례

사례 1: 직업 선택

서양 점성술

10하우스(사회적 지위)에 수성(소통), MC가 쌍둥이자리 → 커뮤니케이션 관련 직업 적합

사주

식신이 강하고 재성이 약함 → 창의적 일이지만 수입은 불안정할 수 있음

자미두수

관록궁에 천기성(기획) + 문창성(문서) → 기획, 작가, 강사 등 지식 전달 직업

통합 결론

추천 직업: 콘텐츠 크리에이터, 작가, 강사, 마케터
주의사항: 초기에는 수입이 불안정할 수 있으니 부업으로 시작 권장
적기: 현재 대운(사주)과 트랜짓(점성술)이 30대 중반에 가장 유리

사례 2: 결혼 시기

// 통합 결혼 시기 분석 예제
function analyzeMarriageTiming(unifiedData, currentAge) {
  const natal = unifiedData.natal_chart;
  const saju = unifiedData.saju;
  const jami = unifiedData.jami;

  // 1. 점성술: Venus 트랜짓
  const venusHouse = natal.bodies.venus.house;
  console.log('금성 위치:', venusHouse === 7 ? '결혼운 강함' : '일반');

  // 2. 사주: 배우자궁(일지) 분석
  const spouseBranch = saju.day_branch;
  console.log('배우자궁:', spouseBranch);

  // 3. 자미두수: 부부궁 상태
  const marriagePalace = jami.십이궁.부부궁;
  const marriageStars = jami['14정성 및 보좌성'][marriagePalace];
  console.log('부부궁 별:', marriageStars);

  // 통합 판단
  if (venusHouse === 7 && marriageStars.includes('천喜')) {
    console.log(`${currentAge}세: 결혼운이 매우 강한 시기`);
  }
}

사례 3: 건강 관리

복합 건강 분석

점성술 6하우스 (건강): 화성 위치 → 염증성 질환 주의
사주 오행: 수(水) 부족 → 신장, 방광 약함
자미두수 질액궁: 칠살성 → 급성 질환 가능성

통합 조언: 수분 섭취 충분히, 염분 과다 섭취 주의, 정기 검진 필수

해석 전략

1. 순서 정하기

분석할 때는 다음 순서를 권장합니다:

  1. 사주로 큰 틀 파악: 오행 균형, 대운 흐름
  2. 점성술로 심리 이해: 성격, 욕구, 갈등 포인트
  3. 자미두수로 세부 확인: 영역별 상세 운세
  4. 교차 검증: 공통점 찾기
  5. 종합 해석: 조언 도출

2. 우선순위 설정

모든 것을 다 해석하려 하지 말고 중요한 부분에 집중:

  • 세 시스템이 공통적으로 지적하는 특성
  • 세 시스템이 모순되는 경우 → 상황에 따라 다르게 나타남을 의미
  • 현재 시점에서 가장 활성화된 요소 (대운, 트랜짓, 유년)

3. 균형 잡힌 시각

⚠️ 주의: 한 시스템만 보면 편향될 수 있습니다.
• 점성술만 보면: 지나치게 심리학적, 추상적
• 사주만 보면: 지나치게 결정론적
• 자미두수만 보면: 복잡하고 세부적

→ 세 가지를 함께 보면서 균형을 맞추세요!

통합 분석 코드 예제

async function getUnifiedInsights(birthData) {
  // 1. 통합 분석 요청
  const response = await fetch('/v1/unified/combined-analysis', {
    method: 'POST',
    headers: { 'X-API-Key': 'your_key', 'Content-Type': 'application/json' },
    body: JSON.stringify(birthData),
  });

  const data = await response.json();

  // 2. 성격 종합
  function analyzePersonality() {
    const sun = data.natal_chart.bodies.sun;
    const dayStem = data.saju.day_stem;
    const mingPalace = data.jami.명궁;

    return {
      western: `태양 ${sun.sign} - 핵심 자아`,
      eastern: `일간 ${dayStem} - 본질`,
      jami: `명궁 ${mingPalace} - 외적 표현`,
    };
  }

  // 3. 현재 운세
  function analyzeCurrentFortune(age) {
    const daeun = getCurrentDaeun(data.saju.daeun.daeun_list, age);
    const daehan = getCurrentDaehan(data.jami.대한, age);

    // 점성술 트랜짓은 실시간 계산 필요 (별도 API)

    return {
      saju_daeun: daeun ? daeun.pillar : '정보 없음',
      jami_daehan: daehan ? daehan.start_year + '-' + daehan.end_year : '정보 없음',
      // transit는 별도 조회
    };
  }

  // 4. 강점/약점 종합
  function analyzeStrengthsWeaknesses() {
    const strengths = [];
    const weaknesses = [];

    // 각 시스템에서 강점/약점 추출 후 병합
    // (구체적 로직은 프로젝트마다 다름)

    return { strengths, weaknesses };
  }

  return {
    personality: analyzePersonality(),
    currentFortune: analyzeCurrentFortune(35),
    strengthsWeaknesses: analyzeStrengthsWeaknesses(),
  };
}

// 헬퍼 함수들
function getCurrentDaeun(daeunList, age) {
  for (let i = daeunList.length - 1; i >= 0; i--) {
    if (age >= daeunList[i].age) return daeunList[i];
  }
  return null;
}

function getCurrentDaehan(daehan, age) {
  for (let i = daehan.length - 1; i >= 0; i--) {
    if (age >= daehan[i].age) return daehan[i];
  }
  return null;
}

모범 사례

✅ 시스템별 강점 활용

각 시스템은 다른 영역에서 강점을 보입니다. 성격은 점성술, 재물/직업은 사주, 세부 타이밍은 자미두수를 중심으로 해석하세요.

✅ 모순은 다면성

세 시스템이 서로 다른 결과를 보이면 "틀렸다"가 아니라 "상황에 따라 다르게 나타난다"로 해석하세요. 사람은 일관되지 않고 복합적입니다.

✅ 데이터 캐싱

출생 정보는 변하지 않으므로 기본 차트는 한 번만 계산하고 저장하세요. 시간에 따라 변하는 트랜짓, 유년운만 주기적으로 업데이트하면 됩니다.

✅ 점진적 해석

처음부터 세 시스템을 모두 완벽히 이해하려 하지 마세요. 먼저 하나씩 익힌 후, 서서히 통합하는 것이 효율적입니다.

한계와 주의사항

  • 시간 소요: 세 시스템을 모두 해석하려면 시간이 많이 걸립니다
  • 전문성 요구: 각 시스템에 대한 깊은 이해가 필요합니다
  • 복잡성: 초보자에게는 오히려 혼란스러울 수 있습니다
  • 결정론 주의: 운명이 정해져 있다는 잘못된 믿음을 가지지 마세요
⚠️

윤리적 사용

통합 분석은 강력한 도구이지만, 사람의 미래를 단정짓거나 중요한 결정을 전적으로 운명에 맡기도록 유도해서는 안 됩니다. 참고와 통찰의 도구로만 사용하세요.

다음 단계

통합 분석을 시작하기 전에 각 시스템을 먼저 이해하세요:

🚀 통합 분석 API

Combined API는 현재 개발 중입니다. 곧 출시될 통합 분석 엔드포인트에서 세 시스템의 결과를 자동으로 통합하여 제공할 예정입니다.

API 레퍼런스 보기 →