Numerologie v API: 5 systémů výpočtu jednou cestou

Numerologie je ta část ezoterického stacku, kterou API obvykle buď zcela vynechávají, nebo ji redukují na jedno pythagorejské „life path number“. My jsme se vydali jinou cestou: 5 kompletních systémů, každý s 10 kanonickými výpočty, pod jednou parametrizovanou cestou.

Dohromady je to 50 endpointů pod /numerology/{system}/{calc}, plus samostatná Matice osudu. Níže – jak to funguje a proč jedna cesta stačí.

Všechny výpočty žijí pod šablonou:

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

{system} – jedna z pěti hodnot. Každý systém má vlastní tabulku korespondence „písmeno → číslo“ a vlastní pravidla redukce, proto se výsledek pro stejné jméno liší v závislosti na škole:

Neznámý systém vrací 400 INVALID_SYSTEM se seznamem povolených hodnot – žádné tiché fallbacky na pythagorejský.

Stejná sada 10 výpočtů je dostupná pro kterýkoli z pěti systémů:

• life-path – číslo životní cesty (z data narození)
• expression – číslo výrazu / osud (z celého jména)
• soul-urge – číslo duše (samohlásky jména)
• personality – číslo osobnosti (souhlásky jména)
• birthday – číslo dne narození
• maturity – číslo zralosti (life-path + expression)
• balance – balanční číslo (iniciály)
• challenge – čísla výzev
• pinnacles – čísla vrcholů (životní období)
• personal-year – číslo osobního roku

Tělo požadavku pro většinu volání – jen jméno a datum:

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

personal-year navíc přijímá year, protože počítá vibraci konkrétního kalendářního roku.

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

Odpověď obsahuje nejen číslo, ale i kompletní řetězec redukce a hotovou interpretaci:

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

Pole steps ukazuje každý krok redukce (10 → 1), a isMaster se zapíná na 11, 22 a 33 – ty se neredukují podle dohody pythagorejské školy. To je důležité, pokud buduješ vlastní UI: nemusíš hádat, proč se 29 stalo 11, a ne 2 – řetězec je explicitně vrácen.

Matice osudu (Destiny Matrix) není součástí klasické numerologie, proto žije na vlastní cestě:

POST /v1/destiny-matrix

Je to metoda na 22 hlavních arkánech Tarotu, které se rozkládají na oktagram z data narození. Vrací pozice centrálního kříže, linií předků, zón peněz a vztahů – hotovou strukturu pro renderování matice. Držíme ji mimo /numerology/*, protože je to jiný model (arkány, nikoli redukce čísel).

Numerologické výpočty – čistá aritmetika nad řetězcem a datem, bez efemerid. Proto jsou deterministické a levné: stejný vstup vždy dává stejný výstup, cachování je triviální. Interpretace (meaning) – statické tabulky, ne LLM, proto v nich nejsou žádné halucinace ani variabilita mezi voláními.

Pokud potřebuješ volný text nad čísly, je to už samostatná vrstva /interpret/* s AI – ale základní čísla vždy pocházejí z deterministického jádra.

Numerologie je součástí ezoterického add-on balíčku spolu s Tarotem, runami, geomantií a I Chingem. Každé volání – fixní kreditní hodnota (výpočtové, ne AI-endpointy, proto levné). Bezplatný tarif – 10 000 kreditů měsíčně, což stačí na sestavení kompletního numerologického profilu pro několik stovek uživatelů za měsíc bez poplatku.

1. Klíč na dashboard/sign-up
2. Vyber systém pro své publikum (pythagorejský – výchozí pro západní trh, védský – pro indický)
3. Sestav profil z 10 volání nebo si stáhni jedno číslo pro konkrétní obrazovku

Kompletní seznam polí a schémat – v OpenAPI-dokumentaci pod skupinou Numerology.