Numerologia nell'API: 5 sistemi di calcolo con un unico endpoint

Numerologia - è quella parte dello stack esoterico che l’API di solito o ignora completamente, o riduce a un singolo «life path number» pitagorico. Abbiamo seguito un altro percorso: 5 sistemi completi, ciascuno con 10 calcoli canonici, tramite un unico percorso parametrizzato.

In totale sono 50 endpoint sotto /numerology/{system}/{calc}, più la separate Destiny Matrix. Qui sotto - come è strutturato e perché un singolo percorso è sufficiente.

Tutti i calcoli vivono sotto il modello:

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

{system} - uno dei cinque valori. Ogni sistema ha la propria tabella di corrispondenza «lettera → numero» e le proprie regole di riduzione, quindi il risultato per lo stesso nome varia a seconda della scuola:

Un sistema sconosciuto restituisce 400 INVALID_SYSTEM con l’elenco dei valori ammessi - nessun fallback silenzioso sul pitagorico.

Lo stesso insieme di 10 calcoli è disponibile per qualsiasi dei cinque sistemi:

• life-path - numero del percorso di vita (dalla data di nascita)
• expression - numero di espressione / destino (dal nome completo)
• soul-urge - numero dell’anima (vocali del nome)
• personality - numero della personalità (consonanti del nome)
• birthday - numero del giorno di nascita
• maturity - numero della maturità (life-path + expression)
• balance - numero di equilibrio (iniziali)
• challenge - numeri delle sfide
• pinnacles - numeri dei pinnacoli (periodi di vita)
• personal-year - numero dell’anno personale

Il corpo della richiesta per la maggior parte delle chiamate è semplicemente nome e data:

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

personal-year inoltre accetta year, poiché calcola la vibrazione di un determinato anno civile.

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 risposta contiene non solo il numero, ma anche l’intera catena di riduzione e un’interpretazione pronta:

{
  "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"
      }
    }
  }
}

Il campo steps mostra ogni passo di riduzione (10 → 1), mentre isMaster si attiva su 11, 22 e 33 - i quali non vengono ridotti secondo la convenzione della scuola pitagorica. Questo è importante se stai costruendo la tua UI: non devi indovinare perché 29 diventa 11 invece di 2 - la catena viene fornita esplicitamente.

La Destiny Matrix (Destiny Matrix) - non è parte della numerologia classica, quindi vive su un proprio percorso:

POST /v1/destiny-matrix

È un metodo basato sui 22 arcani maggiori dei Tarocchi, che vengono disposti in un’ottagramma a partire dalla data di nascita. Restituisce le posizioni della croce centrale, delle linee degli antenati, delle zone di denaro e delle relazioni - una struttura pronta per il rendering della matrice. Lo teniamo fuori da /numerology/* perché è un altro modello (arcani, non riduzione di numeri).

I calcoli di numerologia sono pura aritmetica su stringa e data, senza efemeridi. Per questo sono deterministici ed economici: lo stesso input dà sempre lo stesso output, la cache è banale.

Le interpretazioni (meaning) - sono tabelle statiche, non LLM, quindi in esse non ci sono né allucinazioni né variabilità tra le chiamate.

Se ti serve un testo libero sopra i numeri, è già un altro strato /interpret/* con AI - ma i numeri di base provengono sempre dal nucleo deterministico.

La numerologia fa parte del pacchetto add-on esoterico insieme a Tarocchi, rune, geomanzia e I Ching.

Ogni chiamata ha un costo fisso in crediti (endpoint di calcolo, non AI, quindi economici).

Il piano gratuito offre 10 000 crediti al mese, sufficienti per raccogliere un profilo numerologico completo per diverse centinaia di utenti al mese senza pagamento.

1. Chiave su dashboard/sign-up
2. Scegli il sistema in base al tuo pubblico (pitagorico - predefinito per il mercato occidentale, vedico - per il mercato indiano)
3. Raccogli il profilo con 10 chiamate oppure prendi un numero alla volta per uno schermo specifico

L’elenco completo dei campi e degli schemi si trova nella documentazione OpenAPI nel gruppo Numerology.