Rectification API: korekta czasu urodzenia dla deweloperów

Większość użytkowników astrologii zna datę urodzenia, ale nie zna dokładnej godziny. Różnica 30 minut może przesunąć ascendent o 5+ stopni - a to zmienia położenie domów i aspekty. Dla poważnej pracy astrologicznej to ma znaczenie.

Technika, którą astrologowie to korygują, nazywa się rektyfikacja - odtworzenie prawdopodobnej godziny urodzenia na podstawie znanych wydarzeń życiowych. Tradycyjnie to godziny ręcznej pracy. AstroWay daje dwa algorytmiczne endpointy, które ją automatyzują.

W tym poście - kiedy stosować rektyfikację, jak działają algorytmy i jak zintegrować ją ze swoją aplikacją.

Rektyfikacja to korekta godziny urodzenia. Zaczynasz od przybliżonej godziny (np. “rano” czy “około 14:00”) i zawężasz ją, wykorzystując:

• Ważne wydarzenia życiowe (ślub, dzieci, zmiana kariery, zgony)
• Cechy fizyczne (klasyczna astrologia mapuje znak ascendentu na typy ciała)
• Pozycje kątowe planet w chwili urodzenia

Na wyjściu - doprecyzowana godzina urodzenia, zwykle w granicach ±5 minut od rzeczywistej.

Klasyczna metoda przypisywana Hermesowi Trismegistosowi. Wykorzystuje związek między pozycją Księżyca w chwili urodzenia a ascendentem / descendentem w chwili poczęcia (~9 miesięcy wcześniej).

Jak to działa:

1. Bierzemy przybliżoną datę urodzenia
2. Obliczamy zakres dat poczęcia (260–290 dni wcześniej)
3. Dla każdej kandydującej daty poczęcia sprawdzamy, czy pozycja Księżyca przy urodzeniu odpowiada ascendentowi / descendentowi w chwili poczęcia
4. Zwracamy listę kandydujących godzin urodzenia, posortowanych według dopasowania

Szybko, ale mniej dokładnie. Dobre do zawężenia szerokiego okna (np. “rano” → 2-godzinne okno).

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}`);

Algorytmiczne podejście oparte na wielu wydarzeniach życiowych. To ciężki wariant (do 120 s na żądanie).

Wejście:

• Przybliżona godzina urodzenia (zakres)
• Lista wydarzeń życiowych z datami i typami
• Opcjonalnie: opis fizyczny

Algorytm:

1. Generuje kandydujące godziny urodzenia wewnątrz zakresu (zwykle z krokiem 1 minuta)
2. Dla każdego kandydata liczy kartę natalną
3. Ocenia każdego, na ile wydarzenia zgadzają się z przewidywanymi wzorcami astrologicznymi (progresje, dyrekcje, tranzyty)
4. Zwraca topowych kandydatów z ocenami pewności

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}`);

Rektyfikacja jest cenna dla:

• Aplikacji z użytkownikami, którzy nie znają godziny: oferuj rektyfikację jako funkcję premium
• Profesjonalnych narzędzi astrologa: oszczędza godziny ręcznej pracy przy każdym kliencie
• Aplikacji HD: Human Design jest bardzo wrażliwy na godzinę; rektyfikacja radykalnie poprawia dokładność
• Aplikacji badawczych: walidacja historycznych kart, gdzie zapisy godziny są niedokładne

Nieprzydatna dla:

• Aplikacji, gdzie użytkownik już zna godzinę z dokładnością do ±5 min (brak korzyści)
• Casualowych aplikacji horoskopowych, gdzie dokładność godziny nie wpływa na wynik (codzienny sun sign jej nie potrzebuje)

• Trutine: 250 kredytów: ~1–2 sekundy na żądanie
• Pełna rektyfikacja: 500 kredytów: do 120 sekund

To najcięższe endpointy w API. Jeśli oferujesz rektyfikację jako funkcję - wyceniaj odpowiednio: to operacja premium, która uzasadnia wyższy plan subskrypcji lub jednorazowy zakup.

Planowanie budżetu:

• 100 rektyfikacji miesięcznie: ~50 000 kredytów = plan Pro ($59) z zapasem na inne wywołania
• 1 000 rektyfikacji miesięcznie: 500 000 kredytów = Enterprise

Rektyfikacja zajmuje czas. UI powinien mieć:

• Przetwarzanie asynchroniczne: nie blokuj żądania; ustaw je w kolejce, pokaż postęp
• Wskaźnik postępu: pełny endpoint działa do 120 s; użytkownik potrzebuje informacji zwrotnej
• Prezentację wyniku: doprecyzowana godzina, poziom pewności, możliwość ponownego uruchomienia, jeśli wydarzenia są niedokładne

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);
  }
}

Typowy flow rektyfikacji w aplikacji:

1. Użytkownik wprowadza przybliżone dane urodzenia + wydarzenia życiowe
2. Aplikacja najpierw wywołuje /v1/rectification/trutine (tanio, szybko), aby zawęzić okno
3. Potem wywołuje /v1/rectification (pełna) z doprecyzowanym oknem dla dokładności
4. Aplikacja cache’uje wynik i używa doprecyzowanej godziny do wszystkich przyszłych obliczeń
5. Przyszłe wywołania oznaczane są etykietą “rectified from approximate”

Takie połączone podejście - ~750 kredytów za pełny cykl, ale daje najlepszą dokładność.

Rektyfikacja nigdy nie daje 100% dokładności. Nawet profesjonalni astrologowie różnią się w ocenach o 5–10 minut.

Algorytm AstroWay celuje w dokładność względną - zawęża okno, ale wynik zawsze jest pozycjonowany jako “najlepszy kandydat”, a nie jako gwarantowana prawda. Zawsze pokazuj użytkownikom ocenę confidence i daj możliwość nadpisania, jeśli mają lepsze informacje.

Algorytmy to wyszukiwanie wzorców. Doświadczony astrolog uwzględnia kontekst, który trudno zakodować: “Czy ślub był pośpieszny?” “Czy zmiana kariery była dobrowolna?” Dla kart o wysokiej stawce łącz:

1. Rektyfikację algorytmiczną: aby zawęzić okno
2. Ręczny przegląd astrologa: dla ostatecznego doprecyzowania

Twoja aplikacja może oferować to jako konsultację premium.

• API reference: znajdź endpointy rectification oraz rectification/trutine
• Cennik: koszt w kredytach według planu
• Szybki start: zdobądź klucz API