Zi Wei Dou Shu (Purple Star) API
Una fecha de nacimiento, una hora y un sexo generan la carta completa: doce palacios con sus tallos, los catorce astros principales, los auxiliares, treinta y un astros menores, las doce etapas de la vida, los límites de década y las cuatro transformaciones marcadas en los astros que los llevan.
Zi Wei Dou Shu (Purple Star) API
El nacimiento se convierte a una fecha lunar, porque Zi Wei es un sistema puramente lunar y, a diferencia de BaZi, no pasa a los términos solares. A partir del mes lunar y la doble hora, el endpoint coloca el palacio del alma y el palacio del cuerpo, luego asigna tallos a cada palacio según la regla de los cinco tigres, y después lee la clase de los cinco elementos del pilar del palacio del alma. Esa clase y el día lunar colocan 紫微 mediante la regla clásica de prestar y dividir, los seis astros de su serie siguen con desplazamientos fijos, 天府 lo refleja a través del eje 寅-申 y lleva sus propios ocho. Sobre ese esqueleto van los seis astros de suerte y los seis astros maléficos, la tienda de salarios y el caballo celestial, treinta y un astros menores vinculados al tallo del año, la rama del año, el mes, el día y la hora, las doce etapas de la vida, el ciclo del erudito, el ciclo del general y el ciclo del año, los límites de diez años que se abren en el número de clase, y el límite anual si pides la edad. Las cuatro transformaciones se resuelven a partir del tallo del año y se adjuntan a los propios astros en lugar de devolverse como una lista separada.
POST/v1/ziwei/chart
curl -X POST https://api.astroway.info/v1/ziwei/chart \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "2000-08-16",
"time": "04:00:00",
"gender": "male",
"age": 25
}' {
"ok": true,
"data": {
"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" }],
"lifeStage": { "chinese": "死", "name": "Death" },
"decade": { "index": 0, "fromAge": 3, "toAge": 12 }
}
]
}
} Parámetros
| name | type | Obligatorio | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | sí | Birth date. It is converted to a lunar date, because Zi Wei is a lunar system. |
| time | string (HH:MM:SS) | sí | Local clock time. Required: the soul palace is placed from the double-hour, so a chart without it would be twelve palaces of confident nonsense rather than a partial answer. |
| gender | string | sí | male or female. It sets the direction of the twelve life stages, the scholar cycle and the decade limits, so the chart cannot be built without it. |
| age | number | no | Return the annual-limit palace for this age. Omit and the field comes back null. |
| yearDivide | string | no | lunar (default: the year opens on day one of the first lunar month) or lichun (the BaZi boundary, for reconciling against a calculator that imported it). |
| fixLeap | boolean | no | Split a leap month at day 15 (default) or count the whole of it as the month it follows. |
| dayDivide | string | no | forward (default: 23:00 belongs to the next day) or current (keep the date and mark the hour as the late Zi). |
| school | string | no | The 四化 table: zhongzhou (default), quanji, quanshu or beipai. The four disagree on three of the ten year stems. |
| language | string | no | Any of 21 codes. Palace names and life-stage names come back translated; star names stay as characters with an English gloss. |
Cuándo usarlo
Úsalo cuando estés creando un producto de astrología china para un mercado que no lee chino: una app, un servicio de lecturas, un renderizador de cartas, un agente que necesita la estructura antes de interpretarla. La respuesta es pura estructura sin prosa, así que encaja en una cuadrícula de doce palacios, un generador de informes o un prompt de LLM igual de bien. Los endpoints de referencia en la misma familia son más baratos y útiles para glosarios y tooltips, pero devuelven la misma tabla para cada nacimiento y lo indican en un campo, así que no construyas una carta a partir de ellos.
Notas
Fijado a tres cartas publicadas en lugar de a una sola biblioteca, a propósito: casi todo el ecosistema de código abierto Zi Wei desciende de un único proyecto, así que estar de acuerdo con varias es estar de acuerdo con una. Dos cartas completas se reproducen exactamente, y una tercera proviene de un texto de enseñanza no relacionado. Cuatro conmutadores de escuela viven en el cuerpo de la solicitud en vez de en nuestro código, porque cada uno mueve toda la carta para los nacimientos que toca: el límite de año, el mes intercalado, el cambio a las 23:00 y la tabla de transformaciones. Cuando otro calculador discrepa, revisa esos cuatro antes de la aritmética.
Prueba la API de Zi Wei Dou Shu
Consigue una clave y haz tu primera llamada en menos de un minuto.