API de rectification : correction de l'heure de naissance pour les développeurs

Більшість користувачів астрології connaissent leur date de naissance, mais pas l’heure exacte. Une différence de 30 minutes peut déplacer l’ascendant de plus de 5 degrés – et cela change la position des maisons et les aspects. Pour un travail astrologique sérieux, c’est important.

La technique que les astrologues utilisent pour corriger cela s’appelle rectification – la récupération de l’heure de naissance probable à partir d’événements de vie connus. Traditionnellement, cela prend des heures de travail manuel. AstroWay propose deux endpoints algorithmiques qui l’automatisent.

Dans cet article – quand appliquer la rectification, comment fonctionnent les algorithmes et comment l’intégrer dans ton application.

La rectification est la correction de l’heure de naissance. Tu commences avec une heure approximative (par exemple, ” matin ” ou ” vers 14 :00 ”) et tu la resserres en utilisant :

• Événements de vie importants (mariage, enfants, changement de carrière, décès)
• Caractéristiques physiques (l’astrologie classique associe le signe ascendant à des types de corps)
• Positions angulaires des planètes à la naissance

En sortie – une heure de naissance affinée, généralement dans une marge de ±5 minutes par rapport à la réalité.

Méthode classique attribuée à Hermès Trismégiste. Elle utilise le lien entre la position de la Lune au moment de la naissance et l’ascendant / le descendant au moment de la conception (~9 mois plus tôt).

Comment ça fonctionne :

1. On prend la date de naissance approximative
2. On calcule la fourchette de dates de conception (260–290 jours avant)
3. Pour chaque date de conception candidate, on vérifie si la position de la Lune à la naissance correspond à l’ascendant / descendant au moment de la conception
4. On renvoie la liste des heures de naissance candidates, triées par adéquation

Rapide, mais moins précis. Bien pour réduire une large fenêtre (par ex., ” matin ” → fenêtre de 2 heures).

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

Approche algorithmique basée sur plusieurs événements de vie. C’est une version lourde (jusqu’à 120 s par requête).

Entrée :

• Heure de naissance approximative (plage)
• Liste d’événements de vie avec dates et types
• Optionnel : description physique

Algorithme :

1. Génère des heures de naissance candidates à l’intérieur de la plage (généralement avec un pas de 1 minute)
2. Pour chaque candidat, calcule la carte natale
3. Évalue chaque candidat selon la correspondance des événements avec les patterns astrologiques prévus (progressions, directions, transits)
4. Renvoie les meilleurs candidats avec des scores de confiance

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 rectification est précieuse pour :

• Applications avec des utilisateurs qui ne connaissent pas l’heure : propose la rectification comme fonctionnalité premium
• Outils professionnels d’astrologue : économise des heures de travail manuel par client
• Applications HD : Human Design est très sensible au temps ; la rectification améliore nettement la précision
• Applications de recherche : valider des cartes historiques où les enregistrements de temps sont imprécis

Pas utile pour :

• Applications où l’utilisateur connaît déjà l’heure avec une précision de ±5 min (pas d’avantage)
• Applications d’horoscope occasionnelles où la précision de l’heure n’affecte pas le résultat (le signe solaire quotidien n’en a pas besoin)

• Trutine : 250 crédits : ~1–2 secondes par requête
• Rectification complète : 500 crédits : jusqu’à 120 secondes

Ce sont les endpoints les plus lourds de l’API. Si tu proposes la rectification comme fonctionnalité, tarifie en conséquence : c’est une opération premium qui justifie un tarif d’abonnement plus élevé ou un achat unique.

Planification du budget :

• 100 rectifications par mois : ~50 000 crédits = plan Pro ($59) avec marge pour d’autres appels
• 1 000 rectifications par mois : 500 000 crédits = Enterprise

La rectification prend du temps. L’UI doit :

• Traitement asynchrone : ne bloque pas la requête ; mets‑la en file d’attente, montre la progression
• Indicateur de progression : l’endpoint complet fonctionne jusqu’à 120 s ; l’utilisateur a besoin d’un retour
• Affichage du résultat : heure précise, niveau de confiance, possibilité de relancer si les événements sont inexacts

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

Flux typique de rectification dans l’application :

1. L’utilisateur saisit les données de naissance approximatives + les événements de vie
2. L’application appelle d’abord /v1/rectification/trutine (bon marché, rapide) pour réduire la fenêtre
3. Puis elle appelle /v1/rectification (complète) avec la fenêtre affinée pour la précision
4. L’application met en cache le résultat et utilise l’heure affinée pour tous les calculs futurs
5. Les appels futurs sont marqués ” rectified from approximate ”

Cette approche combinée coûte ~750 crédits pour le cycle complet, mais offre la meilleure précision.

La rectification ne donne jamais une précision de 100 %. Même les astrologues professionnels divergent de 5–10 minutes.

L’algorithme AstroWay vise une précision relative – il réduit la fenêtre, mais le résultat est toujours présenté comme le ” meilleur candidat ”, pas comme une vérité garantie. Montre toujours aux utilisateurs le score de confidence et offre la possibilité de le redéfinir s’ils ont de meilleures informations.

Les algorithmes recherchent des patterns. Un astrologue expérimenté prend en compte le contexte difficile à coder : ” Le mariage était-il précipité ? ” ” Le changement de carrière était‑il volontaire ? ” Pour les cartes à enjeux élevés, combine :

1. Rectification algorithmique : pour réduire la fenêtre
2. Revue manuelle par l’astrologue : pour l’affinage final

Ton application peut proposer cela comme une consultation premium.

• API reference: trouve les endpoints rectification et rectification/trutine
• Tarifs: coût en crédits selon le plan
• Démarrage rapide: obtient une clé API