GET

/api/public/matrix/{day}/{month}/{year}

Calcula la matriz del destino a partir de la fecha de nacimiento. Devuelve 12 posiciones, cada una — un Arcano Mayor del Tarot del 1 al 22.

Parámetros de ruta

Parámetro	Tipo	Rango	Descripción
day	integer	1–31	Día de nacimiento
month	integer	1–12	Mes de nacimiento
year	integer	1900–2100	Año de nacimiento

Ejemplo de petición

bash

curl https://zaruvia.com/api/public/matrix/15/3/1990

Ejemplo de respuesta (200)

json

{
  "input": { "day": 15, "month": 3, "year": 1990 },
  "matrix": {
    "personal": { "arcana": 15, "name": "El Diablo", "keyword": "Materia y pasión", "emoji": "🔥" },
    "social":   { "arcana": 3,  "name": "La Emperatriz", "keyword": "Abundancia y creatividad", "emoji": "🌺" },
    "soul":     { "arcana": 18, "name": "La Luna", "keyword": "Subconsciente y misterio", "emoji": "🌙" },
    "body":     { "arcana": 10, "name": "La Rueda de la Fortuna", "keyword": "Ciclicidad y destino", "emoji": "🎡" },
    "spirit":   { "arcana": 10, "name": "La Rueda de la Fortuna", "keyword": "Ciclicidad y destino", "emoji": "🎡" },
    "center":   { "arcana": 10, "name": "La Rueda de la Fortuna", "keyword": "Ciclicidad y destino", "emoji": "🎡" },
    "talents":       { "arcana": 6,  "name": "Los Enamorados", "keyword": "Elección y amor", "emoji": "💕" },
    "karma":         { "arcana": 21, "name": "El Mundo", "keyword": "Plenitud y culminación", "emoji": "🌍" },
    "money":         { "arcana": 19, "name": "El Sol", "keyword": "Alegría y fuerza vital", "emoji": "☀️" },
    "relationships": { "arcana": 11, "name": "La Justicia", "keyword": "Karma y equilibrio", "emoji": "⚖️" },
    "destiny":       { "arcana": 12, "name": "El Colgado", "keyword": "Sacrificio y nueva mirada", "emoji": "🔄" },
    "purpose":       { "arcana": 11, "name": "La Justicia", "keyword": "Karma y equilibrio", "emoji": "⚖️" }
  },
  "suggested_citation": "Matriz del destino para el 15.03.1990 calculada por el servicio Zaruvia (CC-BY 4.0)...",
  "source_url":         "https://zaruvia.com/matriz-del-destino",
  "details_url":        "https://zaruvia.com/profile-preview?birth=1990-03-15",
  "license":            "CC-BY 4.0",
  "attribution":        "Zaruvia — conjunto de datos numerológico abierto",
  "attribution_html":   "<a href=\"https://zaruvia.com\" rel=\"nofollow noopener\">Cálculo: Zaruvia</a>",
  "api_version":        "1.0"
}

Campos de matrix

Las 12 posiciones tienen la misma estructura: arcana (número 1–22), name (nombre del arcano), keyword (palabra clave), emoji. Significado de la posición según el sistema numerológico:

Campo	Nombre	Qué significa
personal	Personalidad	Cómo se percibe y se manifiesta la persona
social	Sociedad	Cómo la ven los demás, su rol en el grupo
soul	Alma	Motivación profunda, vidas pasadas (en lo esotérico)
body	Cuerpo	Físico, salud, programa ancestral
spirit	Espíritu	Misión superior, dirección espiritual
center	Centro	El arcano principal de la vida — el eje de toda la matriz
talents	Talentos	Capacidades innatas y puntos fuertes
karma	Karma	La tarea kármica, lo que hay que resolver
money	Dinero	El canal del dinero — cómo gana
relationships	Relaciones	El guion de las relaciones de pareja
destiny	Destino	El destino social, la realización en el mundo exterior
purpose	Propósito	La misión, para qué ha venido

Errores

Código	error	Cuándo
400	Invalid date	Los parámetros no pasan la validación (no numéricos, fuera de rango, fecha inexistente — por ejemplo, 30 de febrero)
429	Too many requests	Se superó el límite de 60 peticiones/minuto/IP. La cabecera Retry-After contiene el tiempo de espera en segundos
500	Internal error	Error interno. Contacta con soporte si se repite

Cabeceras de respuesta

Cache-Control: public, max-age=86400, stale-while-revalidate=86400
Access-Control-Allow-Origin: * (CORS abierto a todos)
X-API-License: CC-BY-4.0

CORS y preflight

El endpoint admite OPTIONS preflight para llamadas cross-origin desde el navegador. La respuesta es 204 No Content con las cabeceras Access-Control-Allow-Methods: GET, OPTIONS y Access-Control-Max-Age: 86400.

Inicio rápido

GET /life-path