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.retificaçãoTrutine({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '12:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
});

console.log(`Melhor candidato: ${result.bestTime}`);
console.log(`Confiança: ${result.confidence}`);

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.retificação({
  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: 'casamento' },
    { date: '2018-03-12', type: 'primeiroFilho' },
    { date: '2020-09-05', type: 'mudançaDeCarreira' },
  ],
});

console.log(`Tempo retificado: ${result.bestTime}`);
console.log(`Candidatos: ${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 handleRetify(input: RetifyInput) {
  setLoading(true);
  setStatus('Executando retificação (isso pode levar até 2 minutos)...');

  try {
    const result = await client.retificação(input);
    setResult(result);
    setStatus(`Concluído. Tempo refinado: ${result.bestTime} (confiança ${result.confidence}%)`);
  } catch (err) {
    setStatus(`Erro: ${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