AstroWay/api v2.260.0 · es
todos los sistemas funcionando con normalidad
// astrology api · POST /v1/ziwei/chart

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.

Endpoint
POST /v1/ziwei/chart
Coste
20 créditos
Latencia
~130 ms
Nivel
Tier 2
// 01 / Qué calcula

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.

// 02 / Solicitud en vivo

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
  }'
Respuesta (fragmento)
{
  "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 }
      }
    ]
  }
}
// 03 / Parámetros

Parámetros

nametypeObligatorio
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.
// 04 / Cuándo usarlo

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.

// 05 / Notas

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.

99.9% SLA · planes de pago · 30 días estado →