Rectification API: correzione dell'orario di nascita per gli sviluppatori

La maggior parte degli utenti di astrologia conosce la data di nascita, ma non l’ora esatta. Una differenza di 30 minuti può spostare l’ascendente di 5+ gradi - e questo cambia le posizioni delle case e gli aspetti. Per un lavoro astrologico serio, questo conta.

La tecnica con cui gli astrologi correggono questo problema si chiama rettifica - il recupero dell’ora di nascita probabile a partire da eventi di vita noti. Tradizionalmente richiede ore di lavoro manuale. AstroWay offre due endpoint algoritmici che la automatizzano.

In questo post: quando usare la rettifica, come funzionano gli algoritmi e come integrarla nella tua app.

La rettifica è la correzione dell’ora di nascita. Parti da un’ora approssimativa (ad esempio, “mattina” o “verso le 14:00”) e la restringi usando:

• Eventi importanti della vita (matrimonio, figli, cambio di carriera, decessi)
• Caratteristiche fisiche (l’astrologia classica associa il segno ascendente a tipologie corporee)
• Posizioni angolari dei pianeti alla nascita

Il risultato è un’ora di nascita raffinata, di solito entro ±5 minuti da quella reale.

Metodo classico attribuito a Ermete Trismegisto. Usa la relazione tra la posizione della Luna al momento della nascita e l’ascendente / discendente al momento del concepimento (~9 mesi prima).

Come funziona:

1. Prendiamo la data di nascita approssimativa
2. Calcoliamo l’intervallo di date di concepimento (260–290 giorni prima)
3. Per ogni data di concepimento candidata verifichiamo se la posizione della Luna alla nascita corrisponde all’ascendente / discendente al momento del concepimento
4. Restituiamo una lista di orari di nascita candidati, ordinati per fit

Veloce, ma meno preciso. Ottimo per restringere una finestra ampia (ad esempio, “mattina” → finestra di 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}`);

Approccio algoritmico basato su più eventi di vita. È la variante pesante (fino a 120 s per richiesta).

Input:

• Ora di nascita approssimativa (intervallo)
• Lista di eventi di vita con date e tipi
• Opzionale: descrizione fisica

Algoritmo:

1. Genera orari di nascita candidati all’interno dell’intervallo (di solito con passo di 1 minuto)
2. Per ogni candidato calcola la carta natale
3. Assegna a ciascuno un punteggio in base a quanto gli eventi corrispondono ai pattern astrologici previsti (progressioni, direzioni, transiti)
4. Restituisce i migliori candidati con punteggi di confidenza

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

La rettifica è preziosa per:

• App con utenti che non conoscono l’ora: offri la rettifica come funzionalità premium
• Strumenti professionali per astrologi: risparmia ore di lavoro manuale per ogni cliente
• App HD: Human Design è molto sensibile all’ora; la rettifica migliora drasticamente la precisione
• App di ricerca: validare carte storiche dove i registri orari sono imprecisi

Non è utile per:

• App in cui l’utente conosce già l’ora con precisione di ±5 min (nessun beneficio)
• App di oroscopi casuali dove la precisione dell’ora non influenza l’output (il sun sign quotidiano non ne ha bisogno)

• Trutine: 250 crediti: ~1–2 secondi per richiesta
• Rettifica completa: 500 crediti: fino a 120 secondi

Sono gli endpoint più pesanti dell’API. Se offri la rettifica come funzionalità, tariffa di conseguenza: è un’operazione premium che giustifica un piano di abbonamento più alto o un acquisto una tantum.

Pianificazione del budget:

• 100 rettifiche al mese: ~50 000 crediti = piano Pro ($59) con margine per altre chiamate
• 1 000 rettifiche al mese: 500 000 crediti = Enterprise

La rettifica richiede tempo. La UI deve avere:

• Elaborazione asincrona: non bloccare la richiesta; mettila in coda e mostra il progresso
• Indicatore di progresso: l’endpoint completo lavora fino a 120 s; l’utente ha bisogno di feedback
• Visualizzazione del risultato: ora raffinata, livello di confidenza, possibilità di rilanciare se gli eventi sono imprecisi

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 tipico di rettifica in un’app:

1. L’utente inserisce dati di nascita approssimativi + eventi di vita
2. L’app chiama prima /v1/rectification/trutine (economico, veloce) per restringere la finestra
3. Poi chiama /v1/rectification (completa) con la finestra raffinata per la precisione
4. L’app mette in cache il risultato e usa l’ora raffinata per tutti i calcoli futuri
5. Le chiamate future vengono contrassegnate con l’etichetta “rectified from approximate”

Questo approccio combinato costa ~750 crediti per ciclo completo, ma offre la migliore precisione.

La rettifica non dà mai una precisione del 100%. Anche gli astrologi professionisti divergono di 5–10 minuti nelle loro stime.

L’algoritmo di AstroWay punta alla precisione relativa - restringe la finestra, ma l’output è sempre presentato come “miglior candidato”, non come verità garantita. Mostra sempre agli utenti il punteggio di confidenza e dai loro la possibilità di sovrascrivere se hanno informazioni migliori.

Gli algoritmi cercano pattern. Un astrologo esperto considera contesti difficili da codificare: “Il matrimonio è stato affrettato?” “Il cambio di carriera era volontario?” Per carte ad alta posta in gioco, combina:

1. Rettifica algoritmica: per restringere la finestra
2. Revisione manuale di un astrologo: per il raffinamento finale

La tua app può offrire questo come consulenza premium.

• API reference: trova gli endpoint rectification e rectification/trutine
• Prezzi: costo in crediti per piano
• Quick start: ottieni la tua API key