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

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

La tecnica utilizzata dagli astrologi per correggere questo problema si chiama rettificazione - il recupero del probabile orario di nascita da eventi noti della vita. Tradizionalmente, questo richiede ore di lavoro manuale. AstroWay offre due endpoint algoritmi che lo automatizzano.

In questo post - quando applicare la rettificazione, come funzionano gli algoritmi e come integrarla nella tua applicazione.

La rettificazione è la correzione dell’orario di nascita. Inizi con un orario approssimativo (ad esempio, “mattina” o “intorno alle 14:00”) e lo restringi utilizzando:

• Eventi importanti della vita (matrimonio, figli, cambio di carriera, morti)
• Caratteristiche fisiche (l’astrologia classica mappa il segno ascendente ai tipi di corpo)
• Posizioni angolari dei pianeti al momento della nascita

In output - un orario di nascita raffinato, di solito entro ±5 minuti dal reale.

Metodo classico, attribuito a Hermes Trismegisto. Utilizza la connessione tra la posizione della Luna al momento della nascita e l’ascendente/descendente al momento del concepimento (~9 mesi prima).

Come funziona:

1. Prendi la data di nascita approssimativa
2. Calcola il range di date del concepimento (260-290 giorni prima)
3. Per ogni data di concepimento candidata, controlla se la posizione della Luna al momento della nascita corrisponde all’ascendente/descendente al momento del concepimento
4. Restituisci una lista di orari di nascita candidati, ordinati per adattamento

Veloce, ma meno preciso. Buono 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 algoritmo basato su più eventi della vita. Questo è un’opzione pesante (fino a 120 s per richiesta).

Input:

• Orario di nascita approssimativo (range)
• Elenco di eventi della vita con date e tipi
• Opzionalmente: descrizione fisica

Algoritmo:

1. Genera orari di nascita candidati all’interno del range (di solito con un passo di 1 minuto)
2. Per ogni candidato, calcola la carta natale
3. Punteggia ogni candidato in base a quanto gli eventi corrispondono ai pattern astrologici previsti (progressioni, direzioni, transiti)
4. Restituisci i migliori candidati con valutazioni 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 rettificazione è preziosa per:

• Applicazioni con utenti che non conoscono l’orario - offri la rettificazione come funzionalità premium
• Strumenti professionali per astrologi - risparmia ore di lavoro manuale per ogni cliente
• Applicazioni HD - Human Design è molto sensibile all’orario; la rettificazione migliora notevolmente la precisione
• Applicazioni di ricerca - valida le carte storiche, dove le registrazioni dell’orario sono imprecise

Non utile per:

• Applicazioni in cui l’utente già conosce l’orario con precisione ±5 min (nessun vantaggio)
• Applicazioni di oroscopi casuali, dove la precisione dell’orario non influenza l’output (il segno solare quotidiano non lo richiede)

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

Questi sono gli endpoint più pesanti dell’API. Se offri la rettificazione come funzionalità - tariffa di conseguenza: è un’operazione premium che giustifica un piano di abbonamento più alto o un acquisto singolo.

Pianificazione del budget:

• 100 rettificazioni al mese: ~50.000 crediti = piano Pro ($59) con margine per altre chiamate
• 1.000 rettificazioni al mese: 500.000 crediti = Enterprise

La rettificazione richiede tempo. L’interfaccia utente deve:

• Elaborazione asincrona - non bloccare la richiesta; mettila in coda, mostra il progresso
• Indicatore di progresso - l’endpoint completo funziona fino a 120 s; l’utente richiede feedback
• Visualizzazione del risultato - orario raffinato, livello di confidenza, possibilità di riavvio 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);
  }
}

Flusso tipico di rettificazione nell’applicazione:

1. L’utente immette dati di nascita approssimativi + eventi della vita
2. L’applicazione chiama prima /v1/rectification/trutine (a buon mercato, veloce) per restringere la finestra
3. Poi chiama /v1/rectification (completa) con la finestra ristretta per la precisione
4. L’applicazione memorizza nella cache il risultato e utilizza l’orario raffinato per tutti i calcoli futuri
5. Le chiamate future sono contrassegnate con l’etichetta «rettificato da approssimativo»

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

La rettificazione non offre mai una precisione del 100%. Anche gli astrologi professionisti differiscono nelle loro stime di 5-10 minuti.

L’algoritmo AstroWay è orientato verso la precisione relativa - restringe la finestra, ma l’output è sempre posizionato come «miglior candidato», non come verità garantita. Mostra sempre all’utente la valutazione di confidenza e offri la possibilità di ridefinire se dispone di informazioni migliori.

Gli algoritmi sono una ricerca di pattern. Un astrologo esperto tiene conto del contesto, che è difficile da codificare: «È stato il matrimonio precipitoso?» «È stato il cambio di carriera volontario?» Per le carte con poste in gioco elevate, combina:

1. Rettificazione algoritmo - per restringere la finestra
2. Revisione manuale dell’astrologo - per il raffinamento finale

La tua applicazione può offrire questo come consulenza premium.

• API reference - trova gli endpoint rectification e rectification/trutine
• Tariffe - costo in crediti per piano
• Guida rapida - ottieni la chiave API