Rectification API: корекція часу народження для розробників

Більшість користувачів астрології знають дату народження, але не знають точний час. Різниця в 30 хвилин може зсунути асцендент на 5+ градусів — і це змінює положення домів та аспекти. Для серйозної астрологічної роботи це важливо.

Техніка, якою астрологи це виправляють, називається ректифікація — відновлення ймовірного часу народження з відомих подій життя. Традиційно це години ручної роботи. AstroWay дає два алгоритмічні ендпоінти, які її автоматизують.

У цьому пості — коли застосовувати ректифікацію, як працюють алгоритми та як інтегрувати її у свій застосунок.

Ректифікація — це корекція часу народження. Ти починаєш з приблизного часу (наприклад, «ранок» чи «близько 14:00») і звужуєш його, використовуючи:

• Важливі події життя (одруження, діти, зміна кар’єри, смерті)
• Фізичні характеристики (класична астрологія мапить знак асцендента на типи тіла)
• Кутові позиції планет при народженні

На виході — уточнений час народження, зазвичай у межах ±5 хвилин від реального.

Класичний метод, приписаний Гермесу Трисмегіста. Використовує зв’язок між позицією Місяця у момент народження та асцендентом / десцендентом у момент зачаття (~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. Для кожного кандидата рахує натальну карту
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}`);

Ректифікація цінна для:

• Застосунків із користувачами, які не знають часу — пропонуй ректифікацію як premium-фічу
• Професійних інструментів астролога — економить години ручної роботи на кожного клієнта
• HD-застосунків — Human Design дуже чутливий до часу; ректифікація різко покращує точність
• Дослідницьких застосунків — валідувати історичні карти, де записи часу неточні

Не корисна для:

• Застосунків, де користувач уже знає час із точністю до ±5 хв (вигоди немає)
• Казуальних гороскопних застосунків, де точність часу не впливає на вивід (щоденний sun sign її не потребує)

• 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(input);
    setResult(result);
    setStatus(`Done. Refined time: ${result.bestTime} (confidence ${result.confidence}%)`);
  } catch (err) {
    setStatus(`Error: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

Типовий flow ректифікації у застосунку:

1. Користувач вводить приблизні дані народження + події життя
2. Застосунок спершу кличе /v1/rectification/trutine (дешево, швидко), щоб звузити вікно
3. Потім кличе /v1/rectification (повна) з уточненим вікном для точності
4. Застосунок кешує результат і використовує уточнений час для всіх майбутніх обчислень
5. Майбутні виклики позначаються міткою «rectified from approximate»

Такий комбінований підхід — ~750 кредитів на повний цикл, але дає найкращу точність.

Ректифікація ніколи не дає 100% точність. Навіть професійні астрологи розходяться в оцінках на 5–10 хвилин.

Алгоритм AstroWay орієнтований на відносну точність — звужує вікно, але вивід завжди позиціонується як «найкращий кандидат», а не як гарантована істина. Завжди показуй користувачам confidence-оцінку й дай можливість перевизначити, якщо в нього є краща інформація.

Алгоритми — це пошук патернів. Досвідчений астролог враховує контекст, який складно закодувати: «Чи було одруження поспішним?» «Чи була зміна кар’єри добровільною?» Для карт із високими ставками комбінуй:

1. Алгоритмічну ректифікацію — щоб звузити вікно
2. Ручний огляд астрологом — для фінального уточнення

Твій застосунок може пропонувати це як преміум-консультацію.

• API reference — знайди ендпоінти rectification та rectification/trutine
• Тарифи — вартість у кредитах за планом
• Швидкий старт — отримай API-ключ