API Rectificare: corectarea orei de naștere pentru dezvoltatori

Majoritatea utilizatorilor de astrologie cunosc data nașterii, dar nu și ora exactă. O diferență de 30 de minute poate deplasa ascendentul cu peste 5 grade - și asta schimbă pozițiile caselor și aspectele. Pentru o muncă astrologică serioasă, asta contează.

Tehnica prin care astrologii corectează asta se numește rectificare - restabilirea orei probabile de naștere pornind de la evenimentele cunoscute din viață. În mod tradițional, asta înseamnă ore de muncă manuală. AstroWay oferă două endpoint-uri algoritmice care automatizează acest proces.

În acest articol - când să folosești rectificarea, cum funcționează algoritmii și cum să o integrezi în aplicația ta.

Rectificarea este corectarea orei de naștere. Pornești de la o oră aproximativă (de exemplu, „dimineața” sau „în jur de 14:00”) și o rafinezi folosind:

• Evenimente importante din viață (căsătorie, copii, schimbarea carierei, decese)
• Caracteristici fizice (astrologia clasică leagă semnul ascendentului de tipurile de corp)
• Pozițiile unghiulare ale planetelor la naștere

Rezultatul este o oră de naștere mai precisă, de obicei în intervalul ±5 minute față de ora reală.

O metodă clasică, atribuită lui Hermes Trismegistus. Folosește legătura dintre poziția Lunii la naștere și ascendentul/descendentul la momentul concepției (cu ~9 luni mai devreme).

Cum funcționează:

1. Ia data aproximativă de naștere
2. Calculează intervalul de date pentru concepție (260–290 de zile mai devreme)
3. Pentru fiecare dată candidată de concepție, verifică dacă poziția Lunii la naștere corespunde cu ascendentul/descendentul la momentul concepției
4. Returnează o listă de ore candidate de naștere, sortate după „fit”

Rapid, dar mai puțin precis. Bun pentru a restrânge un interval larg (de exemplu, „dimineața” → un interval de 2 ore).

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

O abordare algoritmică bazată pe mai multe evenimente din viață. Aceasta este varianta grea (până la 120 de secunde pe cerere).

Intrare:

• Ora aproximativă de naștere (interval)
• Listă de evenimente din viață cu date și tipuri
• Opțional: descriere fizică

Algoritm:

1. Generează ore candidate de naștere în interiorul intervalului (de obicei cu un pas de 1 minut)
2. Pentru fiecare candidat, calculează harta natală
3. Scorulează fiecare candidat în funcție de cât de bine evenimentele se potrivesc cu modelele astrologice prezise (progresii, direcții, tranzite)
4. Returnează cei mai buni candidați cu scoruri de încredere

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

Rectificarea este valoroasă pentru:

• Aplicații cu utilizatori care nu cunosc ora exactă - oferă rectificarea ca o funcționalitate premium
• Instrumente profesionale pentru astrologi - economisește ore de muncă manuală pentru fiecare client
• Aplicații HD - Human Design este foarte sensibil la oră; rectificarea îmbunătățește dramatic precizia
• Aplicații de cercetare - validează hărți istorice unde înregistrările orare sunt inexacte

Nu este utilă pentru:

• Aplicații în care utilizatorul cunoaște deja ora cu o precizie de ±5 minute (nu există beneficii)
• Aplicații casual de horoscop unde precizia orei nu afectează rezultatul (zodiile zilnice nu au nevoie de ea)

• Trutina: 250 de credite - ~1–2 secunde pe cerere
• Rectificare completă: 500 de credite - până la 120 de secunde

Acestea sunt cele mai solicitante endpoint-uri din API. Dacă oferi rectificarea ca funcționalitate - taxează corespunzător: este o operațiune premium care justifică un tarif mai ridicat pentru abonament sau o achiziție unică.

Planificarea bugetului:

• 100 rectificări pe lună: ~50.000 de credite = planul Pro ($59) cu rezervă pentru alte apeluri
• 1.000 rectificări pe lună: 500.000 de credite = Enterprise

Rectificarea durează. Interfața trebuie să:

• Proceseze asincron - nu bloca cererea; pune-o în coadă și arată progresul
• Indice progresul - un endpoint complet rulează până la 120 de secunde; utilizatorul are nevoie de feedback
• Arate rezultatul - ora rectificată, nivelul de încredere, opțiunea de a relansa dacă evenimentele sunt inexacte

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

Un flux tipic de rectificare în aplicație:

1. Utilizatorul introduce datele aproximative de naștere + evenimente din viață
2. Aplicația apelează mai întâi /v1/rectification/trutine (ieftin, rapid) pentru a restrânge intervalul
3. Apoi apelează /v1/rectification (complet) cu intervalul rafinat pentru precizie
4. Aplicația memorează rezultatul și folosește ora rectificată pentru toate calculele viitoare
5. Viitoarele apeluri sunt marcate cu „rectificat din aproximativ”

Această abordare combinată costă ~750 de credite pentru un ciclu complet, dar oferă cea mai bună precizie.

Rectificarea nu oferă niciodată o precizie de 100%. Chiar și astrologii profesioniști au estimări care diferă cu 5–10 minute.

Algoritmul AstroWay este orientat către precizie relativă - restrânge intervalul, dar rezultatul este întotdeauna poziționat ca „cel mai bun candidat”, nu ca adevăr garantat. Arată întotdeauna utilizatorilor scorul de încredere și oferă opțiunea de a-l reseta dacă au informații mai bune.

Algoritmii sunt căutători de modele. Un astrolog experimentat ia în considerare contextul pe care este greu de codificat: „Căsătoria a fost pripită?” „Schimbarea de carieră a fost voluntară?” Pentru hărți cu mize mari, combină:

1. Rectificarea algoritmică - pentru a restrânge intervalul
2. Revizuirea manuală de către astrolog - pentru rafinarea finală

Poți oferi asta ca o consultație premium în aplicația ta.

• Referință API - găsește endpoint-urile rectification și rectification/trutine
• Prețuri - costul în credite pe plan
• Start rapid - obține cheia API