Zi Wei Dou Shu: la colocación de las estrellas

紫微斗數 construye una carta no a partir de planetas, sino de doce palacios y más de cien estrellas, dispuestas según las reglas de la fecha lunar y la hora de nacimiento. POST /v1/ziwei/chart calcula esto completamente.

Endpoints

Endpoint	Créditos	Qué devuelve
POST /v1/ziwei/chart	20	Carta completa: palacios, estrellas, etapas, límites, 四化. Requiere time y gender
POST /v1/ziwei/four-transformations	10	四化 por el tronco del año, cuatro escuelas
POST /v1/ziwei/twelve-palaces	5	Referencia de los doce palacios
POST /v1/ziwei/main-stars	5	Referencia de las catorce estrellas principales
POST /v1/ziwei/palace-*	5	Referencia de un palacio, nueve caminos

Las rutas de referencia incluyen el campo computed: false y cuestan la mitad de la tarifa. Devuelven la misma tabla para cualquier fecha de nacimiento, y no hay nada de malo en ello, siempre que se indique.

`/ziwei/full-chart` está obsoleto

Devuelve el mismo diccionario de palacios a cualquiera, y su nombre promete una carta. Responde sin cambios hasta el 2027-11-26, incluye los encabezados Deprecation, Sunset y Link al sucesor. Pásate a /v1/ziwei/chart: requiere gender además de la fecha y la hora.

Ejemplo

curl -X POST https://api.astroway.info/v1/ziwei/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2000-08-16","time":"04:00:00","gender":"male","age":25}'

{
  "fiveElementClass": { "key": "wood3", "chinese": "木三局", "name": "Wood 3", "value": 3 },
  "soulPalace": { "index": 4, "branch": "Wu" },
  "bodyPalace": { "index": 8, "branch": "Xu" },
  "ziwei": { "index": 4, "branch": "Wu" },
  "annualLimit": { "age": 25, "index": 8, "branch": "Xu" },
  "palaces": [
    {
      "branch": "Wu",
      "pillar": "Ren-Wu",
      "palace": "destiny",
      "isSoul": true,
      "majorStars": [{ "chinese": "紫微", "name": "Purple Star", "pinyin": "Zi Wei", "kind": "major" }],
      "lifeStage": { "chinese": "死", "name": "Death", "localised": "Death" },
      "boshi": "伏兵",
      "decade": { "index": 0, "fromAge": 3, "toAge": 12 }
    }
  ]
}

El array palaces contiene los doce en el mismo formato, de 寅 a 丑.

Qué se calcula exactamente

Paso	Regla
命宮 y 身宮	Desde el palacio del mes, hacia atrás por las horas para la Vida, hacia adelante para el Cuerpo
Troncos de los palacios	五虎遁 desde el tronco del año
五行局	Desde el pilar del palacio de la Vida; coincide con 納音 en las sesenta parejas
紫微	División del día por el número de 局 con préstamo: préstamo par hacia adelante, impar hacia atrás
紫微系 (6)	Desplazamiento −1, −3, −4, −5, −8 desde 紫微
天府系 (8)	天府 es el espejo de 紫微 alrededor del eje 寅-申, luego +1..+6 y +10 para 破軍
六吉 y 六煞	Desde el mes, la hora y el tronco del año, cada una con su propia fórmula
Treinta y una estrellas menores	Desde la rama del año, el tronco del año, el mes, el día y la hora
長生十二神	Desde 五行局, hacia adelante para 陽男陰女 y hacia atrás de lo contrario
博士十二神	Desde 祿存, la misma dirección
將前 y 歲前 十二神	Desde la tríada de la rama del año y desde la propia rama, ambos siempre hacia adelante
大限	Desde 命宮, inicio a la edad del número de 局, paso de diez años
小限	Lee el género y no lee el yin-yang, a diferencia de los decenales
四化	Por el tronco del año, marcadas directamente en las estrellas

Cuatro interruptores de escuela

Están en el cuerpo de la solicitud, no en nuestro código, porque cada uno de ellos desplaza la carta por completo para los nacimientos a los que afecta.

Parámetro	Por defecto	Segundo valor
yearDivide	lunar: el año comienza el primer día del primer mes lunar	lichun: límite de BaZi
fixLeap	true: el mes bisiesto se divide por el día quince	false: todo el mes bisiesto se cuenta como el anterior
dayDivide	forward: las 23:00 pertenecen al día siguiente	current: la fecha permanece, la hora se marca como 晚子時
tianmaSchool	year: 天馬 desde la rama del año (中州派)	month: 天馬 desde el mes lunar
school	zhongzhou: 四化 según el corpus de 王亭之	quanji, quanshu, beipai

La hora de nacimiento es obligatoria

El Palacio de la Vida se establece a partir de la hora, y de él dependen el 五行局 y cada estrella. Una carta sin hora no sería una respuesta parcial, sino doce palacios de tonterías seguras, por lo que una solicitud sin time se rechaza con un 400. Esto difiere de BaZi, donde sin la hora simplemente no hay pilar horario.

Hora solar verdadera

Por defecto, la hora se lee según el reloj local, como lo hacen la mayoría de los practicantes. Pasa trueSolarTime: true junto con longitude y timezoneOffset para que la hora se lea según el sol sobre el lugar de nacimiento, con la misma corrección que en /v1/bazi. En España o en el oeste de Francia, la diferencia es de 50 a 135 minutos, y esto es suficiente para que cambie la hora, y con ella el Palacio de la Vida y cada estrella. La corrección afecta a la hora y al día; con yearDivide=lichun, el límite de Lichun permanece según el reloj. Lo que se ha aplicado se devuelve en input.trueSolarTime. longitude sin trueSolarTime no cambia nada, y trueSolarTime sin longitude o timezoneOffset devuelve un 400 TRUE_SOLAR_TIME_NEEDS_PLACE.

El año aquí no comienza con Lichun

Esto no es una elección de escuela. 斗數 es un sistema puramente lunar y no pasa a términos solares, a diferencia de 子平. yearDivide=lichun existe solo para la verificación con una calculadora que ha arrastrado el límite de BaZi.

Cómo se ha verificado

Se ha anclado a tres cartas publicadas, no a una sola biblioteca, y esto es intencional. Casi todo el ecosistema abierto de Zi Wei proviene de un único proyecto: dos puertos más al menos un proyecto que declara otra línea, pero internamente lo llama y analiza su salida. Por lo tanto, la coincidencia con varios proyectos es una coincidencia con uno solo.

• Dos cartas se han reproducido completamente: las catorce estrellas principales, 五行局, los palacios de la Vida y el Cuerpo.
• Las doce etapas se han verificado con un tercer vector de prueba de la misma fuente donde se publicaron las doce esperadas, y no con estas dos. Los inicios de las décadas se han cotejado con el número de 五行局, es decir, con la regla de la que se derivan, y no con una publicación externa.
• Una tercera carta se ha tomado de un texto de enseñanza chino sin relación con ese ecosistema y ancla el desplazamiento de las estrellas y el orden de los palacios de forma independiente.
• La mnemotécnica 安紫微星 「六五四三二／酉午亥辰丑」 y el recorrido publicado de 火六局 por los días 1-15 se verifican directamente: son constantes de la tradición, no una implementación de alguien.

Qué hacer cuando tu calculadora da un resultado diferente

Verifica no la aritmética, sino los cuatro interruptores: el límite del año, el mes bisiesto, el límite del día a las 23:00 y la tabla de 四化. Casi siempre la discrepancia está ahí.

Una interpretación común que es incorrecta

火星 y 鈴星 se disponen hacia adelante desde la tríada de la rama del año y no leen el género en ninguna transmisión verificada. La regla 陽男陰女順 / 陰男陽女逆, que a veces se les atribuye, pertenece a las doce etapas 長生十二神 y a los límites decenales. Ambos temas están en la misma página en la fuente más copiada, y parece que de ahí surgió la confusión.

Idiomas

Los nombres de los palacios y las doce etapas están traducidos a 21 idiomas: añade ?lang=, y en cada palacio aparecerá palaceLocalised, y en la etapa el campo localised. Los nombres de las estrellas permanecen en ideogramas con una traducción al inglés al lado: no tienen nombres establecidos.