Numerologie in API: 5 systemen voor berekening via één route

Numerologie is een onderdeel van het esoterische stack dat API’s meestal volledig overslaan of reduceren tot één «life path number». We hebben een andere weg gekozen: 5 volledige systemen, elk met 10 canonische berekeningen, via één geparametrizeerde route.

Samen zijn dit 50 endpoints onder /numerology/{system}/{calc}, plus een aparte Матриця Долі (Destiny Matrix). Onderstaand legt uit hoe het is opgezet en waarom één route voldoende is.

Alle berekeningen staan onder de volgende sjabloon:

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

{system} - één van de vijf waarden. Elk systeem heeft zijn eigen tabel voor de correspondering «letter → getal» en eigen reductieregels, dus het resultaat voor dezelfde naam verschilt afhankelijk van de school:

Een onbekend systeem retourneert 400 INVALID_SYSTEM met een lijst van toegestane waarden - geen stille fallback naar Pythagorees.

Dezelfde set van 10 berekeningen is beschikbaar voor elk van de vijf systemen:

• life-path - levenspadnummer (van geboortedatum)
• expression - expressienummer / lotnummer (van volledige naam)
• soul-urge - zielnummer (van klinkers in de naam)
• personality - persoonlijkheidsnummer (van medeklinkers in de naam)
• birthday - verjaardagsnummer
• maturity - rijpheidsnummer (levenspad + expressie)
• balance - balansnummer (van initialen)
• challenge - uitdagingnummers
• pinnacles - pieknummers (levensfasen)
• personal-year - persoonlijk jaarnummer

Het verzoekbody voor de meeste calls bestaat simpelweg uit een naam en een datum:

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

personal-year neemt daarnaast een year parameter op, omdat het de trilling van een specifiek kalenderjaar berekent.

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

Het antwoord bevat niet alleen het getal, maar ook de volledige reductieketen en een kant‑klaar interpretatie:

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

Het veld steps laat elke stap van de reductie zien (10 → 1), en isMaster wordt ingeschakeld voor 11, 22 en 33 - deze worden volgens de Pythagoreaanse school niet gereduceerd. Dit is belangrijk als je je eigen UI bouwt: je hoeft niet te raden waarom 29 11 werd en niet 2 - de keten wordt expliciet meegegeven.

De Lotmatrix (Destiny Matrix) - geen onderdeel van klassieke numerologie, daarom heeft het zijn eigen route:

POST /v1/destiny-matrix

Dit is een methode gebaseerd op de 22 grote arcana van de Tarot, die worden uitgelegd in een octagram op basis van de geboortedatum. Het retourneert de posities van het centrale kruis, de voorouderlijnen, de geld- en relatiezones - een kant‑klaar structuur voor het renderen van de matrix. We houden het buiten /numerology/* omdat het een ander model is (arcana, geen cijferreductie).

Numerologische berekeningen zijn pure rekenkunde op een string en een datum, zonder efemeriden. Daarom zijn ze deterministisch en goedkoop: dezelfde invoer levert altijd dezelfde uitvoer op, caching is triviaal. Interpretaties (meaning) zijn statische tabellen, geen LLM, dus er zijn geen hallucinaties noch variatie tussen aanroepen.

Als je vrije tekst bovenop de getallen nodig hebt, dan is dat een aparte laag /interpret/* met AI - maar de basisgetallen komen altijd uit het deterministische kern.

Numerologie maakt deel uit van het esoterische add‑on pakket samen met Tarot, runen, geomantie en I Ching. Elk verzoek heeft een vaste creditkost (berekenings‑, geen AI‑endpoints, dus goedkoop). Het gratis tarief biedt 10 000 credits per maand, wat voldoende is om een volledig numerologisch profiel voor enkele honderden gebruikers per maand samen te stellen zonder betaling.

1. Sleutel op dashboard/sign-up
2. Kies een systeem dat bij je publiek past (Pythagorees - standaard voor de Westerse markt, Vedisch - voor de Indiase markt)
3. Verzamel een profiel met 10 verzoeken of trek één nummer per specifiek scherm

De volledige lijst van velden en schema’s staat in de OpenAPI‑referentie onder de groep Numerology.