Rectification API: születési idő korrekció fejlesztőknek

A legtöbb asztrológia iránt érdeklődő felhasználó ismeri a születési dátumát, de nem tudja a pontos időpontot. Akár 30 perces eltérés is 5 foknál nagyobb eltérést okozhat a ascendensben, ami megváltoztatja a házak és aspektusok helyzetét. A komoly asztrológiai munkához ez fontos.

Az asztrológusok által használt módszer, amellyel ezt korrigálják, a rektifikáció – a születési idő valószínűsíthető helyreállítása az élet fontos eseményei alapján. Hagyományosan ez kézi munka órákig tartó folyamata. Az AstroWay két algoritmikus endpointot kínál, amelyek automatizálják ezt a folyamatot.

Ebben a bejegyzésben arról lesz szó, hogy mikor érdemes alkalmazni a rektifikációt, hogyan működnek az algoritmusok, és hogyan integrálhatod őket a saját alkalmazásodba.

A rektifikáció a születési idő korrigálása. Kezdetben egy hozzávetőleges időponttal rendelkezel (például „reggel” vagy „körülbelül 14:00”), és a következők segítségével szűkíted le:

• Élet fontos eseményei (házasság, gyerek, karrierváltozás, halálesetek)
• Fizikai jellemzők (a klasszikus asztrológia az ascendens jelet a testalkatra képezi le)
• Sarkcsillagok pozíciói a születéskor

A végeredmény egy pontosított születési idő, általában a valós időtől ±5 percen belül.

A klasszikus módszer, amelyet Hermész Triszmegisztosznak tulajdonítanak. A Hold pozícióját használja a születéskor, valamint az ascendens/descendens pozícióját a fogantatáskor (~9 hónappal korábban).

Hogyan működik:

1. Megadod a hozzávetőleges születési dátumot
2. Kiszámítod a fogantatási dátumok tartományát (260–290 nappal korábban)
3. Minden lehetséges fogantatási dátumra ellenőrzöd, hogy a Hold pozíciója a születéskor megfelel-e az ascendens/descendens pozíciójának a fogantatáskor
4. Visszaadja a lehetséges születési időpontok listáját, fit szerint rendezve

Gyors, de kevésbé pontos. Jó a széles időablak szűkítéséhez (például „reggel” → 2 órás ablak).

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(`Legjobb jelölt: ${result.bestTime}`);
console.log(`Bizonyosság: ${result.confidence}`);

Életesemények alapján működő algoritmikus megközelítés. Ez a nehezebb változat (akár 120 másodpercig is tarthat egy kérés).

Bemenet:

• Hozzávetőleges születési idő (tartomány)
• Életesemények listája dátumokkal és típusokkal
• Opcionálisan: fizikai leírás

Algoritmus:

1. Generál lehetséges születési időket a tartományon belül (általában 1 perces lépésközzel)
2. Minden jelöltre kiszámítja a natal chartot
3. Pontszámot ad minden jelöltnek az események egyezése alapján az asztrológiai mintákkal (progressziók, direktiók, tranzitok)
4. Visszaadja a legjobb jelölteket a bizonyosság értékkel együtt

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(`Rektifikált idő: ${result.bestTime}`);
console.log(`Jelöltek száma: ${result.candidates.length}`);

A rektifikáció értékes lehet a következő esetekben:

• Alkalmazások, ahol a felhasználók nem ismerik a pontos időpontot — kínáld a rektifikációt prémium funkcióként
• Professzionális asztrológiai eszközök — órákig tartó kézi munka megtakarítása minden ügyfélnél
• HD-alkalmazások — a Human Design nagyon érzékeny az időpontra; a rektifikáció jelentősen növeli a pontosságot
• Kutatói alkalmazások — történelmi chartok validálása, ahol a pontos időpont nem ismert

Nem hasznos a következő esetekben:

• Alkalmazások, ahol a felhasználó már ismeri a pontos időpontot ±5 perces pontossággal (nincs előnye)
• Alkalmi horoszkópalkalmazások, ahol a pontos időpont nem befolyásolja a kimenetet (például napi sun sign)

• Trutine: 250 credit — ~1–2 másodperc kérésenként
• Teljes rektifikáció: 500 credit — akár 120 másodperc

Ezek a legnehezebb endpointok az API-ban. Ha a rektifikációt prémium funkcióként kínálod, megfelelően árazd be: ez egy prémium művelet, amely indokolttá teszi a magasabb havi előfizetési díjat vagy az egyszeri vásárlást.

Költségvetés tervezése:

• 100 rektifikáció havonta: ~50 000 credit = Pro terv ($59) plusz tartalék más hívásokra
• 1 000 rektifikáció havonta: 500 000 credit = Enterprise

A rektifikáció időt igényel. A UI-nak tartalmaznia kell:

• Aszinkron feldolgozást — ne blokkolja a kérést; helyezd sorba, és mutasd a folyamatot
• Folyamatjelzőt — a teljes endpoint akár 120 másodpercig is fut; a felhasználónak visszajelzésre van szüksége
• Eredmény megjelenítését — pontosított idő, bizonyosság szintje, lehetőség az újraindításra, ha az események pontatlanok

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Rektifikáció futtatása (ez akár 2 percig is eltarthat)...');

  try {
    const result = await client.rectification(input);
    setResult(result);
    setStatus(`Kész. Pontosított idő: ${result.bestTime} (bizonyosság: ${result.confidence}%)`);
  } catch (err) {
    setStatus(`Hiba: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

A tipikus rektifikációs folyamat egy alkalmazásban:

1. A felhasználó megadja a hozzávetőleges születési adatait + életeseményeket
2. Az alkalmazás először a /v1/rectification/trutine endpointot hívja meg (olcsó, gyors), hogy szűkítse az ablakot
3. Ezután a /v1/rectification (teljes) endpointot hívja meg a pontosított ablakkal a pontosság érdekében
4. Az alkalmazás cache-elni fogja az eredményt, és a pontosított időt fogja használni minden jövőbeli számításhoz
5. A jövőbeli hívásokat „rektifikált a hozzávetőlegestől” címkével látja el

Ez a kombinált megközelítés ~750 creditbe kerül egy teljes ciklusban, de a legjobb pontosságot nyújtja.

A rektifikáció soha nem ad 100%-os pontosságot. Még a professzionális asztrológusok is 5–10 perces eltérésekkel dolgoznak.

Az AstroWay algoritmusa a relatív pontosságra törekszik — szűkíti az ablakot, de a kimenetet mindig „legjobb jelöltként” mutatja, nem pedig garantált igazságként. Mindig mutasd meg a felhasználónak a bizonyosság értékét, és adj lehetőséget a módosításra, ha nála jobb információ áll rendelkezésre.

Az algoritmusok minták keresése. Egy tapasztalt asztrológus figyelembe veszi a kontextust, amit nehéz kódolni: „A házasság sietős volt?” „A karrierváltozás önkéntes volt?” Magas tétű chartok esetén kombináld:

1. Algoritmikus rektifikációt — az ablak szűkítéséhez
2. Kézi átvizsgálást asztrológus által — a végső pontosításhoz

Az alkalmazásod kínálhatja ezt prémium konzultációként.

• API referencia — keresd a rectification és rectification/trutine endpointokat
• Árazás — creditek szerinti költség a tervtől függően
• Gyors kezdés — szerezz API-kulcsot