API de Retificação: correção do horário de nascimento para desenvolvedores

A rectificação é a correção da hora de nascimento. Começas com uma hora aproximada (por exemplo, “manhã” ou “por volta das 14:00”) e afinas-na, usando:

• Eventos importantes da vida (casamento, filhos, mudança de carreira, morte)
• Características físicas (a astrologia clássica mapeia o signo do Ascendente nos tipos de corpo)
• Posições angulares dos planetas no nascimento

Na saída - uma hora de nascimento refinada, geralmente dentro de ±5 minutos da real.

Método clássico atribuído a Hermes Trismegisto. Usa a conexão entre a posição da Lua no momento do nascimento e o Ascendente/Descendente no momento da concepção (~9 meses antes).

Como funciona:

1. Toma-se uma data aproximada de nascimento
2. Calcula-se o intervalo de datas da concepção (260-290 dias antes)
3. Para cada data candidata de concepção, verifica-se se a posição da Lua no nascimento corresponde ao Ascendente/Descendente no momento da concepção
4. Retorna-se uma lista de horas candidatas de nascimento, ordenadas por ajuste

Rápido, mas menos preciso. Bom para reduzir uma ampla janela (por exemplo, “manhã” → janela 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}`);

Abordagem algorítmica baseada em múltiplos eventos da vida. Esta é a opção pesada (até 120 s por pedido).

Entrada:

• Hora aproximada de nascimento (intervalo)
• Lista de eventos da vida com datas e tipos
• Opcional: descrição física

Algoritmo:

1. Gera horas candidatas de nascimento dentro do intervalo (geralmente com passo de 1 minuto)
2. Para cada candidato, calcula o mapa natal
3. Avalia cada um, quão bem os eventos correspondem aos padrões astrológicos previstos (progressões, direções, trânsitos)
4. Retorna os principais candidatos com pontuações de confiança

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

Rectificação é valiosa para:

• Aplicações com usuários que não sabem a hora: oferece rectificação como uma funcionalidade premium
• Ferramentas profissionais de astrólogo: economiza horas de trabalho manual por cada cliente
• Aplicações de Design Humano: o Human Design é muito sensível ao tempo; a rectificação melhora drasticamente a precisão
• Aplicações de pesquisa: validar mapas históricos onde os registros de tempo são imprecisos

Não útil para:

• Aplicações onde o usuário já sabe a hora com precisão de ±5 minutos (não há benefício)
• Aplicações de horóscopo casual, onde a precisão do tempo não afeta a saída (o sun sign diário não precisa disso)

• Trutine: 250 créditos: ~1-2 segundos por pedido
• Rectificação completa: 500 créditos: até 120 segundos

Estes são os endpoints mais pesados na API. Se ofereces rectificação como funcionalidade - cobra de acordo: esta é uma operação premium que justifica uma taxa de assinatura mais alta ou uma compra única.

Planeamento de orçamento:

• 100 rectificações por mês: ~50 000 créditos = plano Pro ($59) com folga para outras chamadas
• 1 000 rectificações por mês: 500 000 créditos = Enterprise

A rectificação leva tempo. O UI deve:

• Processamento assíncrono: não bloqueie o pedido; coloque-o na fila, mostre o progresso
• Indicador de progresso: o endpoint completo leva até 120 s; o usuário precisa de feedback
• Apresentação do resultado: hora refinada, nível de confiança, possibilidade de reiniciar se os eventos forem 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);
  }
}

Fluxo típico de rectificação na aplicação:

1. O usuário insere dados aproximados de nascimento + eventos da vida
2. A aplicação primeiro chama /v1/rectification/trutine (barato, rápido), para reduzir a janela
3. Depois chama /v1/rectification (completa) com a janela refinada para precisão
4. A aplicação armazena em cache o resultado e usa a hora refinada para todos os cálculos futuros
5. Chamadas futuras são marcadas com ‘rectified from approximate’

Esta abordagem combinada - ~750 créditos por ciclo completo, mas dá a melhor precisão.

A rectificação nunca dá 100% de precisão. Mesmo astrólogos profissionais discordam nas avaliações em 5-10 minutos.

O algoritmo AstroWay está focado em precisão relativa - reduz a janela, mas a saída é sempre posicionada como ‘melhor candidato’, não como verdade garantida. Sempre mostra aos usuários a pontuação de confiança e dá a possibilidade de redefinir se eles tiverem melhor informação.

Algoritmos são busca de padrões. Um astrólogo experiente considera o contexto, que é difícil de codificar: “O casamento foi apressado?” “A mudança de carreira foi voluntária?” Para mapas com alto risco, combine:

1. Rectificação algorítmica: para reduzir a janela
2. Revisão manual por astrólogo: para o ajuste final

Sua aplicação pode oferecer isso como uma consulta premium.

• API reference: encontra os endpoints rectification e rectification/trutine
• Tarifas: custo em créditos por plano
• Início rápido: obtenha a chave da API