Rectification API: korekta czasu urodzenia dla deweloperów

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

Technika, którą astrologowie stosują do korekty, nazywa się rektyfikacją — odtworzeniem prawdopodobnej godziny urodzenia na podstawie znanych wydarzeń życia. Tradycyjnie jest to godziny ręcznej pracy. AstroWay oferuje dwa algorytmiczne punkty końcowe, które ją automatyzują.

W tym poście — kiedy stosować rektyfikację, jak działają algorytmy i jak je integrować z własną aplikacją.

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

• Ważnych wydarzeń życia (małżeństwo, dzieci, zmiana kariery, śmierć)
• Cech fizycznych (klasyczna astrologia mapuje znak ascendentu na typy ciała)
• Pozycji planet w momencie urodzenia

Na wyjściu — uściślona godzina urodzenia, zwykle w granicach ±5 minut od rzeczywistej.

Klasyczna metoda, przypisywana Hermesowi Trismegistowi. Wykorzystuje związek między pozycją Księżyca w momencie urodzenia a ascendentem/descendentem w momencie 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 w momencie urodzenia odpowiada ascendentowi/descendentowi w momencie poczęcia
4. Zwracamy listę kandydujących godzin urodzenia, posortowanych według dopasowania

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

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(`Najlepszy kandydat: ${result.bestTime}`);
console.log(`Pewność: ${result.confidence}`);

Algorytmiczne podejście oparte na kilku wydarzeniach życia. To cięższa wersja (do 120 s na żądanie).

Wejście:

• Przybliżona godzina urodzenia (zakres)
• Lista wydarzeń życia 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 oblicza mapę urodzenia
3. Ocenia każdego, na ile wydarzenia zgadzają się z przewidywanymi wzorcami astrologicznymi (postępy, dyrektywy, transity)
4. Zwraca najlepszych kandydatów z ocenami pewności

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: 'małżeństwo' },
    { date: '2018-03-12', type: 'pierwsze dziecko' },
    { date: '2020-09-05', type: 'zmiana kariery' },
  ],
});

console.log(`Rektyfikowana godzina: ${result.bestTime}`);
console.log(`Kandydaci: ${result.candidates.length}`);

Rektyfikacja jest cenna dla:

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

Nie jest przydatna dla:

• Aplikacji, gdzie użytkownik już zna godzinę z dokładnością do ±5 min (brak korzyści)
• Kozuálních 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 punkty końcowe w API. Jeśli oferujesz rektyfikację jako funkcję — taryfikuj odpowiednio: to funkcja premium, która uzasadnia wyższy plan subskrypcyjny lub jednorazową kupię.

Planowanie budżetu:

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

Rektyfikacja zajmuje czas. Interfejs użytkownika powinien:

• Asynchroniczne przetwarzanie — nie blokuj żądania; umieść je w kolejce, pokaż postęp
• Wskaźnik postępu — pełny punkt końcowy działa do 120 s; użytkownik potrzebuje informacji zwrotnej
• Wyświetlanie wyniku — uściślona godzina, poziom pewności, możliwość ponownego uruchomienia, jeśli wydarzenia są niedokładne

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Uruchamiam rektyfikację (to może potrwać do 2 minut)...');

  try {
    const result = await client.rectification(input);
    setResult(result);
    setStatus(`Zakończono. Uściślona godzina: ${result.bestTime} (pewność ${result.confidence}%)`);
  } catch (err) {
    setStatus(`Błąd: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

Typowy przepływ rektyfikacji w aplikacji:

1. Użytkownik wprowadza przybliżone dane urodzenia + wydarzenia życia
2. Aplikacja najpierw wywołuje /v1/rectification/trutine (tanie, szybko), aby zawęzić okno
3. Następnie wywołuje /v1/rectification (pełna) z uściślonym oknem dla dokładności
4. Aplikacja buforuje wynik i używa uściślonej godziny dla wszystkich przyszłych obliczeń
5. Przyszłe wywołania są oznaczone etykietą «rektyfikowana z przybliżonej»

Taki połączony podejście — ~750 kredytów na 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 jest ukierunkowany na względną dokładność — zawęża okno, ale wynik zawsze jest pozycjonowany jako «najlepszy kandydat», a nie jako gwarantowana prawda. Zawsze pokazuj użytkownikom ocenę pewności i daj możliwość ponownego uruchomienia, jeśli mają lepszą informację.

Algorytmy to poszukiwanie wzorców. Doświadczony astrolog bierze pod uwagę kontekst, który jest trudny do zakodowania: «Czy małżeństwo było pośpieszne?» «Czy zmiana kariery była dobrowolna?» Dla map o wysokich stawkach łącz:

1. Algorytmiczną rektyfikację — aby zawęzić okno
2. Ręczny przegląd astrologa — dla ostatecznego uściślenia

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

• API reference — znajdź punkty końcowe rectification i rectification/trutine
• Cennik — koszt w kredytach za plan
• Szybki start — uzyskaj klucz API