Numerología en API: 5 sistemas de cálculo en una sola ruta

La numerología es esa parte del stack esotérico que las API suelen omitir por completo o reducir a un único «life path number» pitagórico. Nosotros hemos tomado un camino diferente: 5 sistemas completos, cada uno con 10 cálculos canónicos, a través de una única ruta parametrizada.

En total, son 50 endpoints bajo /numerology/{system}/{calc}, más una Matriz del Destino separada. A continuación, te explicamos cómo funciona y por qué una sola ruta es suficiente.

Todos los cálculos residen bajo el siguiente patrón:

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

{system} es uno de los cinco valores. Cada sistema tiene su propia tabla de correspondencia «letra → número» y sus propias reglas de reducción, por lo que el resultado para el mismo nombre difiere según la escuela:

Un sistema desconocido devuelve 400 INVALID_SYSTEM con una lista de valores permitidos, sin fallbacks silenciosos a la pitagórica.

El mismo conjunto de 10 cálculos está disponible para cualquiera de los cinco sistemas:

• life-path - número del camino de vida (a partir de la fecha de nacimiento)
• expression - número de expresión / destino (a partir del nombre completo)
• soul-urge - número del alma (vocales del nombre)
• personality - número de personalidad (consonantes del nombre)
• birthday - número del día de nacimiento
• maturity - número de madurez (life-path + expression)
• balance - número de equilibrio (iniciales)
• challenge - números de desafío
• pinnacles - números de pináculos (períodos de vida)
• personal-year - número del año personal

El cuerpo de la solicitud para la mayoría de las llamadas es simplemente el nombre y la fecha:

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

personal-year acepta adicionalmente year, ya que calcula la vibración de un año calendario específico.

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

La respuesta contiene no solo el número, sino también la cadena completa de reducción y una interpretación lista para usar:

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

El campo steps muestra cada paso de reducción (10 → 1), y isMaster se activa para 11, 22 y 33; estos no se reducen por acuerdo de la escuela pitagórica. Esto es importante si estás construyendo tu propia UI: no necesitas adivinar por qué 29 se convirtió en 11 y no en 2, la cadena se proporciona explícitamente.

La Matriz del Destino (Destiny Matrix) no es parte de la numerología clásica, por lo que reside en su propia ruta:

POST /v1/destiny-matrix

Este es un método basado en los 22 arcanos mayores del Tarot, que se despliegan en un octagrama a partir de la fecha de nacimiento. Devuelve las posiciones de la cruz central, las líneas ancestrales, las zonas de dinero y relaciones, una estructura lista para renderizar la matriz. Lo mantenemos fuera de /numerology/* porque es un modelo diferente (arcanos, no reducción de números).

Los cálculos numerológicos son pura aritmética sobre una cadena y una fecha, sin efemérides. Por lo tanto, son deterministas y económicos: la misma entrada siempre produce la misma salida, el almacenamiento en caché es trivial. Las interpretaciones (meaning) son tablas estáticas, no LLM, por lo que no hay alucinaciones ni variabilidad entre las llamadas.

Si necesitas texto libre sobre los números, eso ya es una capa separada /interpret/* con IA, pero los números base siempre provienen del núcleo determinista.

La numerología se incluye en el paquete de add-on esotérico junto con el Tarot, las runas, la geomancia y el I Ching. Cada llamada tiene un costo de crédito fijo (endpoints de cálculo, no de IA, por lo que son económicos). El plan gratuito ofrece 10 000 créditos al mes, lo cual es suficiente para recopilar un perfil numerológico completo para varios cientos de usuarios al mes sin costo.

1. Obtén tu clave en dashboard/sign-up
2. Elige el sistema adecuado para tu audiencia (pitagórico es el predeterminado para el mercado occidental, védico para el indio)
3. Recopila un perfil con las 10 llamadas o extrae un solo número para una pantalla específica

La lista completa de campos y esquemas se encuentra en la referencia OpenAPI bajo el grupo Numerology.