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

A legtöbb asztrológiai felhasználó ismeri a születési dátumot, de nem ismeri a pontos időt. A 30 perces eltérés akár 5+ fokkal eltolhatja az aszcendenst – és ez megváltoztatja a házak és aszpektusok helyzetét. Komoly asztrológiai munkához ez fontos.

A technika, amellyel az asztrológusok ezt javítják, rektifikáció – a születési idő valószínűségének visszaállítása a known élet eseményekből. Hagyományosan ez órákat igényel kézi munkával. AstroWay két algoritmikus endpointot biztosít, amelyek automatizálják.

Ebben a bejegyzésben – mikor kell alkalmazni a rektifikációt, hogyan működnek az algoritmusok és hogyan integráld azt a saját alkalmazásodba.

A rektifikáció – ez a születési idő korrekciója. Te kezded egy hozzávetőleges idővel (például “reggel” vagy “körül 14:00”) és szűkíted azt, a következőket felhasználva:

• Fontos élet események (házasodás, gyerekek, karrierváltás, halálozások)
• Fizikai jellemzők (a klasszikus asztrológia a aszcendens jelet a testtípusokra térképezi)
• A bolygók szögtartásai a születéskor

A kimenet – pontosított születési idő, általában ±5 perc pontossággal a valóságtól.

Klasszikus módszer, amely Hermes Trismegistushoz köthető. A Hold pozíciója a születés pillanatában és az aszcendens / descendant a megtermékenyülés pillanatában (~9 hónappal korábban) közötti kapcsolatot használja.

Hogyan működik:

1. Vesszük a hozzávetőleges születési dátumot
2. Kiszámoljuk a megtermékenyülés dátumtartományát (260–290 nappal korábban)
3. Minden lehetséges megtermékenyülési dátumnál ellenőrizzük, hogy a születéskor a Hold pozíciója megfelel-e az aszcendensnek / descendantnek a megtermékenyülés pillanatában
4. Visszaadunk egy listát a lehetséges születési időpontokról, fit alapján rendezve

Gyors, de kevésbé pontos. Jó a széles ablak szűkítésére (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}`);

Algoritmikus megközelítés több élet esemény alapján. Ez egy nehéz változat (max 120 s kérésenként).

Bemenet:

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

Algoritmus:

1. Generál lehetséges születési időpontokat a tartományon belül (általában 1 perces lépésközzel)
2. Minden jelölt esetén kiszámítja a natális képet
3. Mérlegeli, mennyire egyeznek az események a várható asztrológiai mintákkal (progressziók, direkciók, tranzitok)
4. Visszaadja a top jelölteket a bizalmi értékelésekkel

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

• Alkalmazások felhasználókkal, akik nem ismerik az időt: ajánld a rektifikációt premium funkcióként
• Professzionális asztrológus eszközök: órákat takarít meg kézi munkával minden ügyfélnél
• HD-alkalmazások: a Human Design nagyon érzékeny az időre; a rektifikáció drámaian javítja a pontosságot
• Kutatási alkalmazások: történelmi kártyák validálása, ahol az időfeljegyzések pontatlanok

Nem hasznos számára:

• Alkalmazások, ahol a felhasználó már ismeri az időt ±5 perc pontossággal (nincs előny)
• Alkalmazásos horoszkópok, ahol az időpont pontossága nem befolyásolja a kimenetet (a napi napjegy nem igényli)

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

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

Költségvetés tervezése:

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

A rektifikáció időt vesz igénybe. A UI-nak:

• Aszinkron feldolgozás: ne blokkolj kérést; tedd sorba, mutasd a folyamatot
• Progressz indikátor: a teljes endpoint legfeljebb 120 s-ig fut; a felhasználónak visszajelzésre van szüksége
• Eredmény megjelenítése: pontosított idő, bizalmi szint, újraindítás lehetősége, 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);
  }
}

Tipikus rektifikációs folyamat az alkalmazásban:

1. A felhasználó megadja a hozzávetőleges születési adatokat + élet eseményeket
2. Az alkalmazás először meghívja a /v1/rectification/trutine-t (olcsó, gyors), hogy szűkítse az ablakot
3. Ezután meghívja a /v1/rectification-t (teljes) a pontosabb ablakhoz
4. Az alkalmazás cache-eli az eredményt és a pontosított időt használja minden jövőbeli számításhoz
5. A jövőbeli hívások megkapják a “rectified from approximate” címkét

Ez a kombinált megközelítés ~750 kredit a teljes ciklusra, de a legjobb pontosságot nyújtja.

A rektifikáció soha nem ad 100 % pontosságot. Még a profi asztrológusok is 5–10 perc eltéréssel becsülnek.

Az AstroWay algoritmus relatív pontosságra van optimalizálva – szűkíti az ablakot, de a kimenet mindig “legjobb jelölt”ként jelenik meg, nem garantált igazságként. Mindig mutasd a felhasználóknak a confidence-értéket, és adj lehetőséget az újra meghatározásra, ha jobb információval rendelkeznek.

Az algoritmusok mintakeresésről szólnak. A tapasztalt asztrológus figyelembe veszi a nehezen kódolható kontextust: “Volt a házasság sietős?” “A karrierváltás önkéntes volt?” Magas tétű kártyák esetén kombináld:

1. Az algoritmikus rektifikációt: az ablak szűkítésére
2. Kézi asztrológusi áttekintést: a végső finomításra

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

• API reference: találd meg a rectification és rectification/trutine endpointokat
• Tarifák: a kredit költség a terv szerint
• Gyors start: szerezz API-kulcsot