API de Rectificación: corrección del tiempo de nacimiento para desarrolladores

La mayoría de los usuarios de astrología conocen su fecha de nacimiento, pero no conocen la hora exacta. Una diferencia de 30 minutos puede desplazar el ascendente en 5+ grados — y esto cambia la posición de las casas y los aspectos. Para un trabajo astrológico serio, esto es importante.

La técnica que los astrólogos utilizan para corregir esto se llama rectificación — la restauración del tiempo de nacimiento probable a partir de eventos de vida conocidos. Tradicionalmente, esto requiere horas de trabajo manual. AstroWay ofrece dos puntos finales algorítmicos que lo automatizan.

En este post — cuándo aplicar la rectificación, cómo funcionan los algoritmos y cómo integrarla en tu aplicación.

La rectificación es la corrección del tiempo de nacimiento. Comienzas con un tiempo aproximado (por ejemplo, “mañana” o “alrededor de las 14:00”) y lo reduces utilizando:

• Eventos importantes de la vida (matrimonio, hijos, cambio de carrera, muertes)
• Características físicas (la astrología clásica mapea el signo del ascendente en los tipos de cuerpo)
• Posiciones angulares de los planetas al nacer

La salida es un tiempo de nacimiento refinado, generalmente dentro de ±5 minutos del real.

Método clásico, atribuido a Hermes Trismegisto. Utiliza la conexión entre la posición de la Luna en el momento del nacimiento y el ascendente / descendente en el momento de la concepción (~9 meses antes).

Cómo funciona:

1. Tomamos la fecha de nacimiento aproximada
2. Calculamos el rango de fechas de concepción (260-290 días antes)
3. Para cada fecha de concepción candidata, verificamos si la posición de la Luna en el nacimiento coincide con el ascendente / descendente en el momento de la concepción
4. Devolvemos una lista de tiempos de nacimiento candidatos, ordenados por ajuste

Rápido, pero menos preciso. Bueno para reducir una ventana amplia (por ejemplo, “mañana” → ventana de 2 horas).

const result = await client.rectificationTrutine({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '12:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
});

console.log(`Mejor candidato: ${result.bestTime}`);
console.log(`Confianza: ${result.confidence}`);

Enfoque algorítmico basado en varios eventos de la vida. Este es un proceso pesado (hasta 120 s por solicitud).

Entrada:

• Tiempo de nacimiento aproximado (rango)
• Lista de eventos de la vida con fechas y tipos
• Opcional: descripción física

Algoritmo:

1. Genera tiempos de nacimiento candidatos dentro del rango (generalmente con un paso de 1 minuto)
2. Para cada candidato, calcula el mapa natal
3. Puntúa a cada uno según cuánto coinciden los eventos con los patrones astrológicos predecibles (progresiones, direcciones, tránsitos)
4. Devuelve los mejores candidatos con estimaciones de confianza

const result = await client.rectification({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '18:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
  events: [
    { date: '2015-06-20', type: 'matrimonio' },
    { date: '2018-03-12', type: 'primerHijo' },
    { date: '2020-09-05', type: 'cambioDeCarrera' },
  ],
});

console.log(`Tiempo rectificado: ${result.bestTime}`);
console.log(`Candidatos: ${result.candidates.length}`);

La rectificación es valiosa para:

• Aplicaciones con usuarios que no conocen la hora — ofrece la rectificación como una función premium
• Herramientas profesionales de astrólogo — ahorra horas de trabajo manual por cada cliente
• Aplicaciones HD — Human Design es muy sensible al tiempo; la rectificación mejora significativamente la precisión
• Aplicaciones de investigación — para validar mapas históricos donde los registros de tiempo son imprecisos

No es útil para:

• Aplicaciones donde el usuario ya conoce la hora con precisión de ±5 minutos (no hay beneficio)
• Aplicaciones de horóscopos casuales donde la precisión del tiempo no afecta la salida (el signo solar diario no la necesita)

• Trutine: 250 créditos — ~1-2 segundos por solicitud
• Rectificación completa: 500 créditos — hasta 120 segundos

Estos son los puntos finales más pesados de la API. Si ofrece la rectificación como una función — tarifique según corresponda: es una operación premium que justifica una tarifa de suscripción más alta o una compra única.

Planificación de presupuesto:

• 100 rectificaciones al mes: ~50 000 créditos = plan Pro ($59) con margen para otras llamadas
• 1 000 rectificaciones al mes: 500 000 créditos = Enterprise

La rectificación lleva tiempo. La interfaz de usuario debe:

• Procesar de forma asíncrona — no bloquee la solicitud; colóquela en cola, muestre el progreso
• Indicador de progreso — el punto final completo funciona hasta 120 s; el usuario necesita retroalimentación
• Mostrar el resultado — hora refinada, nivel de confianza, posibilidad de reiniciar si los eventos son imprecisos

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Ejecutando rectificación (esto puede tardar hasta 2 minutos)...');

  try {
    const result = await client.rectification(input);
    setResult(result);
    setStatus(`Listo. Hora refinada: ${result.bestTime} (confianza ${result.confidence}%)`);
  } catch (err) {
    setStatus(`Error: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

Flujo típico de rectificación en una aplicación:

1. El usuario ingresa datos de nacimiento aproximados + eventos de la vida
2. La aplicación llama primero a /v1/rectification/trutine (barato, rápido) para reducir la ventana
3. Luego llama a /v1/rectification (completa) con la ventana refinada para la precisión
4. La aplicación almacena en caché el resultado y lo utiliza para todos los cálculos futuros
5. Las llamadas futuras se marcan con la etiqueta “rectificado desde aproximado”

Este enfoque combinado es de ~750 créditos por ciclo completo, pero ofrece la mejor precisión.

La rectificación nunca da una precisión del 100%. Incluso los astrólogos profesionales difieren en sus estimaciones en 5-10 minutos.

El algoritmo de AstroWay se centra en la precisión relativa — reduce la ventana, pero la salida siempre se presenta como “el mejor candidato”, no como una verdad garantizada. Siempre muestre a los usuarios la estimación de confianza y déles la oportunidad de redefinir si tienen mejor información.

Los algoritmos son una búsqueda de patrones. Un astrólogo experimentado considera el contexto, que es difícil de codificar: “¿Fue el matrimonio apresurado?” “¿Fue el cambio de carrera voluntario?” Para mapas con altas apuestas, combine:

1. Rectificación algorítmica — para reducir la ventana
2. Revisión manual del astrólogo — para el ajuste final

Su aplicación puede ofrecer esto como una consulta premium.

• API reference — encuentre los puntos finales rectification y rectification/trutine
• Tarifas — costo en créditos por plan
• Inicio rápido — obtenga una clave de API