API di Numerologia

L'endpoint prende la data di nascita, la scompone nelle sue cifre e le somma, poi riduce iterativamente il totale finché non ottiene una singola cifra – preservando i numeri maestri 11, 22 e 33 quando compaiono durante la riduzione. La risposta contiene il totale grezzo non compresso, il numero finale ridotto, un boolean isMaster che indica se un numero maestro è stato trattenuto dalla ulteriore riduzione, l'elenco ordinato dei passaggi di riduzione così puoi renderizzare o verificare ogni passaggio, e una breve stringa di significato per il numero risultante. Poiché ogni output è derivato in modo deterministico dalle cifre del calendario, la stessa data restituisce sempre risultati byte-identici; il campo name accompagna il calcolo ma il Life Path dipende interamente dalla data. I calcoli correlati – expression, soul-urge, personality, birthday, maturity – estendono la stessa aritmetica al nome e ad altri input.

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": "1990-05-15"
}'

{
  "ok": true,
  "data": {
    "system": "pythagorean",
    "name": "Ada Lovelace",
    "date": "1990-05-15",
    "lifePath": {
      "raw": 30,
      "reduced": 3,
      "isMaster": false,
      "steps": [
        "1+9+9+0+5+1+5 = 30",
        "3+0 = 3"
      ],
      "meaning": "Creative self-expression…"
    }
  }
}

Usalo quando ti serve una lettura numerologica veloce e ripetibile e vuoi evitare la latenza e il non-determinismo di qualsiasi cosa che tocchi un ephemeris o un modello linguistico. Poiché la matematica è banale e completamente deterministica, puoi calcolarla inline ad ogni richiesta, metterla in cache indefinitamente indicizzata per data, o pre-calcolarla in blocco per un intero gruppo di utenti senza preoccuparti del drift. Si abbina naturalmente al resto della suite di numerologia: chiama life-path insieme a expression e soul-urge per assemblare un profilo completo, poi salva i numeri ridotti come attributi duraturi invece di ricalcolarli. Ottimo per flussi di onboarding, arricchimento del profilo e personalizzazione dei contenuti dove basta un unico numero di base.

I numeri maestri 11, 22 e 33 non vengono deliberatamente ridotti a 2, 4 e 6 – il flag isMaster ti indica quale caso si è verificato così puoi ramificare il tuo copy di conseguenza. Questo è il sistema Pitagorico specificamente; i sistemi Caldeo e gli altri nella suite assegnano valori lettera-numero diversi e possono restituire un risultato diverso per lo stesso input.