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

A maioria dos usuários de astrologia sabe a data de nascimento, mas não sabe a hora exata. Uma diferença de 30 minutos pode deslocar o ascendente em 5+ graus - e isso muda a posição das casas e os aspectos. Para um trabalho astrological sério, isso é importante.

A técnica usada pelos astrólogos para corrigir isso é chamada de retificação - restauração do tempo de nascimento provável a partir de eventos conhecidos da vida. Tradicionalmente, isso é feito manualmente e leva horas. O AstroWay oferece dois endpoints algorítmicos que automatizam isso.

Neste post, vamos ver quando aplicar a retificação, como os algoritmos funcionam e como integrá-los ao seu aplicativo.

Retificação é a correção do tempo de nascimento. Você começa com um tempo aproximado (por exemplo, “manhã” ou “por volta das 14h”) e o refina usando:

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

Como resultado, você obtém um tempo de nascimento refinado, geralmente dentro de ±5 minutos do tempo 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. Pegamos a data de nascimento aproximada
2. Calculamos o intervalo de datas de concepção (260-290 dias antes)
3. Para cada data de concepção candidata, verificamos se a posição da Lua no nascimento corresponde ao ascendente/descendente no momento da concepção
4. Retornamos uma lista de tempos de nascimento candidatos, classificados por ajuste

Rápido, mas menos preciso. Bom para reduzir uma janela ampla (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 vários eventos da vida. É uma operação pesada (até 120 s por solicitação).

Entrada:

• Tempo de nascimento aproximado (intervalo)
• Lista de eventos da vida com datas e tipos
• Opcionalmente: descrição física

Algoritmo:

1. Gera tempos de nascimento candidatos dentro do intervalo (geralmente com um passo de 1 minuto)
2. Para cada candidato, calcula o mapa natal
3. Pontua cada um com base na correspondência entre os eventos e os padrões astrológicos previstos (progressões, direções, trânsitos)
4. Retorna os principais candidatos com avaliaçõ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}`);

A retificação é valiosa para:

• Aplicativos com usuários que não sabem o tempo - ofereça retificação como uma funcionalidade premium
• Ferramentas profissionais de astrólogo - economiza horas de trabalho manual para cada cliente
• Aplicativos HD - Human Design é muito sensível ao tempo; a retificação melhora significativamente a precisão
• Aplicativos de pesquisa - validar cartas históricas onde os registros de tempo são imprecisos

Não é útil para:

• Aplicativos onde o usuário já sabe o tempo com precisão de ±5 minutos (não há benefício)
• Aplicativos de horóscopo casual onde a precisão do tempo não afeta a saída (o sinal solar diário não precisa disso)

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

Esses são os endpoints mais pesados da API. Se você oferece retificação como uma funcionalidade - tarifeie de acordo: é uma operação premium que justifica um plano de assinatura mais alto ou uma compra única.

Planejamento de orçamento:

• 100 retificações por mês: ~50.000 créditos = plano Pro ($59) com folga para outras chamadas
• 1.000 retificações por mês: 500.000 créditos = Enterprise

A retificação leva tempo. A interface do usuário deve:

• Processamento assíncrono - não bloqueie a solicitação; coloque-a em fila, mostre o progresso
• Indicador de progresso - o endpoint completo funciona até 120 s; o usuário precisa de feedback
• Exibição do resultado - tempo refinado, nível de confiança, opção 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 retificação em um aplicativo:

1. O usuário insere dados de nascimento aproximados + eventos da vida
2. O aplicativo chama /v1/retificação/trutine (barato, rápido) para reduzir a janela
3. Em seguida, chama /v1/retificação (completa) com a janela refinada para precisão
4. O aplicativo armazena o resultado em cache e usa o tempo refinado para todos os cálculos futuros
5. Chamadas futuras são marcadas com a etiqueta “retificado a partir de aproximado”

Essa abordagem combinada - ~750 créditos por ciclo completo, mas fornece a melhor precisão.

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

O algoritmo do AstroWay é orientado para precisão relativa - reduz a janela, mas a saída sempre é posicionada como “melhor candidato”, e não como verdade garantida. Mostre sempre ao usuário a avaliação de confiança e dê a opção de redefinir se tiver informações mais precisas.

Os algoritmos são busca de padrões. Um astrólogo experiente leva em conta o contexto, que é difícil de codificar: “O casamento foi apressado?” “A mudança de carreira foi voluntária?” Para cartas com altas apostas, combine:

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

Seu aplicativo pode oferecer isso como uma consulta premium.

• Referência da API - encontre os endpoints retificação e retificação/trutine
• Preços - custo em créditos por plano
• Guia rápido - obtenha a chave da API