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 la hora exacta. Una diferencia de 30 minutos puede desplazar el ascendente más de 5 grados, y eso cambia las posiciones de las casas y los aspectos. Para un trabajo astrológico serio, esto importa.

La técnica con la que los astrólogos lo corrigen se llama rectificación: reconstruir la hora probable de nacimiento a partir de eventos conocidos de la vida. Tradicionalmente son horas de trabajo manual. AstroWay ofrece dos endpoints algorítmicos que la 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 de la hora de nacimiento. Empiezas con una hora aproximada (por ejemplo, “por la mañana” o “alrededor de las 14:00”) y la vas acotando usando:

• Eventos importantes de la vida (matrimonios, hijos, cambios de carrera, fallecimientos)
• Características físicas (la astrología clásica asocia el signo ascendente con tipos de cuerpo)
• Posiciones angulares de los planetas en el nacimiento

El resultado es una hora de nacimiento refinada, normalmente dentro de ±5 minutos de la real.

Método clásico atribuido a Hermes Trismegisto. Usa la relació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 candidata de concepción, comprobamos si la posición de la Luna en el nacimiento corresponde al ascendente / descendente en el momento de la concepción
4. Devolvemos una lista de horas de nacimiento candidatas, ordenadas por ajuste

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

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

Enfoque algorítmico basado en múltiples eventos de la vida. Es la variante pesada (hasta 120 s por solicitud).

Entrada:

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

El algoritmo:

1. Genera horas de nacimiento candidatas dentro del rango (normalmente con paso de 1 minuto)
2. Para cada candidata calcula la carta natal
3. Puntúa cada una según cuánto coinciden los eventos con los patrones astrológicos esperados (progresiones, direcciones, tránsitos)
4. Devuelve las mejores candidatas con puntuaciones de confianza

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 rectificación es valiosa para:

• Aplicaciones con usuarios que no conocen su hora: ofrece la rectificación como función premium
• Herramientas profesionales para astrólogos: ahorra horas de trabajo manual por cada cliente
• Aplicaciones de HD: Human Design es muy sensible a la hora; la rectificación mejora drásticamente la precisión
• Aplicaciones de investigación: validar cartas históricas donde los registros de hora son imprecisos

No es útil para:

• Aplicaciones donde el usuario ya conoce la hora con precisión de ±5 min (no hay beneficio)
• Aplicaciones casuales de horóscopos donde la precisión de la hora no afecta al resultado (el sun sign diario no la necesita)

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

Son los endpoints más pesados de la API. Si ofreces la rectificación como función, tarifícala en consecuencia: es una operación premium que justifica un plan de suscripción superior 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 UI debe tener:

• Procesamiento asíncrono: no bloquees la solicitud; ponla en cola y muestra el progreso
• Indicador de progreso: el endpoint completo tarda hasta 120 s; el usuario necesita retroalimentación
• Visualización del resultado: hora refinada, nivel de confianza, posibilidad de reejecutar si los eventos son imprecisos

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

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

1. El usuario introduce datos de nacimiento aproximados + eventos de la vida
2. La aplicación primero llama a /v1/rectification/trutine (barato, rápido) para acotar la ventana
3. Luego llama a /v1/rectification (completa) con la ventana refinada para mayor precisión
4. La aplicación cachea el resultado y usa la hora refinada para todos los cálculos futuros
5. Las llamadas futuras se marcan con la etiqueta “rectified from approximate”

Este enfoque combinado cuesta ~750 créditos por ciclo completo, pero da 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 está orientado a la precisión relativa: acota la ventana, pero el resultado siempre se presenta como “mejor candidato”, no como verdad garantizada. Muestra siempre a los usuarios la puntuación de confianza y dales la opción de sobrescribir si tienen mejor información.

Los algoritmos son búsqueda de patrones. Un astrólogo experimentado tiene en cuenta contexto difícil de codificar: “¿Fue el matrimonio precipitado?” “¿Fue el cambio de carrera voluntario?” Para cartas de alto riesgo, combina:

1. Rectificación algorítmica: para acotar la ventana
2. Revisión manual por un astrólogo: para el refinamiento final

Tu aplicación puede ofrecer esto como consulta premium.

• Referencia de la API: encuentra los endpoints rectification y rectification/trutine
• Tarifas: coste en créditos por plan
• Inicio rápido: obtén tu clave de API