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

대부분의 점성술 사용자는 생년월일은 알지만 정확한 시간을 모른다. 30분 차이만으로도 상승점이 5도 이상 이동할 수 있어 하우스와 어스펙트 위치가 바뀐다. 진지한 점성 작업에서는 이것이 중요하다.

점성가들이 이를 보정하는 기술을 리케티피케이션이라고 한다 – 알려진 인생 사건으로부터 가능한 출생 시간을 복원하는 것. 전통적으로는 수시간의 수작업이 필요했다. AstroWay는 이를 자동화하는 두 개의 알고리즘 엔드포인트를 제공한다.

이 글에서는 언제 리케티피케이션을 사용하고, 알고리즘이 어떻게 동작하며, 이를 내 앱에 어떻게 통합하는지 다룬다.

리케티피케이션은 출생 시간 보정이다. 너는 대략적인 시간(예: ‘아침’ 혹은 ‘대략 14:00’)에서 시작해 다음을 사용해 범위를 좁힌다:

• 인생의 중요한 사건 (결혼, 자녀, 직업 전환, 사망)
• 신체적 특성 (전통 점성술은 상승점 표시를 몸 유형에 매핑한다)
• 출생 시 행성의 각도 위치

결과는 보정된 출생 시간이며, 보통 실제 시간에서 ±5분 이내이다.

고전적인 방법으로, 헤르메스 트리즘에기스트에게 귀속된다. 출생 시 달의 위치와 수정 시(약 9개월 전) 상승점/하강점 사이의 연관성을 이용한다.

작동 방식:

1. 대략적인 출생 날짜를 가져온다
2. 수정 날짜 범위(260–290일 전)를 계산한다
3. 각 후보 수정 날짜마다 출생 시 달의 위치가 해당 수정 시의 상승점/하강점과 일치하는지 확인한다
4. 적합도에 따라 정렬된 후보 출생 시간 리스트를 반환한다

빠르지만 정확도는 낮다. 넓은 시간 창을 좁히는 데 좋다(예: ‘아침’ → 2시간 창).

const result = await client.rectification.trutine({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

console.log(`Suggested ascendant: ${result.suggestedAsc.toFixed(2)}°`);
console.log(`Moon above the horizon at conception: ${result.moonAboveHorizon}`);

여러 인생 사건을 기반으로 한 알고리즘 접근법이다. 무거운 옵션이며(요청당 최대 120초).

입력:

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

알고리즘:

1. 범위 내에서 후보 출생 시간을 생성한다(보통 1분 간격)
2. 각 후보에 대해 출생 차트를 계산한다
3. 각 후보를 사건이 예상되는 점성 패턴(프로그레션, 디렉션, 트랜짓)과 얼마나 일치하는지 평가한다
4. 신뢰도 점수와 함께 상위 후보들을 반환한다

const result = await client.rectification.compute({
  baseInput: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  },
  events: [
    // type picks which significators are checked; weight is 1-3 importance
    { date: '2015-06-20', type: 'marriage', description: 'married', weight: 3 },
    { date: '2018-03-12', type: 'child', description: 'first child', weight: 2 },
    { date: '2020-09-05', type: 'career', description: 'career change', weight: 2 },
  ],
  searchRangeMinutes: 120,
  stepMinutes: 5,
});

const best = result.candidates[0];
console.log(`Best candidate: ${best.timeFormatted}, score ${best.score.toFixed(2)}, ${result.count} candidates scored`);
console.log(`Candidates: ${result.candidates.length}`);

리케티피케이션은 다음에 가치가 있다:

• 시간을 모르는 사용자가 있는 앱: 프리미엄 기능으로 리케티피케이션을 제공해
• 전문 점성가 도구: 각 고객의 수작업 시간을 절감해
• HD 앱: Human Design은 시간에 매우 민감하므로 리케티피케이션으로 정확도가 크게 향상된다
• 연구용 앱: 시간 기록이 부정확한 역사 차트를 검증할 수 있다

다음에는 유용하지 않다:

• 사용자가 이미 ±5분 정확도로 시간을 알고 있는 앱(이점 없음)
• 일일 별자리와 같이 시간 정확도가 출력에 영향을 주지 않는 캐주얼한 점성 앱

• Trutine: 250 크레딧: 요청당 ~1–2초
• 전체 리케티피케이션: 500 크레딧: 최대 120초

이것은 API에서 가장 무거운 엔드포인트다. 리케티피케이션을 기능으로 제공한다면 그에 맞게 가격을 책정해라: 프리미엄 작업으로서 구독 요금이나 일회성 구매를 정당화한다.

예산 계획:

• 월 100회 리케티피케이션: ~50 000 크레딧 = Pro 플랜 ($59)이며 다른 호출 여유 포함
• 월 1 000회 리케티피케이션: 500 000 크레딧 = Enterprise

리케티피케이션은 시간이 걸린다. UI는 다음을 제공해야 한다:

• 비동기 처리: 요청을 차단하지 말고 큐에 넣고 진행 상황을 보여줘
• 프로그레스 인디케이터: 전체 엔드포인트는 최대 120초까지 실행되므로 사용자는 피드백이 필요하다
• 결과 표시: 보정된 시간, 신뢰도 수준, 사건이 부정확할 경우 재시작 옵션

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Running rectification (this may take up to 2 minutes)...');

  try {
    const result = await client.rectification.compute(input);
    setResult(result);
    const best = result.candidates[0];
    setStatus(`Done. Refined time: ${best.timeFormatted} (score ${best.score.toFixed(2)} of ${result.count})`);
  } catch (err) {
    setStatus(`Error: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

앱에서 일반적인 리케티피케이션 흐름:

1. 사용자가 대략적인 출생 데이터와 인생 사건을 입력한다
2. 앱은 먼저 /v1/rectification/trutine을 호출한다(저렴하고 빠르게) 창을 좁히기 위해
3. 그런 다음 /v1/rectification을 호출한다(전체) 보정된 창으로 정확도를 높인다
4. 앱은 결과를 캐시하고 모든 향후 계산에 보정된 시간을 사용한다
5. 이후 호출은 «rectified from approximate» 라벨이 붙는다

이런 조합 방식은 전체 사이클당 ~750 크레딧이 들지만 최고의 정확도를 제공한다.

리케티피케이션은 절대 100% 정확도를 제공하지 않는다. 심지어 전문 점성가도 5–10분 정도 차이가 난다.

AstroWay 알고리즘은 상대적인 정확도에 초점을 맞춘다 – 창을 좁히지만 결과는 항상 ‘최고 후보’로 표시될 뿐, 절대적인 진실은 아니다. 항상 사용자에게 confidence 점수를 보여주고, 더 좋은 정보가 있으면 재정의할 수 있게 해줘.

알고리즘은 패턴을 찾는 것이다. 경험 많은 점성가는 코딩하기 어려운 맥락을 고려한다: ‘결혼이 급했는가?’, ‘직업 전환이 자발적이었는가?’ 높은 스테이크의 차트에는 다음을 결합한다:

1. 알고리즘 리케티피케이션: 창을 좁히기 위해
2. 점성가의 수동 검토: 최종 보정을 위해

너의 앱은 이를 프리미엄 상담으로 제공할 수 있다.

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