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

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

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

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