Numerologie in der API: 5 Berechnungssysteme über einen einzigen Pfad

Alle Berechnungen folgen dem Muster:

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

{system} ist einer von fünf Werten. Jedes System hat seine eigene “Buchstabe → Zahl”-Zuordnungstabelle und eigene Reduktionsregeln, daher unterscheidet sich das Ergebnis für denselben Namen je nach Schule:

Ein unbekanntes System gibt 400 INVALID_SYSTEM mit einer Liste der zulässigen Werte zurück - keine stillen Fallbacks auf das pythagoräische System.

Der gleiche Satz von 10 Berechnungen ist für jedes der fünf Systeme verfügbar:

• life-path - Lebenswegzahl (mit Geburtsdatum)
• expression - Ausdruckszahl / Schicksalszahl (mit vollem Namen)
• soul-urge - Seelenzahl (Vokale des Namens)
• personality - Persönlichkeitszahl (Konsonanten des Namens)
• birthday - Geburtstagszahl
• maturity - Reifenummer (life-path + expression)
• balance - Ausgleichszahl (Initialen)
• challenge - Herausforderungen
• pinnacles - Gipfelzahlen (Lebensabschnitte)
• personal-year - Persönliche Jahreszahl

Der Request-Body für die meisten Aufrufe ist einfach Name und Datum:

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

personal-year akzeptiert zusätzlich year, da es die Schwingung eines bestimmten Kalenderjahres berechnet.

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

Die Antwort enthält nicht nur die Zahl, sondern auch den vollständigen Reduktionskettchen und eine fertige Interpretation:

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

Das Feld steps zeigt jeden Reduktionsschritt (10 → 1), und isMaster wird bei 11, 22 und 33 aktiviert - diese Zahlen werden gemäß der pythagoräischen Schule nicht reduziert. Das ist wichtig, wenn du dein eigenes UI baust: Du musst nicht raten, warum 29 zu 11 und nicht zu 2 wurde - der Kettchen wird explizit zurückgegeben.

Die Schicksalsmatrix (Destiny Matrix) ist kein Teil der klassischen Numerologie, daher hat sie ihre eigene Route:

POST /v1/destiny-matrix

Dies ist eine Methode basierend auf den 22 großen Arkana des Tarot, die sich in ein Oktagramm aus dem Geburtsdatum aufteilen. Sie gibt die Positionen des zentralen Kreuzes, Ahnenlinien, Geld- und Beziehungszonen zurück - eine fertige Struktur zum Rendern der Matrix. Wir halten es außerhalb von /numerology/*, weil es ein anderes Modell ist (Arkane, nicht Ziffernreduktion).

Numerologische Berechnungen sind reine Arithmetik auf Zeichenketten und Daten, ohne Ephemeriden. Daher sind sie deterministisch und günstig: derselbe Eingabe ergibt immer denselben Ausgang, Caching ist trivial. Die Interpretationen (meaning) sind statische Tabellen, keine LLMs, daher gibt es darin weder Halluzinationen noch Variabilität zwischen Aufrufen.

Wenn freier Text über den Zahlen benötigt wird, ist das ein separater Layer /interpret/* mit KI - aber die Grundzahlen kommen immer aus dem deterministischen Kern.

Numerologie ist Teil des esoterischen Add-on-Pakets zusammen mit Tarot, Runen, Geomantie und I Ching. Jeder Aufruf hat einen festen Kreditwert (Berechnungen, keine KI-Endpunkte, daher günstig). Der kostenlose Tarif beträgt 10 000 Credits pro Monat, was ausreicht, um vollständige numerologische Profile für mehrere hundert Benutzer pro Monat ohne Bezahlung zu erstellen.

1. Schlüssel auf dashboard/sign-up
2. Wähle ein System für dein Publikum (pythagoräisch - Standard für den westlichen Markt, vedisch - für den indischen)
3. Erstelle ein Profil mit 10 Aufrufen oder hole dir einzelne Zahlen für bestimmte Bildschirme

Die vollständige Liste der Felder und Schemata findest du im OpenAPI-Dokumentation unter der Gruppe Numerology.