Numerologia w API: 5 systemów obliczeń jednym trasą

Numerologia - to część ezoterycznego stosu, którą API zazwyczaj albo całkowicie pomija, albo redukuje do jednej pitagorejskiej «life path number». Poszliśmy inną drogą: 5 pełnych systemów, każdy z 10 kanonicznymi obliczeniami, za jednym parametryzowanym trasą.

Razem daje to 50 endpointów pod /numerology/{system}/{calc}, plus osobna Macierz Przeznaczenia. Poniżej - jak to jest zorganizowane i dlaczego jedna trasa wystarczy.

Wszystkie obliczenia znajdują się pod szablonem:

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

{system} - jedno z pięciu wartości. Każdy system ma własną tabelę odpowiadającą «litera → liczba» oraz własne zasady redukcji, dlatego wynik dla tego samego imienia różni się w zależności od szkoły:

Ten sam zestaw 10 obliczeń jest dostępny dla każdego z pięciu systemów:

• life-path - liczba ścieżki życia (z daty urodzenia)
• expression - liczba wyrażenia / losu (z pełnego imienia)
• soul-urge - liczba duszy (samogłoski imienia)
• personality - liczba osobowości (spółgłoski imienia)
• birthday - liczba dnia urodzenia
• maturity - liczba dojrzałości (life-path + expression)
• balance - liczba równowagi (inicjały)
• challenge - liczby wyzwań
• pinnacles - liczby szczytów (okresy życiowe)
• personal-year - liczba osobowego roku

Treść żądania dla większości wywołań - po prostu imię i data:

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

personal-year dodatkowo przyjmuje year, ponieważ oblicza wibrację konkretnego roku kalendarzowego.

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

Odpowiedź zawiera nie tylko liczbę, ale także pełny łańcuch redukcji i gotową interpretację:

{
  "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 pokazuje każdy krok redukcji (10 → 1), a isMaster jest włączane dla 11, 22 i 33 - nie są one redukowane zgodnie z zasadą szkoły pitagorejskiej. To ważne, jeśli budujesz własny interfejs użytkownika: nie musisz się domyślać, dlaczego 29 stało się 11, a nie 2 - łańcuch jest podany jawnie.

POST /v1/destiny-matrix

To jest metoda oparta na 22 głównych arkanaх Tarota, które są rozłożone na oktagramę z daty urodzenia. Zwraca pozycje centralnego krzyża, linii przodków, stref pieniędzy i relacji – gotową strukturę do renderowania macierzy. Przechowujemy go poza /numerology/*, ponieważ jest to inny model (arkana, nie redukcja cyfr).

Obliczenia numerologiczne to czysta arytmetyka nad ciągiem znaków i datą, bez efemeryd. Dlatego są deterministyczne i tanie: to samo wejście zawsze daje to samo wyjście, buforowanie jest trywialne. Interpretacje (meaning) - statyczne tabele, nie LLM, dlatego w nich nie ma ani halucynacji, ani zmienności między wywołaniami.

Jeśli potrzebny jest wolny tekst nad liczbami, to już osobna warstwa /interpret/* z AI – ale podstawowe liczby zawsze pochodzą z deterministycznego rdzenia.

Numerologia jest częścią pakietu ezoterycznego add-on razem z Tarotem, runami, geomancją i I Ching. Każde wywołanie ma stałą koszt w kredytach (obliczeniowe, nie AI-endpointy, dlatego są tanie). Darmowy plan to 10 000 kredytów na miesiąc, co wystarcza, aby zebrać pełny profil numerologiczny dla kilkuset użytkowników na miesiąc bez płatności.

1. Klucz na dashboard/sign-up
2. Wybierz system dla swojej publiczności (pitagorejski - domyślny dla zachodniego rynku, wedyjski - dla indyjskiego)
3. Zbierz profil z 10 wywołań lub pobieraj pojedyncze liczby pod konkretny ekran

Pełna lista pól i schematów - w OpenAPI-dokumentacji w grupie Numerology.