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

La plupart des utilisateurs d’astrologie connaissent leur date de naissance, mais pas leur heure de naissance exacte. Une différence de 30 minutes peut déplacer l’ascendant de 5 degrés ou plus - et cela change la position des maisons et les aspects. Pour un travail astrologique sérieux, cela est important.

La technique que les astrologues utilisent pour corriger cela s’appelle rectification - la restitution du temps de naissance probable à partir d’événements de vie connus. Traditionnellement, cela représente des heures de travail manuel. AstroWay propose deux points de terminaison algorithmiques qui l’automatisent.

Dans cet article, nous allons voir quand appliquer la rectification, comment fonctionnent les algorithmes et comment l’intégrer dans votre application.

La rectification est la correction de l’heure de naissance. Vous commencez avec une heure approximative (par exemple, « matin » ou « vers 14h00 ») et l’affinez en utilisant :

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

En sortie, vous obtenez une heure de naissance affinée, généralement dans une fourchette de ±5 minutes de la valeur réelle.

Méthode classique attribuée à Hermès Trismégiste. 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).

Voici comment cela fonctionne :

1. On prend une date de naissance approximative
2. On calcule la fourchette de dates de conception (260-290 jours plus tôt)
3. Pour chaque date de conception candidate, on vérifie si la position de la Lune à la naissance correspond à l’ascendant / au descendant au moment de la conception
4. On retourne une liste de temps de naissance candidats, classés par ajustement

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

const result = await client.rectificationTrutine({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '12:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
});

console.log(`Meilleur candidat : ${result.bestTime}`);
console.log(`Confiance : ${result.confidence}`);

Approche algorithmique basée sur plusieurs événements de la vie. C’est une option lourde (jusqu’à 120 s par appel).

Entrée :

• Heure de naissance approximative (fourchette)
• Liste d’événements de la vie avec dates et types
• Description physique facultative

Algorithme :

1. Génère des temps de naissance candidats à l’intérieur de la fourchette (généralement avec une étape de 1 minute)
2. Pour chaque candidat, calcule la carte natale
3. Évalue chaque candidat en fonction de la mesure dans laquelle les événements correspondent aux modèles astrologiques prévus (progressions, directions, transits)
4. Retourne les meilleurs candidats avec des évaluations de confiance

const result = await client.rectification({
  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: 'mariage' },
    { date: '2018-03-12', type: 'premierEnfant' },
    { date: '2020-09-05', type: 'changementDeCarrière' },
  ],
});

console.log(`Temps rectifié : ${result.bestTime}`);
console.log(`Candidats : ${result.candidates.length}`);

La rectification est précieuse pour :

• Applications avec des utilisateurs qui ne connaissent pas leur heure de naissance - proposez la rectification comme fonctionnalité premium
• Outils professionnels d’astrologie - économisez des heures de travail manuel pour chaque client
• Applications HD - Human Design est très sensible à l’heure ; la rectification améliore considérablement la précision
• Applications de recherche - valider les cartes historiques où les enregistrements horaires sont inexacts

Pas utile pour :

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

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

Ce sont les points de terminaison les plus lourds de l’API. Si vous proposez la rectification comme fonctionnalité - tarifiez en conséquence : il s’agit d’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 une marge pour d’autres appels
• 1 000 rectifications par mois : 500 000 crédits = Entreprise

La rectification prend du temps. L’interface utilisateur doit :

• Traiter de manière asynchrone - ne pas bloquer la demande ; la mettre en file d’attente, afficher la progression
• Afficher un indicateur de progression - le point de terminaison complet fonctionne jusqu’à 120 s ; l’utilisateur a besoin d’une rétroaction
• Afficher le résultat - heure affinée, niveau de confiance, possibilité de relancer si les événements sont inexacts

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Exécution de la rectification (cela peut prendre jusqu\'à 2 minutes)...');

  try {
    const result = await client.rectification(input);
    setResult(result);
    setStatus(`Terminé. Heure affinée : ${result.bestTime} (confiance ${result.confidence}%)`);
  } catch (err) {
    setStatus(`Erreur : ${err.message}`);
  } finally {
    setLoading(false);
  }
}

Flux typique de rectification dans une application :

1. L’utilisateur saisit des données de naissance approximatives + des événements de la vie
2. L’application appelle d’abord /v1/rectification/trutine (bon marché, rapide) pour réduire la fenêtre
3. Ensuite, 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 étiquetés avec une balise « rectifié à partir d’une approximation »

Une telle approche combinée - ~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 diffèrent dans leurs évaluations de 5 à 10 minutes.

L’algorithme AstroWay est conçu pour une précision relative - réduit la fenêtre, mais la sortie est toujours positionnée comme « meilleur candidat », et non comme une vérité garantie. Montrez toujours aux utilisateurs l’évaluation de confiance et donnez-leur la possibilité de réviser si elles ont de meilleures informations.

Les algorithmes sont une recherche de modèles. Un astrologue expérimenté prend en compte le contexte, qui est difficile à coder : « Le mariage était-il précipité ? » « Le changement de carrière était-il volontaire ? » Pour les cartes à enjeux élevés, combinez :

1. La rectification algorithmique - pour réduire la fenêtre
2. L’examen manuel par un astrologue - pour l’affinement final

Votre application peut proposer cela comme consultation premium.

• Référence API - trouvez les points de terminaison rectification et rectification/trutine
• Tarifs - coût en crédits par plan
• Démarrage rapide - obtenez une clé API