Rectification API: 개발자를 위한 출생 시간 수정

점성술사들이 이를 해결하는 방법은 **렉티피케이션(rectification)**이라고 불리는 방법으로, 알려진 인생 사건들을 바탕으로 출생 시간을 추정하는 작업입니다. 전통적으로는 수작업으로 몇 시간을 들여야 했던 작업이었습니다. AstroWay는 이 작업을 자동화하는 두 가지 알고리즘 엔드포인트를 제공합니다.

이 글에서는 언제 렉티피케이션을 사용해야 하는지, 알고리즘이 어떻게 동작하는지, 그리고 이를 자신의 애플리케이션에 통합하는 방법에 대해 설명합니다.

렉티피케이션은 출생 시간의 보정을 의미합니다. 예를 들어 “아침” 또는 “약 14시”와 같은 대략적인 시간을 시작으로 다음을 사용하여 시간을 좁혀나갑니다:

• 중요한 인생 사건 (결혼, 자녀 출생, 직업 변화, 사망)
• 신체적 특징 (전통 점성술에서는 상승점의 별자리가 체형과 연관됨)
• 탄생 시 행성의 각도 위치

결과는 일반적으로 실제 시간으로부터 ±5분 이내의 정밀한 출생 시간입니다.

헤르메스 트리스메기스투스(Hermes Trismegistus)에게 기원한 고전적인 방법입니다. 출생 시 달의 위치와 수태 시(출생 약 9개월 전) 상승점/하강점의 관계를 사용합니다.

동작 방식:

1. 대략적인 출생 날짜를 입력합니다.
2. 수태 날짜 범위를 계산합니다(260~290일 전).
3. 각 후보 수태 날짜에 대해 출생 시 달의 위치가 수태 시 상승점/하강점과 일치하는지 확인합니다.
4. 적합도(fit) 순으로 정렬된 후보 출생 시간 목록을 반환합니다.

빠르지만 정확도는 다소 떨어집니다. 넓은 시간 범위를 좁히는 데 유용합니다(예: “아침” → 2시간 범위).

const result = await client.rectificationTrutine({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '12:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
});

console.log(`Best candidate: ${result.bestTime}`);
console.log(`Confidence: ${result.confidence}`);

여러 인생 사건을 기반으로 하는 알고리즘적 접근 방식입니다. 이 방법은 무거운 작업(요청당 최대 120초 소요)으로, 더 정확한 결과를 제공합니다.

입력:

• 대략적인 출생 시간 범위
• 날짜와 유형이 포함된 인생 사건 목록
• 선택 사항: 신체적 설명

알고리즘:

1. 시간 범위 내에서 후보 출생 시간을 생성합니다(보통 1분 단위로).
2. 각 후보에 대해 natal chart를 계산합니다.
3. 각 후보를 점수화하여 사건이 예측된 점성학적 패턴(진행, 방향, 통과)과 얼마나 일치하는지 평가합니다.
4. 확신도 점수와 함께 상위 후보들을 반환합니다.

const result = await client.rectification({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '18:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
  events: [
    { date: '2015-06-20', type: 'marriage' },
    { date: '2018-03-12', type: 'firstChild' },
    { date: '2020-09-05', type: 'careerChange' },
  ],
});

console.log(`Rectified time: ${result.bestTime}`);
console.log(`Candidates: ${result.candidates.length}`);

렉티피케이션은 다음 경우에 유용합니다:

• 시간을 모르는 사용자를 위한 애플리케이션 — 프리미엄 기능으로 제공
• 전문가용 점성술 도구 — 각 고객별로 수시간의 수작업을 절약
• HD 애플리케이션 — Human Design은 시간에 매우 민감하며, 렉티피케이션으로 정확도를 크게 향상시킬 수 있음
• 연구용 애플리케이션 — 기록된 시간이 부정확한 역사적 차트를 검증할 때

비추천 경우:

• 사용자가 이미 ±5분 이내의 정확한 시간을 알고 있는 경우(이점 없음)
• 시간 정확도가 결과에 영향을 미치지 않는 캐주얼한 horoscope 앱(예: daily sun sign)

• 트루틴: 250 크레딧 — 요청당 약 1~2초
• 전체 렉티피케이션: 500 크레딧 — 최대 120초

이것은 AstroWay API에서 가장 무거운 엔드포인트입니다. 렉티피케이션을 기능으로 제공한다면 이에 상응하는 요금을 책정하세요. 프리미엄 작업이므로 구독 요금이나 일회성 구매로 정당화할 수 있습니다.

예산 계획:

• 월 100회 렉티피케이션: 약 50,000 크레딧 = Pro 플랜($59)으로 다른 호출도 충분히 가능
• 월 1,000회 렉티피케이션: 500,000 크레딧 = Enterprise 플랜

렉티피케이션은 시간이 걸립니다. UI는 다음과 같이 구성해야 합니다:

• 비동기 처리 — 요청을 차단하지 말고 대기열에 넣고 진행 상황을 표시
• 진행률 표시 — 전체 엔드포인트는 최대 120초가 소요됩니다. 사용자에게 피드백을 제공해야 함
• 결과 표시 — 정밀한 시간, 확신도, 재시도 가능성, 정보가 부정확한 경우를 위한 옵션

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('렉티피케이션 진행 중(최대 2분 소요)...');

  try {
    const result = await client.rectification(input);
    setResult(result);
    setStatus(`완료. 정밀한 시간: ${result.bestTime} (확신도 ${result.confidence}%)`);
  } catch (err) {
    setStatus(`오류: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

일반적인 애플리케이션의 렉티피케이션 흐름:

1. 사용자가 대략적인 출생 정보와 인생 사건을 입력합니다.
2. 애플리케이션은 먼저 /v1/rectification/trutine(저렴하고 빠름)을 호출하여 시간 범위를 좁힙니다.
3. 그런 다음 /v1/rectification(정확한 전체 버전)을 호출하여 좁혀진 범위로 더 정확한 결과를 얻습니다.
4. 애플리케이션은 결과를 캐시하고 향후 모든 계산에 정밀한 시간을 사용합니다.
5. 향후 호출은 “대략적인 시간에서 정밀하게 보정된”으로 표시됩니다.

이러한 결합 접근 방식은 전체 사이클에 약 750 크레딧이 소요되지만 가장 높은 정확도를 제공합니다.

렉티피케이션은 절대 100% 정확도를 제공하지 않습니다. 심지어 전문 점성술사들도 5~10분의 오차를 보입니다.

AstroWay의 알고리즘은 상대적 정밀도에 중점을 둡니다. 시간 범위를 좁히지만 결과는 항상 “최선의 후보”로 제시되며 절대적인 진리로 간주되지 않습니다. 사용자에게 확신도 점수를 항상 표시하고 더 나은 정보가 있는 경우 재조정할 수 있는 옵션을 제공하세요.

알고리즘은 패턴을 찾는 방법입니다. 숙련된 점성술사는 “결혼이 성급했는가?”, “직업 변화가 자발적이었는가?”와 같은 맥락을 고려합니다. 고액의 ставка(high-stakes)가 있는 차트의 경우 다음을 결합하세요:

1. 알고리즘적 렉티피케이션 — 시간 범위를 좁히기 위해
2. 수동 점성술사의 검토 — 최종 정밀도를 위해

애플리케이션에서 이를 프리미엄 컨설팅으로 제공할 수 있습니다.

• API 레퍼런스 — rectification 및 rectification/trutine 엔드포인트 찾기
• 요금제 — 플랜별 크레딧 비용
• 빠른 시작 — API 키 받기