Numérologie dans l'API: 5 systèmes de calcul par un seul endpoint

La numérologie - cette partie de la stack ésotérique que l’API omet généralement complètement ou se réduit à un seul « life path number ». Nous avons choisi une autre voie : 5 systèmes complets, chacun avec 10 calculs canoniques, via un seul route paramétré.

Ensemble, cela représente 50 endpoints sous /numerology/{system}/{calc}, plus une Matrice du Destin (Destiny Matrix) séparée. Ci-dessous - comment cela est structuré et pourquoi un seul route suffit.

Tous les calculs vivent sous le modèle :

POST /v1/numerology/{system}/{calc}

{system} - l’une des cinq valeurs. Chaque système possède sa propre table de correspondance « lettre → nombre » et ses propres règles de réduction, donc le résultat pour le même nom varie selon l’école :

Un système inconnu renvoie 400 INVALID_SYSTEM avec la liste des valeurs autorisées - aucun repli silencieux vers le pythagoricien.

Le même ensemble de 10 calculs est disponible pour chacune des cinq systèmes :

• life-path - nombre du chemin de vie (à partir de la date de naissance)
• expression - nombre d’expression / de destinée (à partir du nom complet)
• soul-urge - nombre de l’âme (voyelles du nom)
• personality - nombre de la personnalité (consonnes du nom)
• birthday - nombre du jour de naissance
• maturity - nombre de maturité (life-path + expression)
• balance - nombre d’équilibre (initiales)
• challenge - nombres des défis
• pinnacles - nombres des sommets (périodes de vie)
• personal-year - nombre de l’année personnelle

Le corps de la requête pour la plupart des appels - simplement le nom et la date :

{ "name": "Ada Lovelace", "date": "1815-12-10" }

personal-year accepte également le paramètre year, car il calcule la vibration d’une année calendaire spécifique.

curl -X POST https://api.astroway.info/v1/numerology/pythagorean/life-path \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada Lovelace","date":"1815-12-10"}'

La réponse contient non seulement le nombre, mais aussi la chaîne complète de réduction et une interprétation prête :

{
  "ok": true,
  "data": {
    "system": "pythagorean",
    "name": "Ada Lovelace",
    "date": "1815-12-10",
    "lifePath": {
      "raw": 10,
      "reduced": 1,
      "isMaster": false,
      "steps": [10, 1],
      "meaning": {
        "number": 1,
        "archetype": "The Pioneer",
        "strengths": ["leadership", "independence", "innovation", "initiative"],
        "challenges": ["ego", "impatience", "isolation", "stubbornness"],
        "career": ["entrepreneur", "executive", "inventor", "pioneer"],
        "relationship": "needs a partner who respects independence; thrives on mutual challenge",
        "shortRead": "born to lead and originate; learn to balance solo drive with collaboration"
      }
    }
  }
}

Le champ steps montre chaque étape de la réduction (10 → 1), et isMaster s’active pour 11, 22 et 33 - ils ne sont pas réduits selon la convention de l’école pythagoricienne. C’est important si tu construis ton propre UI : tu n’as pas à deviner pourquoi 29 devient 11 et non 2 - la chaîne est fournie explicitement.

La Matrice du Destin (Destiny Matrix) - ne faisant pas partie de la numérologie classique, elle possède son propre route :

POST /v1/destiny-matrix

C’est une méthode basée sur les 22 arcanes majeurs du Tarot, disposés en octogramme à partir de la date de naissance. Elle renvoie les positions de la croix centrale, des lignées ancestrales, des zones d’argent et de relations - une structure prête pour le rendu de la matrice. Nous la gardons en dehors de /numerology/* car c’est un autre modèle (arcanes, pas de réduction de chiffres).

Les calculs de numérologie - de l’arithmétique pure sur une chaîne et une date, sans éphémérides. Donc ils sont déterministes et peu coûteux : la même entrée donne toujours la même sortie, la mise en cache est triviale. Les interprétations (meaning) - des tables statiques, pas un LLM, donc elles ne contiennent ni hallucinations ni variabilité entre les appels.

Si tu as besoin d’un texte libre au-dessus des nombres, c’est déjà une couche séparée /interpret/* avec AI - mais les nombres de base proviennent toujours du noyau déterministe.

La numérologie fait partie du paquet add-on ésotérique comprenant le Tarot, les runes, la géomancie et l’I Ching. Chaque appel a un coût fixe en crédits (calculs, pas des endpoints IA, donc peu coûteux). Le forfait gratuit offre 10 000 crédits par mois, ce qui suffit pour établir un profil numérologique complet pour plusieurs centaines d’utilisateurs par mois sans paiement.

1. Clé sur dashboard/sign-up
2. Choisis le système selon ton audience (pythagoricien - défaut pour le marché occidental, védique - pour l’indien)
3. Collecte un profil avec 10 appels ou prends un nombre à la fois pour un écran spécifique

La liste complète des champs et des schémas se trouve dans la documentation OpenAPI sous le groupe Numerology.