Numerológia az API-ban: 5 számítási rendszer egy útvonalon

Numerológia – az ezoterikus stack egy része, amelyet az API általában vagy teljesen kihagy, vagy egyetlen pifagóriai „life path number”-re redukál. Mi más úton jártunk: 5 teljes rendszer, mindegyik 10 kanonikus számítással, egyetlen paraméterezett útvonalon.

Együtt ez 50 végpont /numerology/{system}/{calc} alatt, plusz egy külön Destiny Matrix. Lent látható, hogyan van felépítve, és miért elég egy útvonal.

Minden számítás a sablon alatt él:

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

{system} – az öt érték egyike. Minden rendszer saját „betű → szám” megfelelőtáblával és saját redukciós szabályokkal rendelkezik, ezért ugyanannak a névnek az eredménye az iskolától függően eltér:

Ismeretlen rendszer 400 INVALID_SYSTEM-t ad vissza a megengedett értékek listájával – nincs csendes fallback a pifagóriai rendszerre.

Ugyanaz a 10 számítási készlet minden öt rendszerhez elérhető:

• life-path – életút szám (születési dátumból)
• expression – kifejezés szám / sors (teljes névből)
• soul-urge – lélek szám (magánhangzók)
• personality – személyiség szám (mássalhangzók)
• birthday – születésnap szám
• maturity – érettség szám (life-path + expression)
• balance – egyensúly szám (kezdeti betűk)
• challenge – kihívás számok
• pinnacles – csúcsok számok (élet szakaszok)
• personal-year – személyes év szám

A kérés törzse a legtöbb híváshoz egyszerűen név és dátum:

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

personal-year további year paramétert fogad, mert a konkrét naptári év rezgését számolja.

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

A válasz nem csak a számot tartalmazza, hanem a teljes redukciós láncot és egy kész értelmezést is:

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

A steps mező mutatja a redukció minden lépését (10 → 1), és az isMaster 11‑nél, 22‑nél és 33‑nál aktiválódik – ezeket a pifagóriai iskola szerint nem redukálják. Ez fontos, ha saját UI‑t építesz: nem kell kitalálni, miért lett a 29 11, és nem 2 – a lánc nyíltan visszaadódik.

A Destiny Matrix (Destiny Matrix) nem a klasszikus numerológia része, ezért saját útvonalon él:

POST /v1/destiny-matrix

Ez egy módszer a Tarot 22 nagy arkánumán, amely a születési dátumból származó oktagramra kerül. Visszaadja a központi kereszt pozíciókat, az ősök vonalait, a pénz és kapcsolatok zónáit – egy kész struktúrát a mátrix rendereléséhez. Ezt a /numerology/*-tól külön tartjuk, mert ez egy másik modell (arkánumok, nem számok redukciója).

A numerológiai számítások tiszta aritmetika a karakterlánc és a dátum felett, efemeridák nélkül. Ezért determinisztikusak és olcsók: ugyanaz a bemenet mindig ugyanazt az eredményt adja, a gyorsítótárazás triviális. Az értelmezések (meaning) statikus táblák, nem LLM, ezért nincsenek bennük sem hallucinációk, sem változatosság a hívások között.

Ha szabad szövegre van szükség a számok felett, az már egy külön /interpret/* réteg AI-val – de az alap számok mindig a determinisztikus magból érkeznek.

A numerológia az ezoterikus add-on csomag része a Tarot, rúnák, geomancia és I Ching mellett. Minden hívás fix kredit költséggel jár (számítási, nem AI végpontok, ezért olcsók). Az ingyenes tarifán 10 000 kredit jár havonta, ami elég ahhoz, hogy több száz felhasználó számára teljes numerológiai profilt gyűjts ingyen.

1. Kulcs a dashboard/sign-up
2. Válaszd ki a rendszered a közönségedhez (pifagóriai – alapértelmezett a nyugati piacon, védikus – az indiai számára)
3. Gyűjts profilt a 10 hívásból vagy húzz egy számot egy adott képernyőhöz

A mezők és sémák teljes listája a OpenAPI-dokumentációban a Numerology csoport alatt.