Numerologie în API: 5 sisteme de calcul pe un singur traseu

Numerologia este parte din pachetul ezoteric pe care API‑ul îl omite de obicei complet sau o reduc la un singur «life path number» pitagoric. Am ales o altă cale: 5 sisteme complete, fiecare cu 10 calcule canonice, pe un singur rută parametrizată.

În total sunt 50 de endpoint‑uri sub /numerology/{system}/{calc}, plus o Destiny Matrix separată. Mai jos - cum este organizat și de ce un singur rută este suficient.

Toate calculele locuiesc sub șablonul:

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

{system} - unul dintre cele cinci valori. Fiecare sistem are propriul tabel de corespondență „literă → număr” și proprile reguli de reducere, deci rezultatul pentru același nume variază în funcție de școală:

Un sistem necunoscut returnează 400 INVALID_SYSTEM cu lista de valori permise - fără fallback-uri tacite spre pitagorică.

Același set de 10 calcule este disponibil pentru oricare dintre cele cinci sisteme:

• life-path - numărul căii de viață (de la data nașterii)
• expression - numărul expresiei / destinului (de la numele complet)
• soul-urge - numărul dușei (vocalele din nume)
• personality - numărul personalității (consoanele din nume)
• birthday - numărul zilei nașterii
• maturity - numărul maturității (life-path + expression)
• balance - numărul de echilibru (inițialele)
• challenge - numerele de provocare
• pinnacles - numerele de vârf (perioadele de viață)
• personal-year - numărul anului personal

Corpul cererii pentru majoritatea apelurilor - doar nume și dată:

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

personal-year primește de asemenea un parametru year, deoarece calculează vibrația anului calendaristic specific.

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

Răspunsul conține nu doar numărul, ci și întregul lanț de reducere și o interpretare gata de utilizat:

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

Campul steps arată fiecare pas al reducerii (10 → 1), iar isMaster se activează la 11, 22 și 33 - acestea nu sunt reduse conform convenției școlii pitagoreice. Este important dacă construiești propriul UI: nu trebuie să te gândești de ce 29 a devenit 11 și nu 2 - lanțul este dat explicit.

Destiny Matrix (Matricea Destinului) - nu este parte a numerologiei clasice, deci are un rută proprie:

POST /v1/destiny-matrix

Este o metodă pe 22 de arcană majoră a Tarotului, care se distribuie pe o octagramă folosind data nașterii. Returnează pozițiile crucii centrale, liniilor de moștenire, zonelor de bani și de relații - o structură gata pentru randarea matricei. O păstrăm în afara /numerology/* deoarece este un alt model (arcane, nu reducere de cifre).

Calculele de numerologie - aritmetică pură peste șir și dată, fără efemeride. De aceea sunt deterministe și ieftine: aceeași intrare produce mereu aceeași ieșire, cacharea este trivială. Interpretările (meaning) - tabele statice, nu LLM, deci nu au nici alucinații, nici variabilitate între apeluri.

Dacă ai nevoie de text liber peste numere, este deja un strat separat /interpret/* cu AI - dar numerele de bază vin întotdeauna din nucleul determinist.

Numerologia face parte din pachetul ezoteric add‑on împreună cu Tarotul, runele, geomanteaua și I Ching. Fiecare apel are un cost fix în credite (sunt endpoint‑uri de calcul, nu de AI, deci sunt ieftine). Planul gratuit oferă 10 000 de credite pe lună, suficient pentru a colecta un profil numerologic complet pentru câte sute de utilizatori pe lună fără plată.

1. Cheia pe dashboard/sign-up
2. Alege sistemul pentru publicul tău (pitagoreană - implicit pentru piața de vest, vedică - pentru piața indiană)
3. Colete un profil din 10 apeluri sau extrage un singur număr pentru un ecran specific

Lista completă a câmpurilor și schemelor se găsește în documentației OpenAPI sub grupul Numerology.