API Rectificare: corectarea orei de naștere pentru dezvoltatori

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

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

În acest articol - când să aplici 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 jurul orei 14:00”) și o restrângi folosind:

• Evenimente importante din viață (căsătorii, copii, schimbări de carieră, decese)
• Caracteristici fizice (astrologia clasică mapează semnul ascendentului pe tipuri corporale)
• Poziții unghiulare ale planetelor la naștere

Rezultatul - o oră de naștere rafinată, de obicei în intervalul ±5 minute față de cea reală.

Metodă clasică atribuită lui Hermes Trismegist. Folosește legătura dintre poziția Lunii în momentul nașterii și ascendentul / descendentul în momentul concepției (~9 luni mai devreme).

Cum funcționează:

1. Luăm data aproximativă a nașterii
2. Calculăm intervalul de date ale concepției (260–290 de zile mai devreme)
3. Pentru fiecare dată candidată de concepție verificăm dacă poziția Lunii la naștere corespunde ascendentului / descendentului în momentul concepției
4. Returnăm lista orelor candidate de naștere, sortate după fit

Rapid, dar mai puțin precis. Bun pentru restrângerea unei ferestre largi (de exemplu, “dimineața” → fereastră 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}`);

Abordare algoritmică bazată pe mai multe evenimente de viață. Este varianta grea (până la 120 s pe cerere).

Input:

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

Algoritmul:

1. Generează ore candidate de naștere în interiorul intervalului (de obicei cu pas de 1 minut)
2. Pentru fiecare candidat calculează harta natală
3. Punctează fiecare candidat după cât de bine se potrivesc evenimentele cu pattern-urile astrologice prezise (progresii, direcții, tranzite)
4. Returnează top 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: oferă rectificarea ca 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 drastic precizia
• Aplicații de cercetare: validarea hărților istorice unde înregistrările orelor sunt imprecise

Nu este utilă pentru:

• Aplicații în care utilizatorul cunoaște deja ora cu precizie de ±5 min (nu există beneficiu)
• Aplicații casual de horoscop unde precizia orei nu influențează output-ul (sun sign-ul zilnic nu are nevoie de ea)

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

Acestea sunt cele mai grele endpoint-uri din API. Dacă oferi rectificarea ca funcționalitate - tarifează corespunzător: este o operație premium care justifică un plan de abonament mai scump sau o achiziție unică.

Planificarea bugetului:

• 100 de rectificări pe lună: ~50 000 credite = planul Pro ($59) cu rezervă pentru alte apeluri
• 1 000 de rectificări pe lună: 500 000 credite = Enterprise

Rectificarea durează. UI-ul trebuie să aibă:

• Procesare asincronă: nu bloca cererea; pune-o în coadă, arată progresul
• Indicator de progres: endpoint-ul complet rulează până la 120 s; utilizatorul are nevoie de feedback
• Afișarea rezultatului: ora rafinată, nivelul de încredere, posibilitatea de a relua dacă evenimentele sunt imprecise

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

Flow-ul tipic de rectificare într-o aplicație:

1. Utilizatorul introduce datele aproximative de naștere + evenimentele de viață
2. Aplicația apelează mai întâi /v1/rectification/trutine (ieftin, rapid) pentru a restrânge fereastra
3. Apoi apelează /v1/rectification (completă) cu fereastra rafinată pentru precizie
4. Aplicația cache-uiește rezultatul și folosește ora rafinată pentru toate calculele viitoare
5. Apelurile viitoare sunt marcate cu eticheta “rectified from approximate”

Această abordare combinată - ~750 credite pe ciclu complet, dar oferă cea mai bună precizie.

Rectificarea nu oferă niciodată 100% precizie. Chiar și astrologii profesioniști diferă în estimări cu 5–10 minute.

Algoritmul AstroWay vizează precizia relativă - restrânge fereastra, dar output-ul este întotdeauna poziționat ca “cel mai bun candidat”, nu ca adevăr garantat. Arată întotdeauna utilizatorilor scorul de încredere și oferă-le posibilitatea de a suprascrie dacă au informații mai bune.

Algoritmii sunt căutare de pattern-uri. Un astrolog experimentat ia în considerare context greu de codificat: “A fost căsătoria pripită?” “A fost schimbarea de carieră voluntară?” Pentru hărți cu mize mari, combină:

1. Rectificarea algoritmică: pentru a restrânge fereastra
2. Revizuirea manuală de către un astrolog: pentru rafinarea finală

Aplicația ta poate oferi acest lucru ca consultație premium.

• API reference: găsește endpoint-urile rectification și rectification/trutine
• Tarife: costul în credite pe plan
• Quick start: obține cheia API